Skip to main content
Glama

Generate Video

generate_video

Generate video with the configured provider lineup (Kling, BytePlus Seedance, Switch Video/WAN 2.7, Switch Video Edit, Higgsfield Genjutsu, Topaz upscale) and modes (text-to-video, image-to-video, frame-to-frame, motion, omni, reference-to-video, video-edit, upscale). Load load_video_workflow once per conversation when needed. Keep the user-selected model; use list_video_models only when the selection or its inputs are unknown. SwitchApp Video Enhanced runs automatically before submission, except on a prompt the person wrote themselves (as_written) or one that is word for word a proven prompt from the owner's library: those go exactly as written, never enhanced; call enhance_video_prompt first to inspect it and reuse its signed enhancement_receipt. Use quote_video only to turn a draft into Full HD, passing its quote_fingerprint and quoted_credits; any other video runs without a quote and is charged what it really costs. Before submission, map every actual image, video, and audio chip to its role and preserve its thumbnail, type, order, and role exactly; never silently drop, merge, reorder, convert, or repurpose references. Pass one shot, or shots:[...] for a storyboard (max 4 by default, hard max 10) where EACH shot is DIFFERENT — never repeat one prompt to get copies. Renders async (~30-90s); a background job delivers each clip to your library. Returns a task_id per shot — poll get_video_status or list_my_videos. Higgsfield Genjutsu (switch-cinema-480p / switch-cinema-720p; Templates in the menu) remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls and keeps the clip's motion; no duration, priced per second of that clip, subject optional and sent as typed.

Input Schema

NameRequiredDescriptionDefault
modeNoVideo mode. Must be supported by the chosen model (see list_video_models).
takeNoWhen the person asks for several of the same video ("4 of them"), number each call 1, 2, 3 ... so every take is made; the same take number twice in ten minutes is the same request and makes one video. Leave out for a single video.
audioNoGenerate sound. ON by default on every video maker that can make sound (Seedance 2.5 and 2.0 in every mode, Kling Omni and Turbo, every WAN 3.0 option, MiniMax H3 Max). Set false for a silent clip. Models without sound ignore this. See list_video_models for the max seconds with and without sound.
modelNoHeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference option): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, the image option takes image_url and an optional end_image_url, the reference option takes up to 10 reference_image_urls and 5 reference_video_urls. Higgsfield Genjutsu (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p).
shotsNoA storyboard of 1-10 DISTINCT shots. Each item takes the same fields as a single shot (subject, model, mode, image_url, etc.).
subjectNoThe shot: subject + motion + scene (video needs motion language, e.g. "slow push-in"). Name the creator's staged Studio references as @Image1, @Video1 (the Video tab strip, then the image strip; see get_my_active_references) and they attach automatically; nothing attaches unless named. WAN 3.0: refer to references by their place ("Image 1", "Video 1"), not by @tags; there is no negative-prompt field, so write exclusions inline as "Avoid: ...". MiniMax H3 Max: put spoken words in double quotes and the character says them lip-synced; name references by place (Image 1, Video 1, Audio 1).
durationNoClip length in seconds, or "auto" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN 2.7) does 5/10/15; WAN 3.0 takes any whole second from 2 to 30; Kling/Switch Video Edit cap at 10; MiniMax H3 Max takes whole seconds 5 to 15 (no auto) — see each model's durations in list_video_models.
brand_kitNoOptional. The brand kit to send with this video, by name or id, or "none". Leave out to use the kit chosen in Switch Agent settings (or the default kit).
image_urlNoRequired for image-to-video / frame-to-frame / motion. Accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media) OR a public https url. An asset id is resolved server-side, so just pass the id you have — no need to fetch a url first.
option_idNoCatalog id from list_video_models. Native Seedance Draft: seedance-25-draft-text, seedance-25-draft-image, seedance-25-draft-reference (480p with audio). Make Full HD: seedance-25-draft-final with the completed draft job_id in video_url, no new creative settings. Quote then generate within 7 days.
task_typeNoSeedance 2.5 reference mode only: declare what you are doing with the reference clip so the size and length rules are checked immediately instead of failing a minute in. auto = a new take from the references (default), edit = change something inside the clip, extend = continue the clip. Editing and extension inherit the source clip's size, and editing also inherits its length.
video_urlNoRequired for video-edit and upscale (the source clip). Accepts one of YOUR Switch videos — a job id from list_my_videos / get_video_status, or its download_url / view_url — or any publicly downloadable https URL. Switch resolves its own videos for you; no need to scrape a page for the file.
as_writtenNoTrue when the person wrote this prompt themselves and is using it as their prompt ("I'm doing the prompt"): it goes exactly as written, never enhanced. Leave it off when you write the prompt, or when the person asks you to make it or fix it: then SwitchApp Video Enhanced runs.
resolutionNoHeyGen Video offers 480p, 768p and 2k (2k in 16:9 or 9:16 only, three times the 768p price). Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference option is 768p only). Each model lists its available resolutions in list_video_models.
aspect_ratioNoe.g. 9:16, 16:9, 1:1. Must be allowed for the model (see list_video_models).
end_image_urlNoEnd frame for frame-to-frame mode.
quoted_creditsNoExact quoted_credits returned by quote_video; used with quote_fingerprint.
quote_fingerprintNoFrom quote_video. Pass with quoted_credits to reject a changed quote before charging.
face_reference_idsNoOptional, kept for apps that already use it: asset ids from upload_reference_asset. Not needed for faces; put every picture in reference_image_urls and Switch handles faces itself. Each id here runs the same protected face path (your own untouched original + identity verification) before the shot fires or is charged.
enhancement_receiptNoReceipt from enhance_video_prompt. Pass its enhanced_prompt as subject with the same model, settings and references. Prevents duplicate enhancement. Changed/expired receipts fail before generation.
reference_audio_urlsNoSeedance reference/omni only: up to 3 reference audio files to drive synthesized audio. Requires at least one reference image or video. MiniMax H3 Max reference (h3max-reference) also takes up to 3 audio files as conditioning (voice/sound guidance); it generates native audio on every clip regardless. WAN 3.0 reference (wan30-reference) takes up to 5 audio files totaling 15 seconds, a song or a voice the subject performs to, addressed as Audio 1, Audio 2 in the prompt.
reference_image_urlsNoGENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt ("the woman in Image 1", "the jacket from Image 3"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); on Seedance, only an account without identity verification is refused. Higgsfield Genjutsu (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required.
reference_video_urlsNoSeedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as "Video 1", "Video 2"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Gemini Omni 1.1 Flash (gemini-omni-reference, gemini-omni-image): up to 3 clips of up to 3 seconds each, used as character or object references (their sound is ignored), named @Video1, @Video2 in the prompt in list order; a longer clip is refused before any charge. Higgsfield Genjutsu (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price.
character_orientationNoMotion mode only: follow the character image (default) or the reference video.
person_named_resolutionNoSwitch Agent: true only when the person named this video's resolution themselves ("make it in 1080p"); a Seedance 2.5 video then starts at that resolution instead of its Draft. Leave it off otherwise: every Seedance 2.5 video starts as a Draft.
person_rights_confirmedNoOptional and not needed; kept so older apps that send it still work.
video_people_declarationNoOptional and not needed: every video maker takes clips with real people; Seedance asks for a verified account, every other model takes them as its own API allows.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / brand_kit
      Added value: +{
      +  "description": "Optional. The brand kit to send with this video, by name or id, or \"none\". Leave out to use the kit chosen in Switch Agent settings (or the default kit).",
      +  "type": "string"
      +}
  2. Changed2 schema fields changed
    • changedInput schema / properties / reference_audio_urls / description
      Previous value: -"Seedance reference/omni only: up to 3 reference audio files to drive synthesized audio. Requires at least one reference image or video. MiniMax H3 Max reference (h3max-reference) also takes up to 3 audio files as conditioning (voice/sound guidance); it generates native audio on every clip regardless."New value: +"Seedance reference/omni only: up to 3 reference audio files to drive synthesized audio. Requires at least one reference image or video. MiniMax H3 Max reference (h3max-reference) also takes up to 3 audio files as conditioning (voice/sound guidance); it generates native audio on every clip regardless. WAN 3.0 reference (wan30-reference) takes up to 5 audio files totaling 15 seconds, a song or a voice the subject performs to, addressed as Audio 1, Audio 2 in the prompt."
    • changedInput schema / properties / shots / items / properties / reference_audio_urls / description
      Previous value: -"Seedance reference/omni only: up to 3 reference audio files to drive synthesized audio. Requires at least one reference image or video. MiniMax H3 Max reference (h3max-reference) also takes up to 3 audio files as conditioning (voice/sound guidance); it generates native audio on every clip regardless."New value: +"Seedance reference/omni only: up to 3 reference audio files to drive synthesized audio. Requires at least one reference image or video. MiniMax H3 Max reference (h3max-reference) also takes up to 3 audio files as conditioning (voice/sound guidance); it generates native audio on every clip regardless. WAN 3.0 reference (wan30-reference) takes up to 5 audio files totaling 15 seconds, a song or a voice the subject performs to, addressed as Audio 1, Audio 2 in the prompt."
  3. Changed6 schema fields changed
    • changedInput schema / properties / model / description
      Previous value: -"HeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference option): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, the image option takes image_url and an optional end_image_url, the reference option takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."New value: +"HeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference option): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, the image option takes image_url and an optional end_image_url, the reference option takes up to 10 reference_image_urls and 5 reference_video_urls. Higgsfield Genjutsu (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."
    • changedInput schema / properties / reference_image_urls / description
      Previous value: -"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); on Seedance, only an account without identity verification is refused. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); on Seedance, only an account without identity verification is refused. Higgsfield Genjutsu (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."
    • changedInput schema / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Gemini Omni 1.1 Flash (gemini-omni-reference, gemini-omni-image): up to 3 clips of up to 3 seconds each, used as character or object references (their sound is ignored), named @Video1, @Video2 in the prompt in list order; a longer clip is refused before any charge. Switch Cinema (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price."New value: +"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Gemini Omni 1.1 Flash (gemini-omni-reference, gemini-omni-image): up to 3 clips of up to 3 seconds each, used as character or object references (their sound is ignored), named @Video1, @Video2 in the prompt in list order; a longer clip is refused before any charge. Higgsfield Genjutsu (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price."
    • changedInput schema / properties / shots / items / properties / model / description
      Previous value: -"HeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference option): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, the image option takes image_url and an optional end_image_url, the reference option takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."New value: +"HeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference option): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, the image option takes image_url and an optional end_image_url, the reference option takes up to 10 reference_image_urls and 5 reference_video_urls. Higgsfield Genjutsu (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."
    • changedInput schema / properties / shots / items / properties / reference_image_urls / description
      Previous value: -"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); on Seedance, only an account without identity verification is refused. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); on Seedance, only an account without identity verification is refused. Higgsfield Genjutsu (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."
    • changedInput schema / properties / shots / items / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Gemini Omni 1.1 Flash (gemini-omni-reference, gemini-omni-image): up to 3 clips of up to 3 seconds each, used as character or object references (their sound is ignored), named @Video1, @Video2 in the prompt in list order; a longer clip is refused before any charge. Switch Cinema (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price."New value: +"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Gemini Omni 1.1 Flash (gemini-omni-reference, gemini-omni-image): up to 3 clips of up to 3 seconds each, used as character or object references (their sound is ignored), named @Video1, @Video2 in the prompt in list order; a longer clip is refused before any charge. Higgsfield Genjutsu (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price."
  4. Changed2 schema fields changed
    • addedInput schema / properties / person_named_resolution
      Added value: +{
      +  "description": "Switch Agent: true only when the person named this video's resolution themselves (\"make it in 1080p\"); a Seedance 2.5 video then starts at that resolution instead of its Draft. Leave it off otherwise: every Seedance 2.5 video starts as a Draft.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / shots / items / properties / person_named_resolution
      Added value: +{
      +  "description": "Switch Agent: true only when the person named this video's resolution themselves (\"make it in 1080p\"); a Seedance 2.5 video then starts at that resolution instead of its Draft. Leave it off otherwise: every Seedance 2.5 video starts as a Draft.",
      +  "type": "boolean"
      +}
  5. Changed2 schema fields changed
    • addedInput schema / properties / as_written
      Added value: +{
      +  "description": "True when the person wrote this prompt themselves and is using it as their prompt (\"I'm doing the prompt\"): it goes exactly as written, never enhanced. Leave it off when you write the prompt, or when the person asks you to make it or fix it: then SwitchApp Video Enhanced runs.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / shots / items / properties / as_written
      Added value: +{
      +  "description": "True when the person wrote this prompt themselves and is using it as their prompt (\"I'm doing the prompt\"): it goes exactly as written, never enhanced. Leave it off when you write the prompt, or when the person asks you to make it or fix it: then SwitchApp Video Enhanced runs.",
      +  "type": "boolean"
      +}
  6. Changed2 schema fields changed
    • addedInput schema / properties / shots / items / properties / take
      Added value: +{
      +  "description": "When the person asks for several of the same video (\"4 of them\"), number each call 1, 2, 3 ... so every take is made; the same take number twice in ten minutes is the same request and makes one video. Leave out for a single video.",
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / take
      Added value: +{
      +  "description": "When the person asks for several of the same video (\"4 of them\"), number each call 1, 2, 3 ... so every take is made; the same take number twice in ten minutes is the same request and makes one video. Leave out for a single video.",
      +  "minimum": 1,
      +  "type": "integer"
      +}
  7. Changed2 schema fields changed
    • changedInput schema / properties / reference_image_urls / description
      Previous value: -"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); only an account without identity verification is refused. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); on Seedance, only an account without identity verification is refused. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."
    • changedInput schema / properties / shots / items / properties / reference_image_urls / description
      Previous value: -"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); only an account without identity verification is refused. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); on Seedance, only an account without identity verification is refused. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."
  8. Changed2 schema fields changed
    • changedInput schema / properties / person_rights_confirmed / description
      Previous value: -"Required with video_people_declaration \"person\": confirms you own or are authorized to use the person's likeness in the reference video."New value: +"Optional and not needed; kept so older apps that send it still work."
    • changedInput schema / properties / video_people_declaration / description
      Previous value: -"Required with reference_video_urls: \"none\" confirms no real person appears; \"person\" runs the protected pipeline (verified account, your own stored upload, Seedance 2.5 or Mini, provider asset registration) — also pass person_rights_confirmed: true."New value: +"Optional and not needed: every video maker takes clips with real people; Seedance asks for a verified account, every other model takes them as its own API allows."
  9. Changed4 schema fields changed
    • changedInput schema / properties / face_reference_ids / description
      Previous value: -"Face reference asset ids from upload_reference_asset (frame_type \"face\") — the ONLY way to use a face/likeness reference in video. Each id is verified server-side (your own untouched original + identity verification) before the shot fires or is charged; URLs and generic uploads here are rejected."New value: +"Optional, kept for apps that already use it: asset ids from upload_reference_asset. Not needed for faces; put every picture in reference_image_urls and Switch handles faces itself. Each id here runs the same protected face path (your own untouched original + identity verification) before the shot fires or is charged."
    • changedInput schema / properties / reference_image_urls / description
      Previous value: -"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); only an account without identity verification is refused. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."
    • changedInput schema / properties / shots / items / properties / face_reference_ids / description
      Previous value: -"Face reference asset ids from upload_reference_asset (frame_type \"face\") — the ONLY way to use a face/likeness reference in video. Each id is verified server-side (your own untouched original + identity verification) before the shot fires or is charged; URLs and generic uploads here are rejected."New value: +"Optional, kept for apps that already use it: asset ids from upload_reference_asset. Not needed for faces; put every picture in reference_image_urls and Switch handles faces itself. Each id here runs the same protected face path (your own untouched original + identity verification) before the shot fires or is charged."
    • changedInput schema / properties / shots / items / properties / reference_image_urls / description
      Previous value: -"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. Pictures of real people go here too, as they are: Switch checks every picture and sends a face through the protected face path automatically, in its own place (same order, same @Image numbers); only an account without identity verification is refused. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."
  10. Changed2 schema fields changed
    • changedInput schema / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Switch Cinema (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price."New value: +"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Gemini Omni 1.1 Flash (gemini-omni-reference, gemini-omni-image): up to 3 clips of up to 3 seconds each, used as character or object references (their sound is ignored), named @Video1, @Video2 in the prompt in list order; a longer clip is refused before any charge. Switch Cinema (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price."
    • changedInput schema / properties / shots / items / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Switch Cinema (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price."New value: +"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Gemini Omni 1.1 Flash (gemini-omni-reference, gemini-omni-image): up to 3 clips of up to 3 seconds each, used as character or object references (their sound is ignored), named @Video1, @Video2 in the prompt in list order; a longer clip is refused before any charge. Switch Cinema (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price."
  11. Changed7 schema fields changed
    • changedInput schema / properties / audio / description
      Previous value: -"Generate sound. ON by default on every video maker that can make sound (Seedance 2.5 and 2.0 on every lane, Kling Omni and Turbo, every WAN 3.0 lane, MiniMax H3 Max). Set false for a silent clip. Models without sound ignore this. See list_video_models for the max seconds with and without sound."New value: +"Generate sound. ON by default on every video maker that can make sound (Seedance 2.5 and 2.0 in every mode, Kling Omni and Turbo, every WAN 3.0 option, MiniMax H3 Max). Set false for a silent clip. Models without sound ignore this. See list_video_models for the max seconds with and without sound."
    • changedInput schema / properties / model / description
      Previous value: -"HeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."New value: +"HeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference option): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, the image option takes image_url and an optional end_image_url, the reference option takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."
    • changedInput schema / properties / resolution / description
      Previous value: -"HeyGen Video offers 480p, 768p and 2k (2k in 16:9 or 9:16 only, three times the 768p price). Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference lane is 768p only). Each model lists its available resolutions in list_video_models."New value: +"HeyGen Video offers 480p, 768p and 2k (2k in 16:9 or 9:16 only, three times the 768p price). Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference option is 768p only). Each model lists its available resolutions in list_video_models."
    • changedInput schema / properties / shots / items / properties / audio / description
      Previous value: -"Generate sound. ON by default on every video maker that can make sound (Seedance 2.5 and 2.0 on every lane, Kling Omni and Turbo, every WAN 3.0 lane, MiniMax H3 Max). Set false for a silent clip. Models without sound ignore this. See list_video_models for the max seconds with and without sound."New value: +"Generate sound. ON by default on every video maker that can make sound (Seedance 2.5 and 2.0 in every mode, Kling Omni and Turbo, every WAN 3.0 option, MiniMax H3 Max). Set false for a silent clip. Models without sound ignore this. See list_video_models for the max seconds with and without sound."
    • changedInput schema / properties / shots / items / properties / model / description
      Previous value: -"HeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."New value: +"HeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference option): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, the image option takes image_url and an optional end_image_url, the reference option takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."
    • changedInput schema / properties / shots / items / properties / resolution / description
      Previous value: -"HeyGen Video offers 480p, 768p and 2k (2k in 16:9 or 9:16 only, three times the 768p price). Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference lane is 768p only). Each model lists its available resolutions in list_video_models."New value: +"HeyGen Video offers 480p, 768p and 2k (2k in 16:9 or 9:16 only, three times the 768p price). Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference option is 768p only). Each model lists its available resolutions in list_video_models."
    • changedInput schema / properties / video_people_declaration / description
      Previous value: -"Required with reference_video_urls: \"none\" confirms no real person appears; \"person\" runs the protected pipeline (verified account, your own stored upload, Seedance 2.5/Mini lane, provider asset registration) — also pass person_rights_confirmed: true."New value: +"Required with reference_video_urls: \"none\" confirms no real person appears; \"person\" runs the protected pipeline (verified account, your own stored upload, Seedance 2.5 or Mini, provider asset registration) — also pass person_rights_confirmed: true."
  12. Changed6 schema fields changed
    • changedInput schema / properties / model / description
      Previous value: -"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."New value: +"HeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."
    • changedInput schema / properties / resolution / description
      Previous value: -"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference lane is 768p only). Each model lists its available resolutions in list_video_models."New value: +"HeyGen Video offers 480p, 768p and 2k (2k in 16:9 or 9:16 only, three times the 768p price). Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference lane is 768p only). Each model lists its available resolutions in list_video_models."
    • changedInput schema / properties / resolution / enum
      Previous value: -[
      -  "480p",
      -  "720p",
      -  "768p",
      -  "1080p",
      -  "4k"
      -]New value: +[
      +  "480p",
      +  "720p",
      +  "768p",
      +  "1080p",
      +  "2k",
      +  "4k"
      +]
    • changedInput schema / properties / shots / items / properties / model / description
      Previous value: -"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."New value: +"HeyGen Video ids: heygen-video-t2v, heygen-video-i2v, heygen-video-r2v (option ids heygen-text / heygen-image / heygen-reference; 5-15 s, 480p/768p/2K, sound on every clip). Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."
    • changedInput schema / properties / shots / items / properties / resolution / description
      Previous value: -"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference lane is 768p only). Each model lists its available resolutions in list_video_models."New value: +"HeyGen Video offers 480p, 768p and 2k (2k in 16:9 or 9:16 only, three times the 768p price). Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference lane is 768p only). Each model lists its available resolutions in list_video_models."
    • changedInput schema / properties / shots / items / properties / resolution / enum
      Previous value: -[
      -  "480p",
      -  "720p",
      -  "768p",
      -  "1080p",
      -  "4k"
      -]New value: +[
      +  "480p",
      +  "720p",
      +  "768p",
      +  "1080p",
      +  "2k",
      +  "4k"
      +]
  13. Changed2 schema fields changed
    • changedInput schema / properties / audio / description
      Previous value: -"Generate audio. ON by default on Seedance 2.5 (text, image and reference), on Omni, and on every WAN 3.0 lane (text, image, reference); set false for a silent clip. Models without audio ignore this. See list_video_models for which models generate audio and the max seconds with vs without audio."New value: +"Generate sound. ON by default on every video maker that can make sound (Seedance 2.5 and 2.0 on every lane, Kling Omni and Turbo, every WAN 3.0 lane, MiniMax H3 Max). Set false for a silent clip. Models without sound ignore this. See list_video_models for the max seconds with and without sound."
    • changedInput schema / properties / shots / items / properties / audio / description
      Previous value: -"Generate audio. ON by default on Seedance 2.5 (text, image and reference), on Omni, and on every WAN 3.0 lane (text, image, reference); set false for a silent clip. Models without audio ignore this. See list_video_models for which models generate audio and the max seconds with vs without audio."New value: +"Generate sound. ON by default on every video maker that can make sound (Seedance 2.5 and 2.0 on every lane, Kling Omni and Turbo, every WAN 3.0 lane, MiniMax H3 Max). Set false for a silent clip. Models without sound ignore this. See list_video_models for the max seconds with and without sound."
  14. Changed2 schema fields changed
    • changedInput schema / properties / shots / items / properties / subject / description
      Previous value: -"The shot: subject + motion + scene (video needs motion language, e.g. \"slow push-in\"). WAN 3.0: refer to references by their place (\"Image 1\", \"Video 1\"), not by @tags; there is no negative-prompt field, so write exclusions inline as \"Avoid: ...\". MiniMax H3 Max: put spoken words in double quotes and the character says them lip-synced; name references by place (Image 1, Video 1, Audio 1)."New value: +"The shot: subject + motion + scene (video needs motion language, e.g. \"slow push-in\"). Name the creator's staged Studio references as @Image1, @Video1 (the Video tab strip, then the image strip; see get_my_active_references) and they attach automatically; nothing attaches unless named. WAN 3.0: refer to references by their place (\"Image 1\", \"Video 1\"), not by @tags; there is no negative-prompt field, so write exclusions inline as \"Avoid: ...\". MiniMax H3 Max: put spoken words in double quotes and the character says them lip-synced; name references by place (Image 1, Video 1, Audio 1)."
    • changedInput schema / properties / subject / description
      Previous value: -"The shot: subject + motion + scene (video needs motion language, e.g. \"slow push-in\"). WAN 3.0: refer to references by their place (\"Image 1\", \"Video 1\"), not by @tags; there is no negative-prompt field, so write exclusions inline as \"Avoid: ...\". MiniMax H3 Max: put spoken words in double quotes and the character says them lip-synced; name references by place (Image 1, Video 1, Audio 1)."New value: +"The shot: subject + motion + scene (video needs motion language, e.g. \"slow push-in\"). Name the creator's staged Studio references as @Image1, @Video1 (the Video tab strip, then the image strip; see get_my_active_references) and they attach automatically; nothing attaches unless named. WAN 3.0: refer to references by their place (\"Image 1\", \"Video 1\"), not by @tags; there is no negative-prompt field, so write exclusions inline as \"Avoid: ...\". MiniMax H3 Max: put spoken words in double quotes and the character says them lip-synced; name references by place (Image 1, Video 1, Audio 1)."
  15. Changed2 schema fields changed
    • changedInput schema / properties / option_id / description
      Previous value: -"Optional catalog id from list_video_models (e.g. \"kling-image\"); use instead of model+mode."New value: +"Catalog id from list_video_models. Native Seedance Draft: seedance-25-draft-text, seedance-25-draft-image, seedance-25-draft-reference (480p with audio). Make Full HD: seedance-25-draft-final with the completed draft job_id in video_url, no new creative settings. Quote then generate within 7 days."
    • changedInput schema / properties / shots / items / properties / option_id / description
      Previous value: -"Optional catalog id from list_video_models (e.g. \"kling-image\"); use instead of model+mode."New value: +"Catalog id from list_video_models. Native Seedance Draft: seedance-25-draft-text, seedance-25-draft-image, seedance-25-draft-reference (480p with audio). Make Full HD: seedance-25-draft-final with the completed draft job_id in video_url, no new creative settings. Quote then generate within 7 days."
  16. Changed6 schema fields changed
    • changedInput schema / properties / model / description
      Previous value: -"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls."New value: +"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."
    • changedInput schema / properties / reference_image_urls / description
      Previous value: -"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."
    • changedInput schema / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes)."New value: +"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Switch Cinema (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price."
    • changedInput schema / properties / shots / items / properties / model / description
      Previous value: -"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls."New value: +"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls. Switch Cinema (option ids switch-cinema-480p / switch-cinema-720p, model switch-cinema-motion): remakes the clip in reference_video_urls with the person in 1 to 8 reference_image_urls, keeps the clip's motion, no duration setting, priced per second of the clip you attach (8 tokens at 480p, 17 at 720p)."
    • changedInput schema / properties / shots / items / properties / reference_image_urls / description
      Previous value: -"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead. Switch Cinema (switch-cinema-480p / switch-cinema-720p): 1 to 8 pictures of the person to put into the clip, required."
    • changedInput schema / properties / shots / items / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes)."New value: +"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes). Switch Cinema (switch-cinema-480p / switch-cinema-720p): exactly one clip, the one whose motion is kept; the result is as long as this clip and its seconds are the whole price."
  17. Changed6 schema fields changed
    • addedInput schema / properties / enhancement_receipt
      Added value: +{
      +  "description": "Receipt from enhance_video_prompt. Pass its enhanced_prompt as subject with the same model, settings and references. Prevents duplicate enhancement. Changed/expired receipts fail before generation.",
      +  "type": "string"
      +}
    • addedInput schema / properties / quote_fingerprint
      Added value: +{
      +  "description": "From quote_video. Pass with quoted_credits to reject a changed quote before charging.",
      +  "type": "string"
      +}
    • addedInput schema / properties / quoted_credits
      Added value: +{
      +  "description": "Exact quoted_credits returned by quote_video; used with quote_fingerprint.",
      +  "type": "number"
      +}
    • addedInput schema / properties / shots / items / properties / enhancement_receipt
      Added value: +{
      +  "description": "Receipt from enhance_video_prompt. Pass its enhanced_prompt as subject with the same model, settings and references. Prevents duplicate enhancement. Changed/expired receipts fail before generation.",
      +  "type": "string"
      +}
    • addedInput schema / properties / shots / items / properties / quote_fingerprint
      Added value: +{
      +  "description": "From quote_video. Pass with quoted_credits to reject a changed quote before charging.",
      +  "type": "string"
      +}
    • addedInput schema / properties / shots / items / properties / quoted_credits
      Added value: +{
      +  "description": "Exact quoted_credits returned by quote_video; used with quote_fingerprint.",
      +  "type": "number"
      +}
  18. Changed2 schema fields changed
    • changedInput schema / properties / model / description
      Previous value: -"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls."New value: +"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls."
    • changedInput schema / properties / shots / items / properties / model / description
      Previous value: -"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls."New value: +"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). MiniMax H3 Max Turbo (preview, about twice as fast at half the price, no reference lane): h3-max-turbo-t2v, h3-max-turbo-i2v (option ids h3max-turbo-text / h3max-turbo-image). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls."
  19. Changed12 schema fields changed
    • changedInput schema / properties / audio / description
      Previous value: -"Generate audio. ON by default on Seedance 2.5 (text, image and reference) and on Omni; set false for a silent clip. Models without audio ignore this. See list_video_models for which models generate audio and the max seconds with vs without audio."New value: +"Generate audio. ON by default on Seedance 2.5 (text, image and reference), on Omni, and on every WAN 3.0 lane (text, image, reference); set false for a silent clip. Models without audio ignore this. See list_video_models for which models generate audio and the max seconds with vs without audio."
    • changedInput schema / properties / duration / description
      Previous value: -"Clip length in seconds, or \"auto\" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10; MiniMax H3 Max takes whole seconds 5 to 15 (no auto) — see each model's durations in list_video_models."New value: +"Clip length in seconds, or \"auto\" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN 2.7) does 5/10/15; WAN 3.0 takes any whole second from 2 to 30; Kling/Switch Video Edit cap at 10; MiniMax H3 Max takes whole seconds 5 to 15 (no auto) — see each model's durations in list_video_models."
    • changedInput schema / properties / model / description
      Previous value: -"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference)."New value: +"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls."
    • changedInput schema / properties / reference_image_urls / description
      Previous value: -"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead."
    • changedInput schema / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni only: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes)."New value: +"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes)."
    • changedInput schema / properties / shots / items / properties / audio / description
      Previous value: -"Generate audio. ON by default on Seedance 2.5 (text, image and reference) and on Omni; set false for a silent clip. Models without audio ignore this. See list_video_models for which models generate audio and the max seconds with vs without audio."New value: +"Generate audio. ON by default on Seedance 2.5 (text, image and reference), on Omni, and on every WAN 3.0 lane (text, image, reference); set false for a silent clip. Models without audio ignore this. See list_video_models for which models generate audio and the max seconds with vs without audio."
    • changedInput schema / properties / shots / items / properties / duration / description
      Previous value: -"Clip length in seconds, or \"auto\" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10; MiniMax H3 Max takes whole seconds 5 to 15 (no auto) — see each model's durations in list_video_models."New value: +"Clip length in seconds, or \"auto\" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN 2.7) does 5/10/15; WAN 3.0 takes any whole second from 2 to 30; Kling/Switch Video Edit cap at 10; MiniMax H3 Max takes whole seconds 5 to 15 (no auto) — see each model's durations in list_video_models."
    • changedInput schema / properties / shots / items / properties / model / description
      Previous value: -"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference)."New value: +"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference). WAN 3.0 ids: wan-3.0-t2v, wan-3.0-i2v, wan-3.0-r2v (option ids wan30-text / wan30-image / wan30-reference): 720p or 1080p, any whole second 2 to 30, generated audio on by default, image lane takes image_url and an optional end_image_url, reference lane takes up to 10 reference_image_urls and 5 reference_video_urls."
    • changedInput schema / properties / shots / items / properties / reference_image_urls / description
      Previous value: -"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. WAN 3.0 reference (option wan30-reference, model wan-3.0-r2v) accepts up to 10; name each one by its place in the prompt (\"the woman in Image 1\", \"the jacket from Image 3\"). For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead."
    • changedInput schema / properties / shots / items / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni only: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes)."New value: +"Seedance reference/omni and WAN 3.0 reference. WAN 3.0 (wan30-reference): up to 5 clips, 15 seconds combined, each at least 16 fps, addressed in the prompt as \"Video 1\", \"Video 2\"; the audio inside the clips is not kept. Seedance: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes)."
    • changedInput schema / properties / shots / items / properties / subject / description
      Previous value: -"The shot: subject + motion + scene (video needs motion language, e.g. \"slow push-in\")."New value: +"The shot: subject + motion + scene (video needs motion language, e.g. \"slow push-in\"). WAN 3.0: refer to references by their place (\"Image 1\", \"Video 1\"), not by @tags; there is no negative-prompt field, so write exclusions inline as \"Avoid: ...\". MiniMax H3 Max: put spoken words in double quotes and the character says them lip-synced; name references by place (Image 1, Video 1, Audio 1)."
    • changedInput schema / properties / subject / description
      Previous value: -"The shot: subject + motion + scene (video needs motion language, e.g. \"slow push-in\")."New value: +"The shot: subject + motion + scene (video needs motion language, e.g. \"slow push-in\"). WAN 3.0: refer to references by their place (\"Image 1\", \"Video 1\"), not by @tags; there is no negative-prompt field, so write exclusions inline as \"Avoid: ...\". MiniMax H3 Max: put spoken words in double quotes and the character says them lip-synced; name references by place (Image 1, Video 1, Audio 1)."
  20. Changed12 schema fields changed
    • changedInput schema / properties / duration / description
      Previous value: -"Clip length in seconds, or \"auto\" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10 — see each model's durations in list_video_models."New value: +"Clip length in seconds, or \"auto\" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10; MiniMax H3 Max takes whole seconds 5 to 15 (no auto) — see each model's durations in list_video_models."
    • changedInput schema / properties / model / description
      Previous value: -"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-2.7-t2v, topaz). Or prefer option_id from list_video_models."New value: +"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference)."
    • changedInput schema / properties / reference_audio_urls / description
      Previous value: -"Seedance reference/omni only: up to 3 reference audio files to drive synthesized audio. Requires at least one reference image or video."New value: +"Seedance reference/omni only: up to 3 reference audio files to drive synthesized audio. Requires at least one reference image or video. MiniMax H3 Max reference (h3max-reference) also takes up to 3 audio files as conditioning (voice/sound guidance); it generates native audio on every clip regardless."
    • changedInput schema / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni only: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. NOTE: the AUDIO track of these clips is IGNORED — never extracted or preserved."New value: +"Seedance reference/omni only: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes)."
    • changedInput schema / properties / resolution / description
      Previous value: -"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."New value: +"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference lane is 768p only). Each model lists its available resolutions in list_video_models."
    • changedInput schema / properties / resolution / enum
      Previous value: -[
      -  "480p",
      -  "720p",
      -  "1080p",
      -  "4k"
      -]New value: +[
      +  "480p",
      +  "720p",
      +  "768p",
      +  "1080p",
      +  "4k"
      +]
    • changedInput schema / properties / shots / items / properties / duration / description
      Previous value: -"Clip length in seconds, or \"auto\" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10 — see each model's durations in list_video_models."New value: +"Clip length in seconds, or \"auto\" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10; MiniMax H3 Max takes whole seconds 5 to 15 (no auto) — see each model's durations in list_video_models."
    • changedInput schema / properties / shots / items / properties / model / description
      Previous value: -"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-2.7-t2v, topaz). Or prefer option_id from list_video_models."New value: +"Model id from list_video_models (e.g. kling-v3, seedance-2.0-t2v, wan-3.0-t2v, h3-max-t2v, topaz). Or prefer option_id from list_video_models. MiniMax H3 Max ids: h3-max-t2v, h3-max-i2v, h3-max-r2v (option ids h3max-text / h3max-image / h3max-reference)."
    • changedInput schema / properties / shots / items / properties / reference_audio_urls / description
      Previous value: -"Seedance reference/omni only: up to 3 reference audio files to drive synthesized audio. Requires at least one reference image or video."New value: +"Seedance reference/omni only: up to 3 reference audio files to drive synthesized audio. Requires at least one reference image or video. MiniMax H3 Max reference (h3max-reference) also takes up to 3 audio files as conditioning (voice/sound guidance); it generates native audio on every clip regardless."
    • changedInput schema / properties / shots / items / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni only: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. NOTE: the AUDIO track of these clips is IGNORED — never extracted or preserved."New value: +"Seedance reference/omni only: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. Per the BytePlus guide a video reference is a subject reference: it can carry appearance, identity, motion AND voice timbre. State in the prompt what each asset provides. MiniMax H3 Max reference (h3max-reference): up to 3 clips, each second of reference clip is billed on top of the output seconds (see its notes)."
    • changedInput schema / properties / shots / items / properties / resolution / description
      Previous value: -"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."New value: +"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. MiniMax H3 Max offers 480p and 768p only (its reference lane is 768p only). Each model lists its available resolutions in list_video_models."
    • changedInput schema / properties / shots / items / properties / resolution / enum
      Previous value: -[
      -  "480p",
      -  "720p",
      -  "1080p",
      -  "4k"
      -]New value: +[
      +  "480p",
      +  "720p",
      +  "768p",
      +  "1080p",
      +  "4k"
      +]
  21. Changed2 schema fields changed
    • changedInput schema / properties / resolution / description
      Previous value: -"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p and 720p only, on every mode. 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."New value: +"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."
    • changedInput schema / properties / shots / items / properties / resolution / description
      Previous value: -"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p and 720p only, on every mode. 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."New value: +"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p, 720p and 1080p on every mode (no 2K/4K). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."
  22. Changed2 schema fields changed
    • addedInput schema / properties / person_rights_confirmed
      Added value: +{
      +  "description": "Required with video_people_declaration \"person\": confirms you own or are authorized to use the person's likeness in the reference video.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / video_people_declaration / description
      Previous value: -"Required when reference_video_urls is used: \"none\" confirms no real person appears in the reference clips; \"person\" routes to the protected workflow (not yet supported through the connector)."New value: +"Required with reference_video_urls: \"none\" confirms no real person appears; \"person\" runs the protected pipeline (verified account, your own stored upload, Seedance 2.5/Mini lane, provider asset registration) — also pass person_rights_confirmed: true."
  23. Changed1 schema field changed
    • addedInput schema / properties / video_people_declaration
      Added value: +{
      +  "description": "Required when reference_video_urls is used: \"none\" confirms no real person appears in the reference clips; \"person\" routes to the protected workflow (not yet supported through the connector).",
      +  "enum": [
      +    "none",
      +    "person"
      +  ],
      +  "type": "string"
      +}
  24. Changed2 schema fields changed
    • changedInput schema / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni only: up to 3 reference video clips for motion/style guidance. A Seedance video ref can satisfy the required visual anchor. NOTE: the AUDIO track of these clips is IGNORED — never extracted or preserved."New value: +"Seedance reference/omni only: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. NOTE: the AUDIO track of these clips is IGNORED — never extracted or preserved."
    • changedInput schema / properties / shots / items / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni only: up to 3 reference video clips for motion/style guidance. A Seedance video ref can satisfy the required visual anchor. NOTE: the AUDIO track of these clips is IGNORED — never extracted or preserved."New value: +"Seedance reference/omni only: reference video clips for motion/style guidance — up to 10 on Seedance 2.5 (clips 2-30s, 30s combined), up to 3 on Seedance 2.0 (see list_video_models for each model's caps). A Seedance video ref can satisfy the required visual anchor. NOTE: the AUDIO track of these clips is IGNORED — never extracted or preserved."
  25. Changed8 schema fields changed
    • changedInput schema / properties / audio / description
      Previous value: -"Omni / Seedance refs: generate audio. Omni is ON by default; set false for a silent clip. Other models ignore this. See list_video_models for which models generate audio and the max seconds with vs without audio."New value: +"Generate audio. ON by default on Seedance 2.5 (text, image and reference) and on Omni; set false for a silent clip. Models without audio ignore this. See list_video_models for which models generate audio and the max seconds with vs without audio."
    • changedInput schema / properties / duration / description
      Previous value: -"Clip length in seconds. Default 5. Seedance does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10 — see each model's durations in list_video_models."New value: +"Clip length in seconds, or \"auto\" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10 — see each model's durations in list_video_models."
    • changedInput schema / properties / resolution / description
      Previous value: -"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest, only on Seedance 2.0 Mini (budget tier). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."New value: +"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p and 720p only, on every mode. 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."
    • changedInput schema / properties / shots / items / properties / audio / description
      Previous value: -"Omni / Seedance refs: generate audio. Omni is ON by default; set false for a silent clip. Other models ignore this. See list_video_models for which models generate audio and the max seconds with vs without audio."New value: +"Generate audio. ON by default on Seedance 2.5 (text, image and reference) and on Omni; set false for a silent clip. Models without audio ignore this. See list_video_models for which models generate audio and the max seconds with vs without audio."
    • changedInput schema / properties / shots / items / properties / duration / description
      Previous value: -"Clip length in seconds. Default 5. Seedance does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10 — see each model's durations in list_video_models."New value: +"Clip length in seconds, or \"auto\" to let the model choose. Seedance 2.5 does 4-30s (auto bills the 30s cap up front and refunds the unused seconds); Seedance 2.0 does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10 — see each model's durations in list_video_models."
    • changedInput schema / properties / shots / items / properties / resolution / description
      Previous value: -"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest, only on Seedance 2.0 Mini (budget tier). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."New value: +"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest. Seedance 2.5 offers 480p and 720p only, on every mode. 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."
    • addedInput schema / properties / shots / items / properties / task_type
      Added value: +{
      +  "description": "Seedance 2.5 reference mode only: declare what you are doing with the reference clip so the size and length rules are checked immediately instead of failing a minute in. auto = a new take from the references (default), edit = change something inside the clip, extend = continue the clip. Editing and extension inherit the source clip's size, and editing also inherits its length.",
      +  "enum": [
      +    "auto",
      +    "edit",
      +    "extend"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / task_type
      Added value: +{
      +  "description": "Seedance 2.5 reference mode only: declare what you are doing with the reference clip so the size and length rules are checked immediately instead of failing a minute in. auto = a new take from the references (default), edit = change something inside the clip, extend = continue the clip. Editing and extension inherit the source clip's size, and editing also inherits its length.",
      +  "enum": [
      +    "auto",
      +    "edit",
      +    "extend"
      +  ],
      +  "type": "string"
      +}
  26. Changed2 schema fields changed
    • changedInput schema / properties / shots / items / properties / video_url / description
      Previous value: -"Required for video-edit and upscale (the source clip). Must be a publicly downloadable https URL."New value: +"Required for video-edit and upscale (the source clip). Accepts one of YOUR Switch videos — a job id from list_my_videos / get_video_status, or its download_url / view_url — or any publicly downloadable https URL. Switch resolves its own videos for you; no need to scrape a page for the file."
    • changedInput schema / properties / video_url / description
      Previous value: -"Required for video-edit and upscale (the source clip). Must be a publicly downloadable https URL."New value: +"Required for video-edit and upscale (the source clip). Accepts one of YOUR Switch videos — a job id from list_my_videos / get_video_status, or its download_url / view_url — or any publicly downloadable https URL. Switch resolves its own videos for you; no need to scrape a page for the file."
  27. Changed4 schema fields changed
    • addedInput schema / properties / face_reference_ids
      Added value: +{
      +  "description": "Face reference asset ids from upload_reference_asset (frame_type \"face\") — the ONLY way to use a face/likeness reference in video. Each id is verified server-side (your own untouched original + identity verification) before the shot fires or is charged; URLs and generic uploads here are rejected.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / reference_image_urls / description
      Previous value: -"Reference images. Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. For Seedance, at least one image or video reference is required."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead."
    • addedInput schema / properties / shots / items / properties / face_reference_ids
      Added value: +{
      +  "description": "Face reference asset ids from upload_reference_asset (frame_type \"face\") — the ONLY way to use a face/likeness reference in video. Each id is verified server-side (your own untouched original + identity verification) before the shot fires or is charged; URLs and generic uploads here are rejected.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / shots / items / properties / reference_image_urls / description
      Previous value: -"Reference images. Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. For Seedance, at least one image or video reference is required."New value: +"GENERIC reference images (products, scenery, outfits, style). Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. For Seedance, at least one image or video reference is required. For a person's face/likeness use face_reference_ids instead."
  28. Changed4 schema fields changed
    • changedInput schema / properties / resolution / description
      Previous value: -"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."New value: +"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest, only on Seedance 2.0 Mini (budget tier). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."
    • changedInput schema / properties / resolution / enum
      Previous value: -[
      -  "720p",
      -  "1080p",
      -  "4k"
      -]New value: +[
      +  "480p",
      +  "720p",
      +  "1080p",
      +  "4k"
      +]
    • changedInput schema / properties / shots / items / properties / resolution / description
      Previous value: -"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."New value: +"Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 480p is the cheapest, only on Seedance 2.0 Mini (budget tier). 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models."
    • changedInput schema / properties / shots / items / properties / resolution / enum
      Previous value: -[
      -  "720p",
      -  "1080p",
      -  "4k"
      -]New value: +[
      +  "480p",
      +  "720p",
      +  "1080p",
      +  "4k"
      +]
  29. Changed4 schema fields changed
    • changedInput schema / properties / image_url / description
      Previous value: -"Required for image-to-video / frame-to-frame / motion. A storage-backed (Switch) image URL — use the url returned by upload_media (for a photo the user attached in chat) or by list_my_assets."New value: +"Required for image-to-video / frame-to-frame / motion. Accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media) OR a public https url. An asset id is resolved server-side, so just pass the id you have — no need to fetch a url first."
    • changedInput schema / properties / reference_image_urls / description
      Previous value: -"Reference images. Seedance reference/omni accepts up to 9; Kling Omni accepts up to 7. For Seedance, at least one image or video reference is required. Use urls returned by upload_media (for photos the user attached in chat) or list_my_assets."New value: +"Reference images. Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. For Seedance, at least one image or video reference is required."
    • changedInput schema / properties / shots / items / properties / image_url / description
      Previous value: -"Required for image-to-video / frame-to-frame / motion. A storage-backed (Switch) image URL — use the url returned by upload_media (for a photo the user attached in chat) or by list_my_assets."New value: +"Required for image-to-video / frame-to-frame / motion. Accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media) OR a public https url. An asset id is resolved server-side, so just pass the id you have — no need to fetch a url first."
    • changedInput schema / properties / shots / items / properties / reference_image_urls / description
      Previous value: -"Reference images. Seedance reference/omni accepts up to 9; Kling Omni accepts up to 7. For Seedance, at least one image or video reference is required. Use urls returned by upload_media (for photos the user attached in chat) or list_my_assets."New value: +"Reference images. Each entry accepts EITHER a Switch asset id (from show_media / list_my_assets / upload_media / get_my_active_references) OR a public https url — asset ids are resolved server-side. Seedance reference/omni accepts up to 9; Kling Omni up to 7. For Seedance, at least one image or video reference is required."
  30. Changed10 schema fields changed
    • changedInput schema / properties / duration / description
      Previous value: -"Clip length in seconds. Default 5. 15s only on Switch Video (WAN); other models cap at 10 — see list_video_models."New value: +"Clip length in seconds. Default 5. Seedance does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10 — see each model's durations in list_video_models."
    • removedInput schema / properties / duration / enum
      Removed value: -[
      -  "5",
      -  "10",
      -  "15"
      -]
    • changedInput schema / properties / image_url / description
      Previous value: -"Required for image-to-video / frame-to-frame / motion. A storage-backed (Switch) image URL."New value: +"Required for image-to-video / frame-to-frame / motion. A storage-backed (Switch) image URL — use the url returned by upload_media (for a photo the user attached in chat) or by list_my_assets."
    • changedInput schema / properties / reference_image_urls / description
      Previous value: -"Reference images. Seedance reference/omni accepts up to 9; Kling Omni accepts up to 7. For Seedance, at least one image or video reference is required."New value: +"Reference images. Seedance reference/omni accepts up to 9; Kling Omni accepts up to 7. For Seedance, at least one image or video reference is required. Use urls returned by upload_media (for photos the user attached in chat) or list_my_assets."
    • addedInput schema / properties / resolution
      Added value: +{
      +  "description": "Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models.",
      +  "enum": [
      +    "720p",
      +    "1080p",
      +    "4k"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / shots / items / properties / duration / description
      Previous value: -"Clip length in seconds. Default 5. 15s only on Switch Video (WAN); other models cap at 10 — see list_video_models."New value: +"Clip length in seconds. Default 5. Seedance does 4-15s; Switch Video (WAN) does 5/10/15; Kling/Switch Video Edit cap at 10 — see each model's durations in list_video_models."
    • removedInput schema / properties / shots / items / properties / duration / enum
      Removed value: -[
      -  "5",
      -  "10",
      -  "15"
      -]
    • changedInput schema / properties / shots / items / properties / image_url / description
      Previous value: -"Required for image-to-video / frame-to-frame / motion. A storage-backed (Switch) image URL."New value: +"Required for image-to-video / frame-to-frame / motion. A storage-backed (Switch) image URL — use the url returned by upload_media (for a photo the user attached in chat) or by list_my_assets."
    • changedInput schema / properties / shots / items / properties / reference_image_urls / description
      Previous value: -"Reference images. Seedance reference/omni accepts up to 9; Kling Omni accepts up to 7. For Seedance, at least one image or video reference is required."New value: +"Reference images. Seedance reference/omni accepts up to 9; Kling Omni accepts up to 7. For Seedance, at least one image or video reference is required. Use urls returned by upload_media (for photos the user attached in chat) or list_my_assets."
    • addedInput schema / properties / shots / items / properties / resolution
      Added value: +{
      +  "description": "Output resolution. Defaults to 1080p where the model supports it. 720p is cheaper and faster. 4K is only on Kling v3 text/image and Kling Omni; Seedance text-to-video is 720p only. Each model lists its available resolutions in list_video_models.",
      +  "enum": [
      +    "720p",
      +    "1080p",
      +    "4k"
      +  ],
      +  "type": "string"
      +}
  31. Changed4 schema fields changed
    • changedInput schema / properties / reference_image_urls / description
      Previous value: -"Required for reference-to-video / Seedance omni (1-9 image URLs)."New value: +"Reference images. Seedance reference/omni accepts up to 9; Kling Omni accepts up to 7. For Seedance, at least one image or video reference is required."
    • changedInput schema / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni only: up to 3 reference video clips for motion/style guidance. NOTE: the AUDIO track of these clips is IGNORED — never extracted or preserved (see list_video_models)."New value: +"Seedance reference/omni only: up to 3 reference video clips for motion/style guidance. A Seedance video ref can satisfy the required visual anchor. NOTE: the AUDIO track of these clips is IGNORED — never extracted or preserved."
    • changedInput schema / properties / shots / items / properties / reference_image_urls / description
      Previous value: -"Required for reference-to-video / Seedance omni (1-9 image URLs)."New value: +"Reference images. Seedance reference/omni accepts up to 9; Kling Omni accepts up to 7. For Seedance, at least one image or video reference is required."
    • changedInput schema / properties / shots / items / properties / reference_video_urls / description
      Previous value: -"Seedance reference/omni only: up to 3 reference video clips for motion/style guidance. NOTE: the AUDIO track of these clips is IGNORED — never extracted or preserved (see list_video_models)."New value: +"Seedance reference/omni only: up to 3 reference video clips for motion/style guidance. A Seedance video ref can satisfy the required visual anchor. NOTE: the AUDIO track of these clips is IGNORED — never extracted or preserved."
  32. First observed

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare it is a non-read-only, open-world, non-destructive call; the description adds far more: renders are async (~30-90s), a background job delivers clips to the library, one task_id is returned per shot to poll via get_video_status/list_my_videos, unquoted runs are 'charged what it really costs', and enhancement is automatic except for as_written or proven prompts. It also states the reference-preservation contract (never silently drop, merge, reorder, convert or repurpose).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded correctly with purpose, but the body is a dense run-on paragraph mixing workflow calls, pricing, identity rules, reference ordering and a trailing provider-specific paragraph on Higgsfield Genjutsu. Every sentence carries information, yet the lack of structure (no grouping of workflow vs. pricing vs. references) makes it hard to scan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 27-parameter, no-output-schema, high-complexity generation tool, the description covers the async lifecycle, the return value (task_id per shot), polling path, charging model, and the pre-submission reference contract. Nothing an agent needs in order to invoke it correctly appears to be missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description goes beyond by explaining storyboard semantics (max 4 by default, hard max 10, each shot must be DIFFERENT, never repeat a prompt to get copies) and the chip-to-role mapping requirement, which is operational meaning not present in the schema. It does not add much for the simpler params like resolution or aspect_ratio, which the schema already covers thoroughly.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource ('Generate video') and immediately names the provider lineup and the eight modes, so an agent knows exactly what capability this covers. It also implicitly separates itself from quote_video, enhance_video_prompt, list_video_models and get_video_status by describing how they relate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit routing rules throughout: 'Keep the user-selected model; use list_video_models only when the selection or its inputs are unknown', 'Load load_video_workflow once per conversation', 'call enhance_video_prompt first', and 'Use quote_video only to turn a draft into Full HD' with the contrasting case (any other video runs without a quote). These are concrete when/when-not conditions naming the alternative tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources