Create clip job (spends credits)
create_clip_jobStart an AI clipping job to turn a long podcast, stream, interview, or vlog into captioned vertical Shorts, Reels, or TikTok clips with hooks and optional music and B-roll.
Instructions
Starts AI clipping of a long video into vertical 9:16 short clips with burned-in captions and a hook title, plus optional cold-open hooks, music and B-roll. Spends credits: 1 per started minute of the processed range (minimum 1), charged when the job is created. One job processes at most 30 minutes of video; split longer videos with start_sec and end_sec. Jobs cannot be cancelled.
Before calling, run quote_clip_job, show the price to the user and get explicit agreement. max_credits is required; the call is refused without charging if the price is higher. Some clients also ask the user to confirm. If the same request was already submitted with this API key in the last 10 minutes, that job is returned instead of charging again.
Use for turning a podcast, stream, interview, lecture or vlog into Shorts, Reels or TikTok clips. Not for: transcripts only (create_transcription), changing the look of an existing job (recut_clip_job), or re-running a failed job for free (retry_clip_job).
Key parameters: source_url (public link; local files are not supported), start_sec and end_sec to process only part of the video, video_mode (podcast for talking heads), clip_length, caption_style, language (omit to auto-detect) and prompt to steer which moments are picked. Call get_options_guide to explain option values.
Returns job_id right away with status queued and the credits charged. Processing takes a few minutes for short videos and up to tens of minutes for a full 30-minute range; clips appear one by one. Next, call get_clip_job with wait_sec=50 until the status is completed or failed. If processing fails, credits are not returned automatically: retry_clip_job re-runs the job for free, or the user can contact support@mnogo-reels.ru with the job_id. On the free plan clip files are kept for 30 days.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| outro | No | Ending added to every clip: default branded outro, soon/like short Russian text cards, custom = your saved outro image. | none |
| emojis | No | Add emojis to captions where they fit. | |
| prompt | No | What kind of moments to pick, in plain words, e.g. 'funny moments about money'. | |
| end_sec | No | End of the part to process, in seconds. Default: the end of the video (its length is looked up automatically when the platform reports it). At most 30 minutes after start_sec. | |
| framing | No | auto = smart crop; full_frame = keep the whole wide frame on a blurred background; portrait_only = always crop to the subject. | auto |
| language | No | Two-letter language code of the speech, e.g. en or ru. Omit to auto-detect. Never pass 'auto'. | |
| add_music | No | Add quiet background music from the MnogoReels library. | |
| cold_open | No | Start each clip with its strongest moment as a teaser, and also produce standalone hook clips and a looped teaser. | |
| smart_cut | No | Remove pauses and filler words inside clips. Works only with video_mode podcast (general-beta always does it); ignored for other modes. | |
| start_sec | No | Start of the part to process, in seconds from the beginning. Default 0. | |
| hook_style | No | Style of the hook title shown at the start of each clip; none hides it. | default |
| source_url | Yes | Public link to the video: YouTube, VK Video, RuTube, Dzen, Twitch, Yandex Disk file, Google Drive file, or a direct .mp4/.mov/.mkv/.webm link. Local files are not supported. | |
| video_mode | No | How the video was filmed: general, podcast (talking heads), general-beta (SmartCut: removes pauses and filler words), stream (screen + webcam), vlog, fitness. | general |
| clip_length | No | Target length of each clip. auto lets the AI decide; 30_60s suits Shorts, Reels and TikTok. | 30_60s |
| max_credits | Yes | Spending limit for this call in credits. Required. Use the credits value from quote_clip_job after the user agreed; the call is refused without charging if the price (or its upper bound) is higher. | |
| agentic_mode | No | Extra AI review pass that refines where clips start and end. Slower. | |
| caption_style | No | Burned-in caption style; empty means no captions. Call get_options_guide to see what each style looks like. | karaoke |
| allow_duplicate | No | Set true only if the user explicitly wants a second identical job within 10 minutes (it is charged again). | |
| story_arc_style | No | Build each clip as a story (cold open, main part, payoff). Any value except none also turns on cold_open. | none |
| b_roll_ai_images | No | Insert AI-generated illustrative images as B-roll. | |
| keep_whole_video | No | Do not cut into clips: render the whole video once with captions, music and B-roll. Use only for videos that are already vertical and short. | |
| b_roll_stock_video | No | Insert relevant stock video B-roll. | |
| b_roll_motion_graphics | No | Insert AI motion-graphics B-roll (animated titles, charts, diagrams). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | ||
| status | Yes | ||
| credits | Yes | Credits charged for this job (same formula as the API). | |
| end_sec | Yes | ||
| next_step | Yes | e.g. "Call get_clip_job with job_id and wait_sec=50." | |
| start_sec | Yes | ||
| source_url | Yes | ||
| deduplicated | Yes | True when an identical request from the last 10 minutes was returned instead of creating a new job (nothing was charged now). |