Build with Veevid API

text-to-video

Generates a 4-8 second video with native audio from a text prompt using Google Veo 3.1 (Lite / Fast / Quality tiers).

Rules

• resolution, when sent, must be 720p, 1080p or 4k (422 otherwise).
• duration, when sent, must be '4', '6' or '8' (400 otherwise); omitted duration becomes '8'.
• Send lite, standard or pro: any other accepted video_quality value (e.g. "1080p") is treated as the Quality (pro) tier — set the output size with resolution.
• Price depends only on the video_quality tier and resolution; duration and aspect_ratio do not change the price.

Example request body

{
  "mode": "veo3",
  "generation_type": "text-to-video",
  "prompt": "A golden retriever running through sunflowers, cinematic lighting",
  "video_quality": "standard",
  "resolution": "720p",
  "duration": "8",
  "aspect_ratio": "16:9"
}

image-to-video

Animates a first frame (optionally to a last frame) into a 4-8 second Veo 3.1 video with native audio.

Input files

• images: 1-2 image URLs: first frame, optional last frame (max 10MB per image)

Upload folders for /api/storage/upload

• image: video-generator-veo3

Rules

• image or a non-empty images array is required (400 'Image is required for image-to-video generation').
• Send 1 or 2 images: the first frame and an optional last frame.
• resolution must be 720p/1080p/4k (422) and duration 4/6/8 (400) when sent.
• Send lite, standard or pro: any other accepted video_quality value (e.g. "1080p") is treated as the Quality (pro) tier — set the output size with resolution.
• Price depends only on the video_quality tier and resolution.
• To guide generation with reference images (rather than first/last frames), use generation_type reference-to-video.

Example request body

{
  "mode": "veo3",
  "generation_type": "image-to-video",
  "prompt": "The woman slowly turns toward the camera and smiles",
  "images": [
    "https://example.com/first-frame.jpg"
  ],
  "video_quality": "standard",
  "resolution": "720p",
  "duration": "8",
  "aspect_ratio": "16:9"
}

reference-to-video

Generates an 8-second Veo 3.1 video that keeps subjects consistent with 1-3 reference images.

Input files

• images: 1-3 reference image URLs (max 10MB per image)

Upload folders for /api/storage/upload

• image: video-generator-veo3

Rules

• images must contain 1-3 URLs (400 'Reference-to-video requires 1-3 images').
• video_quality, when sent, must be lite or standard; the Quality tier is rejected with 422.
• duration, when sent, must be '8' (422).
• resolution must be 720p/1080p/4k (422) when sent.

Example request body

{
  "mode": "veo3",
  "generation_type": "reference-to-video",
  "prompt": "The character from the reference walks through a neon-lit street at night",
  "images": [
    "https://example.com/character.png"
  ],
  "video_quality": "standard",
  "resolution": "720p",
  "duration": "8",
  "aspect_ratio": "16:9"
}

text-to-video

Generates a 5 or 10 second video from a text prompt with Runway Gen-4 Turbo.

Rules

• duration must be 5 or 10 (400 'Runway only supports 5s or 10s durations').
• 1080p is only allowed with 5-second duration (400 '1080p is only supported for 5-second Runway videos').
• video_quality is required and must be 720p or 1080p; any other value (or omitting it) makes the request fail without charging.

Example request body

{
  "mode": "runway",
  "generation_type": "text-to-video",
  "prompt": "A paper boat drifting down a rainy city gutter, macro shot",
  "duration": "5",
  "video_quality": "720p",
  "aspect_ratio": "16:9"
}

image-to-video

Animates a single image into a 5 or 10 second video with Runway Gen-4 Turbo.

Input files

• image: 1 image URL (start frame; max 10MB)

Upload folders for /api/storage/upload

• image: video-generator-runway

Rules

• image or a non-empty images array is required (400 'Image is required for image-to-video generation').
• duration must be 5 or 10 (400).
• 1080p is only allowed with 5-second duration (400).
• video_quality is required and must be 720p or 1080p; omitting it makes the request fail.

Example request body

{
  "mode": "runway",
  "generation_type": "image-to-video",
  "prompt": "The lighthouse beam sweeps across stormy waves",
  "image": "https://example.com/lighthouse.jpg",
  "duration": "5",
  "video_quality": "720p",
  "aspect_ratio": "16:9"
}

text-to-video

Generate a 6-30 second video with synchronized audio from a text prompt using xAI Grok Imagine.

Rules

• duration must be an integer string between 6 and 30 (400 otherwise); omitted duration defaults to 6.
• video_quality, when sent, must be 480p or 720p (400 otherwise).
• grokMode must be fun, normal or spicy; aspect_ratio must be one of the listed values.
• prompt must be non-empty.

Example request body

{
  "mode": "grok-imagine",
  "generation_type": "text-to-video",
  "prompt": "A cat DJ spinning records in a neon club, crowd cheering",
  "duration": "6",
  "video_quality": "480p",
  "aspect_ratio": "1:1",
  "grokMode": "normal"
}

image-to-video

Animate one or more images into a 6-30 second video with audio using xAI Grok Imagine.

Input files

• image: First image URL.
• images: Optional array of up to 7 image URLs when more than one image is used (jpg/png/webp, max 10MB each).

Upload folders for /api/storage/upload

• image: video-generator-grok-imagine

Rules

• image-to-video requires image or images (400).
• Send at most 7 images.
• aspect_ratio only applies when more than one image is used; with a single image the output follows the image.
• duration must be an integer string between 6 and 30 (400 otherwise); omitted duration defaults to 6.
• video_quality, when sent, must be 480p or 720p (400 otherwise).
• grokMode must be fun, normal or spicy; aspect_ratio must be one of the listed values.
• prompt must be non-empty.

Example request body

{
  "mode": "grok-imagine",
  "generation_type": "image-to-video",
  "prompt": "She turns toward the camera and laughs as the wind blows her hair",
  "image": "https://example.com/portrait.jpg",
  "duration": "6",
  "video_quality": "480p",
  "aspect_ratio": "1:1",
  "grokMode": "normal"
}

text-to-video

Generates a cinematic video with optional synced native audio from a text prompt using Kling 2.6.

Rules

• duration must be '5' or '10'; aspect_ratio must be one of 16:9, 9:16, 1:1.

Example request body

{
  "mode": "kling-2-6",
  "generation_type": "text-to-video",
  "prompt": "A red fox running through a snowy forest at sunrise, cinematic",
  "duration": "5",
  "aspect_ratio": "16:9",
  "generate_audio": true
}

image-to-video

Animates a start image into a video guided by a text prompt, with optional synced native audio, using Kling 2.6.

Input files

• image: 1 image URL used as the start frame (JPEG/PNG/WebP, max 10MB)

Upload folders for /api/storage/upload

• image: video-generator-kling26

Rules

• image (or images[0]) is required for image-to-video, otherwise 400 'Image is required for image-to-video generation'.
• Only one image is used (start frame); there is no end-frame support for Kling 2.6.
• duration must be '5' or '10'.

Example request body

{
  "mode": "kling-2-6",
  "generation_type": "image-to-video",
  "prompt": "The woman slowly turns her head and smiles",
  "image": "https://cdn.veevid.ai/sample/motion-control-image-1.webp",
  "duration": "5",
  "aspect_ratio": "16:9",
  "generate_audio": true
}

text-to-video

Generates a 3-15 second video with optional native audio from a text prompt or a multi-shot prompt list using Kling 3.0 Standard/Pro.

Rules

• duration must be an integer 3-15.
• aspect_ratio must be one of 16:9, 9:16, 1:1 when provided.
• model_version must be kling-3-standard or kling-3-pro, otherwise 400.
• prompt and multi_prompt must not both be non-empty; with multi_prompt, set duration to the sum of item durations.

Example request body

{
  "mode": "kling-3",
  "generation_type": "text-to-video",
  "prompt": "A drone shot flying over a neon-lit city at night, rain reflections",
  "model_version": "kling-3-standard",
  "duration": "5",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "shot_type": "customize",
  "cfg_scale": 0.5
}

image-to-video

Animates a start frame (optionally to an end frame) into a 3-15 second video with optional native audio (Kling 3.0 Standard or Pro).

Input files

• image: 1 image URL (start frame); JPEG/PNG/WebP, max 10MB
• images: 1-2 image URLs: [start_frame] or [start_frame, end_frame]; only the first two are used

Upload folders for /api/storage/upload

• image: video-generator-kling3
• images: video-generator-kling3

Rules

• image or images[0] is required, otherwise 400 'Image is required for image-to-video generation'.
• duration must be an integer 3-15; aspect_ratio one of 16:9, 9:16, 1:1; model_version kling-3-standard or kling-3-pro.
• images[1] is used as the end frame; an end frame cannot be combined with multi_prompt.

Example request body

{
  "mode": "kling-3",
  "generation_type": "image-to-video",
  "prompt": "The character walks toward the camera as the wind blows her hair",
  "image": "https://cdn.veevid.ai/sample/motion-control-image-1.webp",
  "images": [
    "https://cdn.veevid.ai/sample/motion-control-image-1.webp"
  ],
  "model_version": "kling-3-pro",
  "duration": "5",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "shot_type": "customize",
  "cfg_scale": 0.5
}

text-to-video

Generates a 720p-4K video with native audio from a text prompt using LTX 2.5 Fast or Pro; with a driving audio file it animates a scene to that audio (audio-to-video).

Input files

• audio: Optional: 1 driving audio file (2-20s, Pro 2-10s; max 15MB), uploaded to folder 'ltx25/audio'

Upload folders for /api/storage/upload

• audio: ltx25/audio

Rules

• text-to-video does not accept images (400); use image-to-video.
• duration must be one of '6','8','10' for ltx-2.5-pro and '6'-'20' (even) for ltx-2.5-fast (400 otherwise).
• video_quality must be 720p or 1080p for ltx-2.5-pro; 720p, 1080p, 1440p or 2160p for ltx-2.5-fast (400 otherwise).
• ltx-2.5-fast longer than 10s supports only 720p/1080p and 24/25 fps (400 otherwise).
• Invalid combinations are rejected with 400 before charging; nothing is silently downgraded.
• audio must be uploaded first with POST /api/storage/upload (folder 'ltx25/audio'); external URLs and files in other folders are rejected with 400 before charging.
• If the server cannot read the length of the uploaded audio file, the request is rejected with 400; re-encode it as MP3 or WAV and upload again.
• Audio must be 2-20s long (Pro: 2-10s), measured on the server (400 otherwise).
• With audio: duration, video_quality, target_fps and generate_audio are ignored; camera_motion and an end image are rejected (400).
• To quote audio-to-video, send the uploaded audio URL (the quote measures the file). Before uploading, send has_audio_input: true and input_audio_duration instead.
• Generation is async; poll by generation_id.

Example request body

{
  "mode": "ltx-2-5",
  "generation_type": "text-to-video",
  "prompt": "A slow cinematic dolly shot through a neon-lit rainy street at night",
  "model_version": "ltx-2.5-fast",
  "duration": "6",
  "video_quality": "720p",
  "aspect_ratio": "16:9",
  "target_fps": 25,
  "generate_audio": true
}

image-to-video

Animates a start image (optionally toward an end image) into a 720p-4K video with native audio using LTX 2.5 Fast or Pro; with a driving audio file it animates the image to that audio (audio-to-video).

Input files

• image: 1 image URL used as the first frame
• images: Optional: [start, end] - 2 image URLs; the second is used as the last frame
• audio: Optional: 1 driving audio file (2-20s, Pro 2-10s; max 15MB), uploaded to folder 'ltx25/audio'

Upload folders for /api/storage/upload

• image: video-generator-ltx25
• end image: video-generator-ltx25-end
• audio: ltx25/audio

Rules

• image-to-video requires a start image in image or images (400 'LTX 2.5 image-to-video requires a start image').
• Start frame = first image; end frame = second image if present. End image does not change the price.
• duration must be one of '6','8','10' for ltx-2.5-pro and '6'-'20' (even) for ltx-2.5-fast (400 otherwise).
• video_quality must be 720p or 1080p for ltx-2.5-pro; 720p, 1080p, 1440p or 2160p for ltx-2.5-fast (400 otherwise).
• ltx-2.5-fast longer than 10s supports only 720p/1080p and 24/25 fps (400 otherwise).
• Invalid combinations are rejected with 400 before charging; nothing is silently downgraded.
• audio must be uploaded first with POST /api/storage/upload (folder 'ltx25/audio'); external URLs and files in other folders are rejected with 400 before charging.
• If the server cannot read the length of the uploaded audio file, the request is rejected with 400; re-encode it as MP3 or WAV and upload again.
• Audio must be 2-20s long (Pro: 2-10s), measured on the server (400 otherwise).
• With audio: duration, video_quality, target_fps and generate_audio are ignored; camera_motion and an end image are rejected (400).
• To quote audio-to-video, send the uploaded audio URL (the quote measures the file). Before uploading, send has_audio_input: true and input_audio_duration instead.
• Generation is async; poll by generation_id.

Example request body

{
  "mode": "ltx-2-5",
  "generation_type": "image-to-video",
  "prompt": "The woman turns toward the camera and smiles as the wind moves her hair",
  "image": "https://example.com/start.jpg",
  "images": [
    "https://example.com/start.jpg"
  ],
  "model_version": "ltx-2.5-fast",
  "duration": "6",
  "video_quality": "1080p",
  "aspect_ratio": "auto",
  "target_fps": 25,
  "generate_audio": true
}

text-to-video

Generates a high-resolution (1080p-2160p) video with optional native audio from a text prompt using LTX 2.3 or LTX 2.3 Fast.

Rules

• Always send duration; it must be one of '6','8','10','12','14','16','18','20' (400 otherwise).
• model_version 'ltx-2.3' supports only duration 6/8/10; 'ltx-2.3-fast' supports 6-20 (even). Other combinations make the generation fail.
• video_quality must be one of 1080p, 1440p, 2160p (400 otherwise); defaults to 1080p.
• target_fps must be 24, 25, 48 or 50; other values make the generation fail.
• With ltx-2.3-fast and duration > 10, output is always 1080p at 25 fps and priced at 1080p.
• aspect_ratio: use one of the listed values.
• Generation is async; poll by generation_id.

Example request body

{
  "mode": "ltx-2-3",
  "generation_type": "text-to-video",
  "prompt": "A slow cinematic dolly shot through a neon-lit rainy street at night",
  "model_version": "ltx-2.3",
  "duration": "6",
  "video_quality": "1080p",
  "aspect_ratio": "16:9",
  "target_fps": 25,
  "generate_audio": true
}

image-to-video

Animates a start image (optionally toward an end image) into a high-resolution video with optional native audio using LTX 2.3 or LTX 2.3 Fast.

Input files

• image: 1 image URL used as the first frame (JPEG/PNG/GIF, max 10MB)
• images: Optional: [start, end] - 2 image URLs; the second is used as the last frame

Upload folders for /api/storage/upload

• image: video-generator-ltx23
• end image: video-generator-ltx23-end

Rules

• image-to-video requires image or a non-empty images array (400 'Image is required for image-to-video generation').
• Start frame = image (or images[0] if image is absent); end frame = images[1] if present.
• Always send duration; it must be one of '6','8','10','12','14','16','18','20' (400 otherwise).
• model_version 'ltx-2.3' supports only duration 6/8/10; 'ltx-2.3-fast' supports 6-20 (even). Other combinations make the generation fail.
• video_quality must be one of 1080p, 1440p, 2160p (400 otherwise); defaults to 1080p.
• target_fps must be 24, 25, 48 or 50; other values make the generation fail.
• With ltx-2.3-fast and duration > 10, output is always 1080p at 25 fps and priced at 1080p.
• aspect_ratio: use one of the listed values.
• End image does not change the price.

Example request body

{
  "mode": "ltx-2-3",
  "generation_type": "image-to-video",
  "prompt": "The woman turns toward the camera and smiles as the wind moves her hair",
  "image": "https://example.com/start.jpg",
  "images": [
    "https://example.com/start.jpg"
  ],
  "model_version": "ltx-2.3",
  "duration": "6",
  "video_quality": "1080p",
  "aspect_ratio": "16:9",
  "target_fps": 25,
  "generate_audio": true
}

image-to-video

Animates a character image with the motion of a reference video (animate), or replaces the person in the reference video with the character (replace).

Input files

• image: 1 character image URL (JPEG/PNG/GIF, max 10MB)
• video: 1 reference video URL, max 120 seconds (max 200MB)

Upload folders for /api/storage/upload

• image: video-generator
• video: wan-animate/reference-videos

Rules

• image is required (400 'Character image is required for wan-animate generation').
• video is required (400 'Reference video is required for wan-animate generation').
• When sent, duration must be an integer > 0 and <= 120 (400).
• prompt, if sent, must be <= 5000 characters (400).
• generation_type must be 'image-to-video'.
• Always send video_quality ('480p' or '720p').
• animationMode must be 'animate' or 'replace'; defaults to 'animate'.
• Send duration equal to the reference video length in whole seconds (rounded up).
• Generation is async; poll by generation_id.

Example request body

{
  "mode": "wan-animate",
  "generation_type": "image-to-video",
  "prompt": "",
  "image": "https://example.com/character.png",
  "video": "https://example.com/dance.mp4",
  "duration": "8",
  "video_quality": "480p",
  "aspect_ratio": "",
  "animationMode": "animate"
}

text-to-video

Seedance 1.5 Pro text-to-video generation, 4-12s up to 1080p with optional native audio.

Rules

• duration must be an integer string between 4 and 12; otherwise 400.
• camera_fixed and seed do not affect price.
• Only text-to-video and image-to-video are supported.
• prompt must be non-empty.

Example request body

{
  "mode": "seedance-1.5-pro",
  "generation_type": "text-to-video",
  "prompt": "A red fox running through fresh snow at sunrise, cinematic tracking shot",
  "duration": "5",
  "aspect_ratio": "16:9",
  "video_quality": "720p",
  "generate_audio": true,
  "camera_fixed": false,
  "seed": -1
}

image-to-video

Seedance 1.5 Pro image-to-video (first frame, optional last frame) generation, 4-12s up to 1080p with optional native audio.

Input files

• image: 1 image URL used as the first frame (JPEG/PNG/WebP, max 10MB)
• images: optional 2nd image URL as last frame: send images=[first,last]

Upload folders for /api/storage/upload

• image: seedance15pro

Rules

• duration must be an integer string between 4 and 12; otherwise 400.
• camera_fixed and seed do not affect price.
• Only text-to-video and image-to-video are supported.
• prompt must be non-empty.

Example request body

{
  "mode": "seedance-1.5-pro",
  "generation_type": "image-to-video",
  "prompt": "A red fox running through fresh snow at sunrise, cinematic tracking shot",
  "duration": "5",
  "aspect_ratio": "auto",
  "video_quality": "720p",
  "generate_audio": true,
  "camera_fixed": false,
  "seed": -1,
  "image": "https://example.com/first-frame.jpg",
  "images": [
    "https://example.com/first-frame.jpg"
  ]
}

text-to-video

Veevid 1.0 Pro text-to-video generation, 4-12s up to 1080p with optional native audio.

Rules

• duration must be an integer string between 4 and 12; otherwise 400.
• camera_fixed and seed do not affect price.
• Only text-to-video and image-to-video are supported.
• prompt must be non-empty.

Example request body

{
  "mode": "veevid-1.0-pro",
  "generation_type": "text-to-video",
  "prompt": "A red fox running through fresh snow at sunrise, cinematic tracking shot",
  "duration": "5",
  "aspect_ratio": "16:9",
  "video_quality": "720p",
  "generate_audio": true,
  "camera_fixed": false,
  "seed": -1
}

image-to-video

Veevid 1.0 Pro image-to-video (first frame, optional last frame) generation, 4-12s up to 1080p with optional native audio.

Input files

• image: 1 image URL used as the first frame (JPEG/PNG/WebP, max 10MB)
• images: optional 2nd image URL as last frame: send images=[first,last]

Upload folders for /api/storage/upload

• image: veevid-1-0-pro

Rules

• duration must be an integer string between 4 and 12; otherwise 400.
• camera_fixed and seed do not affect price.
• Only text-to-video and image-to-video are supported.
• prompt must be non-empty.

Example request body

{
  "mode": "veevid-1.0-pro",
  "generation_type": "image-to-video",
  "prompt": "A red fox running through fresh snow at sunrise, cinematic tracking shot",
  "duration": "5",
  "aspect_ratio": "auto",
  "video_quality": "720p",
  "generate_audio": true,
  "camera_fixed": false,
  "seed": -1,
  "image": "https://example.com/first-frame.jpg",
  "images": [
    "https://example.com/first-frame.jpg"
  ]
}

text-to-video

Veevid 2.0 Pro text-to-video, 4-15s, Mini/Fast/Standard tiers up to 4K with native audio.

Rules

• duration is clamped to 4-15 seconds (for both price and output); no range error is returned.
• Always send model_version; values other than the Mini/Fast tiers are treated as Standard ('seedance-2.0').
• generate_audio and seed do not affect price.

Example request body

{
  "mode": "veevid-2.0-pro",
  "generation_type": "text-to-video",
  "prompt": "A chef flips a pancake in a sunlit kitchen, slow motion, warm tones",
  "model_version": "seedance-2.0-fast",
  "duration": "5",
  "aspect_ratio": "16:9",
  "video_quality": "480p",
  "generate_audio": true,
  "seed": -1
}

image-to-video

Veevid 2.0 Pro image-to-video with first/optional last frame, 4-15s, Mini/Fast/Standard tiers up to 4K with native audio.

Input files

• image: 1 image URL used as first frame (JPEG/PNG/WebP, max 30MB)
• images: optional [first,last] to add a last frame

Upload folders for /api/storage/upload

• image: seedance20

Rules

• duration is clamped to 4-15 seconds (for both price and output); no range error is returned.
• Always send model_version; values other than the Mini/Fast tiers are treated as Standard ('seedance-2.0').
• generate_audio and seed do not affect price.

Example request body

{
  "mode": "veevid-2.0-pro",
  "generation_type": "image-to-video",
  "prompt": "A chef flips a pancake in a sunlit kitchen, slow motion, warm tones",
  "model_version": "seedance-2.0-fast",
  "duration": "5",
  "aspect_ratio": "auto",
  "video_quality": "480p",
  "generate_audio": true,
  "seed": -1,
  "image": "https://example.com/first-frame.jpg",
  "images": [
    "https://example.com/first-frame.jpg"
  ]
}

text-to-video

Veevid 2.5 Pro text-to-video, one-take videos 4-30s up to 1080p with native audio.

Rules

• duration must be a pure integer string 4-30 or '-1'; otherwise 400.
• output_format must be mp4 or mov for this mode; image formats (PNG/JPEG) return 400.
• output_format, generate_audio and seed do not affect price.
• 480p results are usually drafts: the status response then includes seedance25_draft, and the draft can be upgraded once to a 1080p version within 7 days with POST /api/video-generation/{id}/upgrade-draft.

Example request body

{
  "mode": "veevid-2.5-pro",
  "generation_type": "text-to-video",
  "prompt": "A lighthouse keeper climbs the spiral stairs at dusk, one continuous take",
  "duration": "5",
  "aspect_ratio": "16:9",
  "video_quality": "480p",
  "output_format": "mp4",
  "generate_audio": true,
  "seed": -1
}

image-to-video

Veevid 2.5 Pro image-to-video with first/optional last frame, one-take videos 4-30s up to 1080p with native audio.

Input files

• image: 1 image URL used as first frame (JPEG/PNG/WebP, max 30MB)
• images: optional [first,last] to add a last frame

Upload folders for /api/storage/upload

• image: seedance25

Rules

• image (or images) is required for image-to-video, else 400.
• For image-to-video the aspect ratio always follows the first frame, regardless of aspect_ratio.
• duration must be a pure integer string 4-30 or '-1'; otherwise 400.
• output_format must be mp4 or mov for this mode; image formats (PNG/JPEG) return 400.
• output_format, generate_audio and seed do not affect price.
• 480p results are usually drafts: the status response then includes seedance25_draft, and the draft can be upgraded once to a 1080p version within 7 days with POST /api/video-generation/{id}/upgrade-draft.

Example request body

{
  "mode": "veevid-2.5-pro",
  "generation_type": "image-to-video",
  "prompt": "A lighthouse keeper climbs the spiral stairs at dusk, one continuous take",
  "duration": "5",
  "aspect_ratio": "auto",
  "video_quality": "480p",
  "output_format": "mp4",
  "generate_audio": true,
  "seed": -1,
  "image": "https://example.com/first-frame.jpg",
  "images": [
    "https://example.com/first-frame.jpg"
  ]
}

text-to-video

Generates a 4-15s video with optional native audio from a text prompt using ByteDance Seedance 2.0 (Mini/Fast/Standard tiers).

Rules

• duration must be a JSON string (e.g. "5"); a number returns 400.
• duration is clamped to 4-15 seconds (for both price and output) instead of being rejected.
• Always send model_version; values other than seedance-2.0 / seedance-2.0-fast / seedance-2.0-mini are treated as seedance-2.0 (Standard).
• seedance-2.0-fast and seedance-2.0-mini support only 480p/720p; requested 1080p/4k is reduced to 720p and priced as 720p.
• Credits are deducted at submission (402 if insufficient); unused credits are refunded automatically if the generation fails.

Example request body

{
  "mode": "seedance-2.0",
  "generation_type": "text-to-video",
  "prompt": "A red fox running through fresh snow at sunrise, cinematic tracking shot",
  "model_version": "seedance-2.0-fast",
  "video_quality": "480p",
  "duration": "5",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "seed": -1
}

image-to-video

Animates a first-frame image (optionally with a last-frame image) into a 4-15s video with Seedance 2.0.

Input files

• image: 1 public image URL used as first frame (JPEG/PNG/WebP, max 30MB)
• images: optional [first_frame_url, last_frame_url] for first+last-frame mode

Upload folders for /api/storage/upload

• image: seedance20

Rules

• duration must be a JSON string (e.g. "5"); a number returns 400.
• duration is clamped to 4-15 seconds (for both price and output) instead of being rejected.
• Always send model_version; values other than seedance-2.0 / seedance-2.0-fast / seedance-2.0-mini are treated as seedance-2.0 (Standard).
• seedance-2.0-fast and seedance-2.0-mini support only 480p/720p; requested 1080p/4k is reduced to 720p and priced as 720p.
• Credits are deducted at submission (402 if insufficient); unused credits are refunded automatically if the generation fails.
• aspect_ratio is applied as sent for image-to-video.
• Price is the same as text-to-video (images do not add cost).

Example request body

{
  "mode": "seedance-2.0",
  "generation_type": "image-to-video",
  "prompt": "The woman turns toward the camera and smiles",
  "image": "https://example.com/first.jpg",
  "images": [
    "https://example.com/first.jpg"
  ],
  "model_version": "seedance-2.0-fast",
  "video_quality": "720p",
  "duration": "5",
  "aspect_ratio": "auto",
  "generate_audio": true,
  "seed": -1
}

reference-to-video

Generates a 4-15s video guided by multimodal references (up to 9 images, 3 videos, 3 audio clips) with Seedance 2.0 omni reference.

Input files

• images: 0-9 reference image URLs (JPEG/PNG/WebP; max 30MB each)
• videos: 0-3 reference video URLs (mp4/mov, max 50MB each, total <= 15s)
• audios: 0-3 reference audio URLs (wav/mp3, max 15MB each, total <= 15s); requires at least one image or video

Upload folders for /api/storage/upload

• image: seedance20
• video: seedance20/reference-videos
• audio: seedance20/audio

Rules

• duration must be a JSON string (e.g. "5"); a number returns 400.
• duration is clamped to 4-15 seconds (for both price and output) instead of being rejected.
• Always send model_version; values other than seedance-2.0 / seedance-2.0-fast / seedance-2.0-mini are treated as seedance-2.0 (Standard).
• seedance-2.0-fast and seedance-2.0-mini support only 480p/720p; requested 1080p/4k is reduced to 720p and priced as 720p.
• Credits are deducted at submission (402 if insufficient); unused credits are refunded automatically if the generation fails.
• At least one reference image or video is required (audio-only is not allowed); otherwise the generation fails.
• When sending videos, send input_video_duration equal to the total reference video length in seconds (rounded up); > 15 is rejected with 400.
• Send at most 9 images, 3 videos and 3 audios; extras are ignored.
• Without reference videos (images/audio only), price equals the text-to-video price.
• When quoting with /api/quote, add has_video_input: true and input_video_duration if you send reference videos (the quote endpoint does not read video URLs, so the price would come out too low).

Example request body

{
  "mode": "seedance-2.0",
  "generation_type": "reference-to-video",
  "prompt": "The character from image 1 dances in the style of video 1",
  "images": [
    "https://example.com/character.png"
  ],
  "videos": [
    "https://example.com/dance.mp4"
  ],
  "input_video_duration": 6,
  "model_version": "seedance-2.0-fast",
  "video_quality": "480p",
  "duration": "5",
  "aspect_ratio": "auto",
  "generate_audio": true,
  "seed": -1
}

text-to-video

Generates a 4-30s one-take video with optional native audio from a text prompt using ByteDance Seedance 2.5.

Rules

• duration must be a JSON string matching /^-?\d+$/ and equal -1 or 4-30, otherwise 400
• output_format must be mp4 or mov (400 otherwise)
• Always send video_quality as 480p, 720p or 1080p ('4k' is treated as 1080p)
• No model_version parameter (single tier)
• Price can be previewed with POST /api/quote; /api/generate-video returns 402 if credits are insufficient. Credits for failed generations are refunded automatically.
• 480p results are usually drafts: the status response then includes seedance25_draft, and the draft can be upgraded once to a 1080p version within 7 days with POST /api/video-generation/{id}/upgrade-draft.

Example request body

{
  "mode": "seedance-2.5",
  "generation_type": "text-to-video",
  "prompt": "A lighthouse keeper climbs the spiral stairs at dusk, one continuous shot",
  "video_quality": "480p",
  "duration": "5",
  "aspect_ratio": "16:9",
  "output_format": "mp4",
  "generate_audio": true,
  "seed": -1
}

image-to-video

Animates a first-frame image (optionally to a last-frame image) into a 4-30s video with Seedance 2.5; aspect ratio follows the input image.

Input files

• image: 1 public image URL used as the first frame (JPEG/PNG/WEBP; max 30MB)
• images: optional [first_frame_url, last_frame_url]

Upload folders for /api/storage/upload

• image: seedance25

Rules

• duration must be a JSON string matching /^-?\d+$/ and equal -1 or 4-30, otherwise 400
• output_format must be mp4 or mov (400 otherwise)
• Always send video_quality as 480p, 720p or 1080p ('4k' is treated as 1080p)
• No model_version parameter (single tier)
• Price can be previewed with POST /api/quote; /api/generate-video returns 402 if credits are insufficient. Credits for failed generations are refunded automatically.
• image-to-video requires image or images (400 'Image is required for image-to-video generation')
• aspect_ratio has no effect for image-to-video; the output follows the first-frame image
• Price is the same as text-to-video (images do not add cost)
• 480p results are usually drafts: the status response then includes seedance25_draft, and the draft can be upgraded once to a 1080p version within 7 days with POST /api/video-generation/{id}/upgrade-draft.

Example request body

{
  "mode": "seedance-2.5",
  "generation_type": "image-to-video",
  "prompt": "The camera slowly pushes in as leaves drift past",
  "image": "https://example.com/first.jpg",
  "images": [
    "https://example.com/first.jpg",
    "https://example.com/last.jpg"
  ],
  "video_quality": "720p",
  "duration": "8",
  "aspect_ratio": "auto",
  "output_format": "mp4",
  "generate_audio": true,
  "seed": -1
}

reference-to-video

Generates a 4-30s video guided by up to 30 reference images, 10 reference videos and 10 reference audio clips (audio-only allowed) with Seedance 2.5.

Input files

• images: 0-30 reference image URLs (JPEG/PNG/WEBP; max 30MB each)
• videos: 0-10 reference video URLs (mp4/mov, max 50MB each, total <= 30s)
• audios: 0-10 reference audio URLs (wav/mp3, max 15MB each, total <= 30s)

Upload folders for /api/storage/upload

• image: seedance25
• video: seedance25/reference-videos
• audio: seedance25/audio

Rules

• duration must be a JSON string matching /^-?\d+$/ and equal -1 or 4-30, otherwise 400
• output_format must be mp4 or mov (400 otherwise)
• Always send video_quality as 480p, 720p or 1080p ('4k' is treated as 1080p)
• No model_version parameter (single tier)
• Price can be previewed with POST /api/quote; /api/generate-video returns 402 if credits are insufficient. Credits for failed generations are refunded automatically.
• At least one reference image, video or audio is required; the generation fails otherwise
• Send input_video_duration equal to the total reference video length (seconds) whenever videos is sent; values > 30 are rejected with 400
• aspect_ratio is honored for reference-to-video
• Without reference videos (images/audio only), price equals text-to-video price
• 480p results are usually drafts: the status response then includes seedance25_draft, and the draft can be upgraded once to a 1080p version within 7 days with POST /api/video-generation/{id}/upgrade-draft.
• When quoting with /api/quote, add has_video_input: true and input_video_duration if you send reference videos (the quote endpoint does not read video URLs, so the price would come out too low).

Example request body

{
  "mode": "seedance-2.5",
  "generation_type": "reference-to-video",
  "prompt": "The product from image 1 rotates on a marble table, lit like video 1",
  "images": [
    "https://example.com/product.png"
  ],
  "videos": [
    "https://example.com/lighting.mp4"
  ],
  "input_video_duration": 8,
  "video_quality": "480p",
  "duration": "10",
  "aspect_ratio": "9:16",
  "output_format": "mp4",
  "generate_audio": true,
  "seed": -1
}

text-to-video

Generates a 5-15 second video with synchronized audio from a text prompt using Wan 2.6.

Input files

• audio: optional 1 audio URL (mp3/ogg/wav/m4a/aac)

Upload folders for /api/storage/upload

• audio: wan26/audio

Rules

• duration must be one of 5, 10, 15 (default 5)
• video_quality and aspect_ratio are not validated; always send one of the listed values

Example request body

{
  "mode": "wan-2-6",
  "generation_type": "text-to-video",
  "prompt": "A red fox running through fresh snow at sunrise, cinematic",
  "duration": "5",
  "video_quality": "720p",
  "aspect_ratio": "16:9"
}

image-to-video

Animates a single image into a 5-15 second video with Wan 2.6.

Input files

• image: 1 image URL (first frame); jpg/png/webp, max 10MB
• audio: optional 1 audio URL (mp3/ogg/wav/m4a/aac)

Upload folders for /api/storage/upload

• image: video-generator
• audio: wan26/audio

Rules

• image (or images[0]) is required
• aspect_ratio is not used for image-to-video; the output follows the image
• duration must be one of 5, 10, 15

Example request body

{
  "mode": "wan-2-6",
  "generation_type": "image-to-video",
  "prompt": "The character turns and smiles at the camera",
  "image": "https://example.com/input.jpg",
  "duration": "5",
  "video_quality": "720p"
}

reference-to-video

Generates a new video guided by 1-3 reference videos (subject/motion reference) with Wan 2.6.

Input files

• videos: 1-3 reference video URLs (mp4/mov/mkv; max 10MB each)

Upload folders for /api/storage/upload

• video: wan26/reference-videos

Rules

• At least one reference video (video or videos) is required
• At most 3 reference videos
• duration 15 is rejected (only 5 or 10)
• Audio input is not supported for reference-to-video; do not send audio

Example request body

{
  "mode": "wan-2-6",
  "generation_type": "reference-to-video",
  "prompt": "The character from the reference video dances in a neon-lit street",
  "videos": [
    "https://example.com/ref.mp4"
  ],
  "duration": "5",
  "video_quality": "720p",
  "aspect_ratio": "16:9"
}

text-to-video

Generates a 2-15 second video from a text prompt with Wan 2.7 (smoother motion, better scene fidelity).

Input files

• audio: optional 1 audio URL (mp3/ogg/wav/m4a/aac)

Upload folders for /api/storage/upload

• audio: wan27/audio

Rules

• duration must be an integer 2-15 (default 5)
• video_quality, if sent, must be 720p or 1080p
• aspect_ratio, if sent, must be one of 16:9, 9:16, 1:1, 4:3, 3:4

Example request body

{
  "mode": "wan-2.7",
  "generation_type": "text-to-video",
  "prompt": "A paper boat drifting down a rain-soaked city gutter, macro shot",
  "duration": "5",
  "video_quality": "720p",
  "aspect_ratio": "16:9"
}

image-to-video

Animates a start image (optionally to an end frame) into a 2-15 second video with Wan 2.7.

Input files

• image: 1 start-frame image URL (jpg/png/webp, max 20MB)
• images: optional [start, end] pair for first/last-frame interpolation
• audio: optional 1 audio URL

Upload folders for /api/storage/upload

• image: video-generator-wan27
• audio: wan27/audio

Rules

• image (or images[0]) is required
• aspect_ratio is not needed for image-to-video (the output follows the image); if sent it must be one of the listed values
• duration must be an integer 2-15

Example request body

{
  "mode": "wan-2.7",
  "generation_type": "image-to-video",
  "prompt": "Gentle wind moves the hair, camera slowly pushes in",
  "image": "https://example.com/start.jpg",
  "duration": "5",
  "video_quality": "720p"
}

reference-to-video

Generates a video guided by up to 3 reference images and/or up to 3 reference videos with Wan 2.7.

Input files

• images: 0-3 reference image URLs (jpg/png/webp, max 20MB)
• videos: 0-3 reference video URLs (mp4/mov, max 100MB each)

Upload folders for /api/storage/upload

• image: video-generator-wan27
• video: wan27/reference-videos

Rules

• At least one reference image or video is required
• At most 3 reference images and at most 3 reference videos
• duration must be an integer 2-15
• audio and enable_prompt_expansion are not supported for reference-to-video

Example request body

{
  "mode": "wan-2.7",
  "generation_type": "reference-to-video",
  "prompt": "The woman from the reference image walks through a sunflower field",
  "images": [
    "https://example.com/ref.jpg"
  ],
  "duration": "5",
  "video_quality": "720p",
  "aspect_ratio": "16:9",
  "shot_type": "single"
}

text-to-video

Generates a 2-30 second video with optional native audio from a text prompt using Wan 3.0.

Rules

• duration must be an integer 2-30; -1 (smart duration) is rejected
• generate_audio does not change the price

Example request body

{
  "mode": "wan-3.0",
  "generation_type": "text-to-video",
  "prompt": "A drone shot over a misty mountain lake at dawn, birds taking off",
  "duration": "5",
  "video_quality": "720p",
  "aspect_ratio": "adaptive",
  "generate_audio": true
}

image-to-video

Animates a first frame (optionally to a last frame) into a 2-30 second video with Wan 3.0.

Input files

• image: 1 first-frame image URL (jpg/png/webp/bmp/tiff, max 20MB)
• images: optional [first, last] frame pair

Upload folders for /api/storage/upload

• image: wan30

Rules

• image or images is required
• files (document) and links (webpage) cannot be combined with image-to-video
• duration must be an integer 2-30; -1 rejected

Example request body

{
  "mode": "wan-3.0",
  "generation_type": "image-to-video",
  "prompt": "The cat slowly opens its eyes and yawns",
  "image": "https://example.com/first.jpg",
  "images": [
    "https://example.com/first.jpg"
  ],
  "duration": "5",
  "video_quality": "720p",
  "aspect_ratio": "adaptive",
  "generate_audio": true
}

reference-to-video

Generates a 2-30 second video from any mix of reference images, videos, audio, one document (document-to-video) or one webpage (webpage-to-video) with Wan 3.0.

Input files

• images: 0-10 image URLs (jpg/png/webp/bmp/tiff, max 20MB each)
• videos: 0-5 video URLs (mp4/mov, max 100MB each), combined <= 15s
• audio: 0-5 audio URLs via audios (wav/mp3, max 15MB each), combined <= 15s
• files: 0-1 document URL (100MB, 50 pages max)
• links: 0-1 webpage URL

Upload folders for /api/storage/upload

• image: wan30
• video: wan30/reference-videos
• audio: wan30/audio
• document: wan30/documents

Rules

• At most 10 images, 5 videos, 5 audios, 1 file, 1 link (exceeding returns 400, never truncated)
• files and links cannot be sent together
• Provide at least one reference image, video, audio, document or webpage
• input_video_duration must be <= 15, and input_video_duration + duration must be <= 30 (400 otherwise)
• Always pass reference videos in videos (plural) and send input_video_duration equal to their total length (seconds)
• duration must be an integer 2-30; -1 rejected
• When quoting with /api/quote, add has_video_input: true and input_video_duration if you send reference videos (the quote endpoint does not read video URLs, so the price would come out too low).

Example request body

{
  "mode": "wan-3.0",
  "generation_type": "reference-to-video",
  "prompt": "Turn this product page into a 10 second promo video",
  "links": [
    "https://example.com/product"
  ],
  "duration": "10",
  "video_quality": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}

text-to-video

Generates a 4-15 second video from a text prompt with MiniMax H3 (Hailuo 03) at 768P or 2K.

Rules

• duration must be an integer between 4 and 15 (400 otherwise); sent as a string
• Seed, negative prompt and audio options are not supported for this model

Example request body

{
  "mode": "minimax-h3",
  "generation_type": "text-to-video",
  "prompt": "A red fox running through fresh snow at sunrise, cinematic tracking shot",
  "duration": "5",
  "aspect_ratio": "16:9",
  "video_quality": "768p"
}

image-to-video

Animates a first-frame image (optionally toward a last frame) into a 4-15 second MiniMax H3 video at 768P or 2K.

Input files

• image: 1 public image URL used as the first frame (jpg/png/webp, max 20MB)
• images: Optional array [first_frame_url, last_frame_url]; only the first and last entries are used

Upload folders for /api/storage/upload

• image: minimax-h3

Rules

• image-to-video requires image or a non-empty images array (400 'Image is required for image-to-video generation')
• duration must be an integer 4-15
• At most 9 images
• The last frame is taken from the last element of images only when images has 2 or more entries
• Only the first and last images are used, but every image after the 5th is charged: send at most 2. When quoting with /api/quote, send input_image_count.

Example request body

{
  "mode": "minimax-h3",
  "generation_type": "image-to-video",
  "prompt": "The woman turns toward the camera and smiles as wind moves her hair",
  "duration": "5",
  "aspect_ratio": "adaptive",
  "video_quality": "768p",
  "image": "https://example.com/first-frame.jpg",
  "images": [
    "https://example.com/first-frame.jpg"
  ]
}

reference-to-video

Generates a MiniMax H3 video guided by up to 9 reference images, 3 reference videos and 3 reference audio clips.

Input files

• images: 0-9 reference image URLs (jpg/png/webp/bmp/tiff, 20MB each)
• video: 0-3 reference video URLs via 'videos' (mp4/mov, 100MB each, total <= 15s)
• audio: 0-3 reference audio URLs via 'audios' (wav/mp3, 15MB each); cannot be the only reference

Upload folders for /api/storage/upload

• image: minimax-h3
• video: minimax-h3/reference-videos
• audio: minimax-h3/audio

Rules

• At most 9 reference images, 3 reference videos, 3 reference audio files (400 if exceeded, no silent truncation)
• At least one reference image or video is required; reference audio cannot be used alone
• input_video_duration must be <= 15 seconds in total
• Send input_video_duration equal to the total reference video length (seconds) whenever videos are sent
• duration must be an integer 4-15
• When quoting with /api/quote, add has_video_input: true and input_video_duration if you send reference videos (the quote endpoint does not read video URLs, so the price would come out too low). Also send input_image_count (number of reference images).

Example request body

{
  "mode": "minimax-h3",
  "generation_type": "reference-to-video",
  "prompt": "The character from image 1 walks into the room from video 1 and waves",
  "duration": "5",
  "aspect_ratio": "adaptive",
  "video_quality": "768p",
  "images": [
    "https://example.com/character.png"
  ],
  "videos": [
    "https://example.com/room.mp4"
  ],
  "input_video_duration": 6
}

text-to-video

Fast (turbo) MiniMax H3 Max text-to-video, 5-15 seconds at 480P/768P/1080P.

Rules

• generation_type must be text-to-video, image-to-video or reference-to-video for this mode (400 otherwise)
• duration must be an integer between 5 and 15

Example request body

{
  "mode": "minimax-h3-max",
  "generation_type": "text-to-video",
  "prompt": "A paper boat drifting down a rainy city gutter, macro shot",
  "duration": "5",
  "aspect_ratio": "16:9",
  "video_quality": "768p",
  "prompt_expansion_mode": "balanced"
}

image-to-video

Fast MiniMax H3 Max image-to-video from a first frame (optional end frame), 5-15 seconds.

Input files

• image: 1 public image URL used as the first frame
• images: Optional [first_frame_url, end_frame_url]

Upload folders for /api/storage/upload

• image: minimax-h3-max

Rules

• image-to-video requires a first frame (image or images[0]); 400 otherwise
• duration must be an integer 5-15

Example request body

{
  "mode": "minimax-h3-max",
  "generation_type": "image-to-video",
  "prompt": "The camera slowly pushes in as the dog tilts its head",
  "duration": "5",
  "aspect_ratio": "16:9",
  "video_quality": "768p",
  "prompt_expansion_mode": "balanced",
  "image": "https://example.com/dog.jpg",
  "images": [
    "https://example.com/dog.jpg"
  ]
}

reference-to-video

Fast MiniMax H3 Max video guided by reference images, videos and audio (up to 12 files total).

Input files

• images: 0-9 reference image URLs (jpg/png/webp, 20MB, long edge <= 1024 px)
• video: 0-3 reference video URLs via 'videos' (mp4/mov, 100MB each, 2-15s each, total <= 15s)
• audio: 0-3 reference audio URLs via 'audios' (wav/mp3, 15MB each, 2-15s each, total <= 15s); cannot be the only reference

Upload folders for /api/storage/upload

• image: minimax-h3-max
• video: minimax-h3-max/reference-videos
• audio: minimax-h3-max/audio

Rules

• At least one reference image, video or audio is required
• Reference audio cannot be used alone; add at least one image or video
• Max 9 images, 3 videos, 3 audio files, and max 12 files in total
• Reference videos and reference audio each total <= 15s (two separate limits); each clip must be at least 2s
• Send input_video_duration / input_audio_duration equal to the total reference video / audio length (seconds)
• duration must be an integer 5-15
• Resize reference images so the long edge is <= 1024 px
• When quoting with /api/quote, describe the references with input_image_count, has_video_input + input_video_count + input_video_duration, and has_audio_input + input_audio_count + input_audio_duration (the quote endpoint does not read video URLs, so the price would come out too low).

Example request body

{
  "mode": "minimax-h3-max",
  "generation_type": "reference-to-video",
  "prompt": "The product from image 1 rotates on a marble table, soft studio light",
  "duration": "5",
  "aspect_ratio": "adaptive",
  "video_quality": "768p",
  "prompt_expansion_mode": "balanced",
  "images": [
    "https://example.com/product.jpg"
  ]
}

camera-controls

Turns a single image into a 5-15 second video with a scripted camera move (orbit, dolly, crane, etc.) using MiniMax H3 Max.

Input files

• image: Exactly 1 public image URL (source image / first frame); no end frame, no reference videos or audio

Upload folders for /api/storage/upload

• image: minimax-h3-max

Rules

• generation_type must be 'camera-controls' (image-to-video is rejected with 400)
• A source image is required; more than 1 image, any video, or any audio is rejected with 400
• duration must be an integer 5-15
• camera_preset must be one of the 9 preset ids unless camera_trajectory is given
• camera_trajectory: 2-12 keyframes, time in [0,1] strictly increasing, elevation in [-90,90], distance > 0, total azimuth travel <= 11520 degrees
• aspect_ratio has no effect (output follows the source image)

Example request body

{
  "mode": "minimax-h3-max-camera",
  "generation_type": "camera-controls",
  "prompt": "",
  "duration": "5",
  "video_quality": "768p",
  "prompt_expansion_mode": "balanced",
  "image": "https://example.com/statue.jpg",
  "images": [
    "https://example.com/statue.jpg"
  ],
  "camera_preset": "orbit-360"
}

lip-sync

Makes a portrait photo speak in sync with an audio track (5-14.8s) using MiniMax H3 Max; output length follows the audio.

Input files

• image: 1 public portrait image URL (aspect ratio 0.4-2.5)
• audio: 1 public audio URL via 'audios' (wav/mp3/m4a/aac, up to 15MB); at least 5s; audio over 14.8s is clipped to the first 14.8s

Upload folders for /api/storage/upload

• image: minimax-h3-max
• audio: minimax-h3-max/audio

Rules

• generation_type must be 'lip-sync' (400 otherwise)
• Requires one portrait image and one audio track; more than 1 image, more than 1 audio, or any video input is rejected (400)
• Portrait image aspect ratio (width/height) must be between 0.4 and 2.5
• Send input_audio_duration equal to the audio length; it must be at least 5s (400). Audio longer than 14.8s is allowed and clipped
• prompt, duration, aspect_ratio and prompt_expansion_mode have no effect for this mode
• Cannot re-sync an existing video; image-to-video lip sync only
• If the audio turns out longer than the declared input_audio_duration, the difference is charged after generation.

Example request body

{
  "mode": "minimax-h3-max-lip-sync",
  "generation_type": "lip-sync",
  "image": "https://example.com/portrait.jpg",
  "images": [
    "https://example.com/portrait.jpg"
  ],
  "audios": [
    "https://example.com/speech.mp3"
  ],
  "input_audio_duration": 8.4,
  "video_quality": "768p",
  "enable_transcription": true
}

text-to-video

Google Gemini Omni text-to-video with native audio, 4-10s, optionally guided by one reference video.

Input files

• videos: optional, max 1 video URL (mp4/mov, up to 100MB; input video must be <= 30s)

Upload folders for /api/storage/upload

• video: gemini-omni/reference-videos

Rules

• duration must be one of 4, 6, 8, 10 (omitted defaults to 8)
• video_quality (if sent) must be 720p, 1080p or 4k; aspect_ratio (if sent) must be 16:9 or 9:16
• at most 1 video; asset quota images + 2*videos <= 7
• input_video_duration must be <= 30s
• prompt is required, max 20000 characters
• When quoting with /api/quote, add has_video_input: true and input_video_duration if you send a video (the quote endpoint does not read video URLs, so the price would come out too low).

Example request body

{
  "mode": "gemini-omni",
  "generation_type": "text-to-video",
  "prompt": "A golden retriever surfing a wave at sunset, cinematic, with ocean sounds",
  "duration": "8",
  "video_quality": "1080p",
  "aspect_ratio": "16:9"
}

image-to-video

Google Gemini Omni image-to-video: animates up to 7 input images into a 4-10s video with native audio.

Input files

• images: 1-7 image URLs (up to 20MB each)
• videos: optional, max 1 video URL (mp4/mov, <= 30s, up to 100MB)

Upload folders for /api/storage/upload

• image: gemini-omni
• video: gemini-omni/reference-videos

Rules

• image-to-video requires image or a non-empty images
• max 7 images and max 1 video; images + 2*videos <= 7 (so with a video, at most 5 images)
• video_quality must be 720p, 1080p or 4k; aspect_ratio must be 16:9 or 9:16
• input_video_duration must be <= 30s
• same price table as text-to-video
• duration must be 4, 6, 8 or 10, also when a video is supplied (it is then ignored).
• When quoting with /api/quote, add has_video_input: true and input_video_duration if you send a video (the quote endpoint does not read video URLs, so the price would come out too low).

Example request body

{
  "mode": "gemini-omni",
  "generation_type": "image-to-video",
  "prompt": "The woman in the photo turns toward the camera and smiles as wind moves her hair",
  "images": [
    "https://example.com/portrait.jpg"
  ],
  "duration": "6",
  "video_quality": "1080p",
  "aspect_ratio": "9:16"
}

reference-to-video

Google Gemini Omni reference-to-video: generates a video guided by up to 7 reference images and/or 1 reference video.

Input files

• images: 0-7 reference image URLs (up to 20MB each)
• videos: 0-1 reference video URL (mp4/mov, <= 30s; only the first 10s is used)

Upload folders for /api/storage/upload

• image: gemini-omni
• video: gemini-omni/reference-videos

Rules

• at least one reference image or video is required
• reference quota: images <= 7, videos <= 1, images + 2*videos <= 7
• input_video_duration must be <= 30s
• same price table as text-to-video
• duration must be 4, 6, 8 or 10, also when a video is supplied (it is then ignored).
• When quoting with /api/quote, add has_video_input: true and input_video_duration if you send a reference video (the quote endpoint does not read video URLs, so the price would come out too low).

Example request body

{
  "mode": "gemini-omni",
  "generation_type": "reference-to-video",
  "prompt": "The character from the reference images walks through a neon-lit Tokyo street at night",
  "images": [
    "https://example.com/character-front.png",
    "https://example.com/character-side.png"
  ],
  "duration": "8",
  "video_quality": "1080p",
  "aspect_ratio": "16:9"
}

text-to-video

Creatify Boreal text-to-video for ads, UGC and presenter clips with native synced speech, 1-20s, optionally driven by an uploaded audio track.

Input files

• audio: optional, 1 audio URL (.mp3/.ogg/.wav/.m4a/.aac)

Upload folders for /api/storage/upload

• audio: creatify-boreal/audio

Rules

• generation_type must be text-to-video or image-to-video
• duration must be an integer between 1 and 20 (omitted defaults to 10)
• video_quality must be 720p, 1080p, 2k or 2K; aspect_ratio must be auto, 16:9, 9:16, 1:1, 4:3 or 3:4
• prompt is required

Example request body

{
  "mode": "creatify-boreal",
  "generation_type": "text-to-video",
  "prompt": "[VISUAL]\nA young woman holds a can of sparkling water in a sunny kitchen and talks to the camera.\n\n[SPEECH]\n\"This is the only drink I grab after my workout.\"",
  "duration": "10",
  "video_quality": "720p",
  "aspect_ratio": "9:16"
}

image-to-video

Creatify Boreal image-to-video: turns a product or presenter image into an ad/UGC clip with native synced speech, optionally driven by audio.

Input files

• image: 1 image URL
• audio: optional, 1 audio URL (.mp3/.ogg/.wav/.m4a/.aac)

Upload folders for /api/storage/upload

• image: creatify-boreal
• audio: creatify-boreal/audio

Rules

• image-to-video requires image or non-empty images
• duration integer 1-20; video_quality 720p/1080p/2k/2K; aspect_ratio auto/16:9/9:16/1:1/4:3/3:4

Example request body

{
  "mode": "creatify-boreal",
  "generation_type": "image-to-video",
  "prompt": "[VISUAL]\nThe presenter picks up the product and shows it to the camera.\n\n[SPEECH]\n\"Meet the lightest headphones we've ever made.\"",
  "image": "https://example.com/presenter.jpg",
  "duration": "8",
  "video_quality": "1080p",
  "aspect_ratio": "auto"
}

text-to-image

Generates an image from text with Google Nano Banana (or Nano Banana Pro via modelVersion).

Rules

• aspect_ratio: use one of the listed values; with nano-banana-pro, auto produces 1:1.
• Text-to-image does not use images; send images: [] or omit it.
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "nano-banana",
  "generation_type": "text-to-image",
  "prompt": "A beautiful sunset over mountains with golden light",
  "duration": "0",
  "aspect_ratio": "auto",
  "video_quality": "standard",
  "modelVersion": "nano-banana",
  "output_format": "PNG",
  "images": []
}

image-to-image

Edits one or more uploaded images from a text instruction with Google Nano Banana (or Nano Banana Pro).

Input files

• images: 1-10 image URLs; public https URLs or files uploaded with POST /api/storage/upload

Upload folders for /api/storage/upload

• image: image-generator

Rules

• aspect_ratio: use one of the listed values; with nano-banana-pro, auto produces 1:1.
• image-to-image requires a non-empty images array (or image) (400 otherwise).
• Send 1-10 input images.
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "nano-banana-edit",
  "generation_type": "image-to-image",
  "prompt": "Change the background to a blue sky",
  "duration": "0",
  "aspect_ratio": "auto",
  "video_quality": "standard",
  "modelVersion": "nano-banana",
  "output_format": "PNG",
  "images": [
    "https://example.com/input.jpg"
  ]
}

text-to-image

Generates a 1K/2K/4K image from text with Google Nano Banana 2.1.

Rules

• Price by resolution only: 1K = 3 credits, 2K = 5, 4K = 8. Aspect ratio and the number of reference images do not change the price.
• generation_type must be text-to-image or image-to-image (422).
• aspect_ratio must be one of the listed values (400).
• resolution must be 1K, 2K or 4K (422).
• prompt max 5000 characters (400).
• This is a different model from nano-banana-2 (separate mode and price).
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "nano-banana-2-1",
  "generation_type": "text-to-image",
  "prompt": "A minimalist coffee shop poster with the headline \"SLOW MORNINGS\" in bold serif type",
  "duration": "0",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "output_format": "JPEG",
  "images": []
}

image-to-image

Edits/combines up to 10 reference images from a prompt with Google Nano Banana 2.1 at 1K-4K.

Input files

• images: 1-10 reference image URLs

Upload folders for /api/storage/upload

• image: image-generator

Rules

• Price by resolution only: 1K = 3 credits, 2K = 5, 4K = 8. Aspect ratio and the number of reference images do not change the price.
• generation_type must be text-to-image or image-to-image (422).
• aspect_ratio must be one of the listed values (400).
• resolution must be 1K, 2K or 4K (422).
• prompt max 5000 characters (400).
• image-to-image requires a non-empty images array (or image) (400 otherwise).
• Max 10 reference images (400).
• This is a different model from nano-banana-2 (separate mode and price).
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "nano-banana-2-1",
  "generation_type": "image-to-image",
  "prompt": "A minimalist coffee shop poster with the headline \"SLOW MORNINGS\" in bold serif type",
  "duration": "0",
  "aspect_ratio": "auto",
  "resolution": "1K",
  "output_format": "JPEG",
  "images": [
    "https://example.com/ref.jpg"
  ]
}

text-to-image

Generates an image from text with Google Nano Banana 2 (1K-4K).

Rules

• Use one of the listed values.
• aspect_ratio: use one of the listed values.
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "nano-banana-2",
  "generation_type": "text-to-image",
  "prompt": "A beautiful portrait with stunning details",
  "duration": "0",
  "aspect_ratio": "1:1",
  "video_quality": "1K",
  "output_format": "JPG",
  "google_search": false,
  "image_search": false,
  "images": []
}

image-to-image

Edits/combines reference images from a text prompt with Google Nano Banana 2.

Input files

• images: 1-14 reference image URLs

Upload folders for /api/storage/upload

• image: image-generator

Rules

• Use one of the listed values.
• aspect_ratio: use one of the listed values.
• image-to-image requires a non-empty images array (or image) (400 otherwise).
• Send 1-14 reference images.
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "nano-banana-2",
  "generation_type": "image-to-image",
  "prompt": "A beautiful portrait with stunning details",
  "duration": "0",
  "aspect_ratio": "match_input_image",
  "video_quality": "1K",
  "output_format": "JPG",
  "google_search": false,
  "image_search": false,
  "images": [
    "https://example.com/ref.jpg"
  ]
}

text-to-image

Generates an image from text with Flux Kontext (Flux 1 or Flux 2, Pro or Max).

Rules

• aspect_ratio: use a value supported by the selected fluxModelVersion.
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "flux-kontext",
  "generation_type": "text-to-image",
  "prompt": "Serene mountain landscape at sunset with lake reflection",
  "duration": "0",
  "aspect_ratio": "16:9",
  "video_quality": "1K",
  "fluxModel": "flux-kontext-pro",
  "fluxModelVersion": "flux1",
  "fluxResolution": "1K",
  "promptUpsampling": false,
  "enableTranslation": true,
  "output_format": "PNG"
}

image-to-image

Edits an image (or up to 8 references with Flux 2) from a text instruction with Flux Kontext.

Input files

• image: 1 image URL (flux1)
• images: 1-8 image URLs (flux2 only)

Upload folders for /api/storage/upload

• image: flux-kontext

Rules

• aspect_ratio: use a value supported by the selected fluxModelVersion.
• image-to-image requires a non-empty images array (or image) (400 otherwise).
• flux1 uses only the single input image in image; flux2 accepts up to 8 reference images in images.
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "flux-kontext",
  "generation_type": "image-to-image",
  "prompt": "Serene mountain landscape at sunset with lake reflection",
  "duration": "0",
  "aspect_ratio": "16:9",
  "video_quality": "1K",
  "fluxModel": "flux-kontext-pro",
  "fluxModelVersion": "flux1",
  "fluxResolution": "1K",
  "promptUpsampling": false,
  "enableTranslation": true,
  "output_format": "PNG",
  "image": "https://example.com/input.jpg"
}

text-to-image

Generates a native 1K/2K/4K image from text with FLUX 3.

Rules

• generation_type must be text-to-image or image-to-image (422).
• aspect_ratio must be one of the 14 listed values (400). Always send aspect_ratio.
• resolution must be 1K, 2K or 4K (422).
• prompt max 5000 characters (400).
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "flux-3-image",
  "generation_type": "text-to-image",
  "prompt": "A bakery storefront at golden hour with a hand-painted sign that reads \"Morning Loaf\"",
  "duration": "0",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "output_format": "JPEG",
  "images": []
}

image-to-image

Edits/combines up to 10 reference images from a prompt with FLUX 3 at 1K-4K.

Input files

• images: 1-10 reference image URLs

Upload folders for /api/storage/upload

• image: image-generator

Rules

• generation_type must be text-to-image or image-to-image (422).
• aspect_ratio must be one of the 14 listed values (400). Always send aspect_ratio.
• resolution must be 1K, 2K or 4K (422).
• prompt max 5000 characters (400).
• image-to-image requires a non-empty images array (or image) (400 otherwise).
• Max 10 reference images (400); references do not change the price.
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "flux-3-image",
  "generation_type": "image-to-image",
  "prompt": "A bakery storefront at golden hour with a hand-painted sign that reads \"Morning Loaf\"",
  "duration": "0",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "output_format": "JPEG",
  "images": [
    "https://example.com/ref.jpg"
  ]
}

text-to-image

Generates HD images (optionally a batch) from text with Seedream 5.0 Lite.

Rules

• Set max_images > 1 only with sequential_image_generation='auto'.
• If a batch returns fewer images than requested, unused credits are refunded automatically.
• Always send aspect_ratio, using one of the listed values.
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field. Batch results appear in result_images.

Example request body

{
  "mode": "seedream-5.0-lite",
  "generation_type": "text-to-image",
  "prompt": "A cozy reading nook with warm light",
  "duration": "0",
  "aspect_ratio": "1:1",
  "video_quality": "2K",
  "output_format": "PNG",
  "sequential_image_generation": "disabled",
  "max_images": 1,
  "images": []
}

image-to-image

Edits/blends reference images into new HD images (optionally a batch) with Seedream 5.0 Lite.

Input files

• images: 1-14 reference image URLs

Upload folders for /api/storage/upload

• image: image-generator

Rules

• Set max_images > 1 only with sequential_image_generation='auto'.
• If a batch returns fewer images than requested, unused credits are refunded automatically.
• Always send aspect_ratio, using one of the listed values.
• image-to-image requires a non-empty images array (or image) (400 otherwise).
• Send 1-14 reference images.
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field. Batch results appear in result_images.

Example request body

{
  "mode": "seedream-5.0-lite",
  "generation_type": "image-to-image",
  "prompt": "A cozy reading nook with warm light",
  "duration": "0",
  "aspect_ratio": "match_input_image",
  "video_quality": "2K",
  "output_format": "PNG",
  "sequential_image_generation": "disabled",
  "max_images": 1,
  "images": [
    "https://example.com/ref.jpg"
  ]
}

text-to-image

Generates images with dense text and infographics from a prompt with Seedream 5.0 Pro.

Rules

• aspect_ratio must be one of 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 (400). Always send aspect_ratio.
• resolution must be 1K or 2K (422).
• prompt max 5000 characters (400).
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "seedream-5.0-pro",
  "generation_type": "text-to-image",
  "prompt": "An infographic poster explaining the water cycle with labeled arrows",
  "duration": "0",
  "aspect_ratio": "1:1",
  "video_quality": "1K",
  "resolution": "1K",
  "output_format": "PNG",
  "images": []
}

image-to-image

Precision-edits up to 10 reference images from a prompt with Seedream 5.0 Pro.

Input files

• images: 1-10 reference image URLs

Upload folders for /api/storage/upload

• image: image-generator

Rules

• aspect_ratio must be one of 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 (400). Always send aspect_ratio.
• resolution must be 1K or 2K (422).
• prompt max 5000 characters (400).
• image-to-image requires a non-empty images array (or image) (400 otherwise).
• Max 10 reference images (400).
• Asynchronous: the response is {generation_id, status:'processing', image_url:null, video_url:null, video_quality}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is then in video_url and all output images are in result_images (array). The status response has no image_url field.
• When quoting with /api/quote, send input_image_count (the number of images) — the quote does not count the images array for this model, so it would come out too low.

Example request body

{
  "mode": "seedream-5.0-pro",
  "generation_type": "image-to-image",
  "prompt": "An infographic poster explaining the water cycle with labeled arrows",
  "duration": "0",
  "aspect_ratio": "1:1",
  "video_quality": "1K",
  "resolution": "1K",
  "output_format": "PNG",
  "images": [
    "https://example.com/ref.jpg"
  ]
}

text-to-image

Fast, low-cost text-to-image up to 2K with Seedream 5.0 Flash.

Rules

• generation_type must be text-to-image or image-to-image (422).
• aspect_ratio must be one of 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 (400). Always send aspect_ratio explicitly.
• resolution must be 1K, 1.5K or 2K (422).
• prompt max 5000 characters (400).
• Asynchronous: POST returns {generation_id, status:'processing'}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "seedream-5.0-flash",
  "generation_type": "text-to-image",
  "prompt": "A cozy coffee shop interior at golden hour, warm light through large windows",
  "duration": "0",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "output_format": "PNG",
  "images": []
}

image-to-image

Fast, low-cost edits of up to 10 reference images up to 2K with Seedream 5.0 Flash.

Input files

• images: 1-10 reference image URLs.

Upload folders for /api/storage/upload

• image: image-generator

Rules

• generation_type must be text-to-image or image-to-image (422).
• aspect_ratio must be one of 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9 (400). Always send aspect_ratio explicitly.
• resolution must be 1K, 1.5K or 2K (422).
• prompt max 5000 characters (400).
• image-to-image requires a non-empty images array (or image) (400).
• At most 10 reference images (400).
• Asynchronous: POST returns {generation_id, status:'processing'}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is in video_url and all output images are in result_images (array). The status response has no image_url field.

Example request body

{
  "mode": "seedream-5.0-flash",
  "generation_type": "image-to-image",
  "prompt": "A cozy coffee shop interior at golden hour, warm light through large windows",
  "duration": "0",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "output_format": "PNG",
  "images": [
    "https://example.com/ref.jpg"
  ]
}

text-to-image

Generates 1-8 images with accurate in-image text from a prompt with Ideogram 4.5.

Rules

• Credits for images that are not delivered are refunded automatically.
• generation_type must be text-to-image or image-to-image.
• prompt required, max 10000 characters (422).
• num_images must be an integer 1-8 (422).
• resolution must be valid for the chosen aspect_ratio (422).
• text-to-image must not include images (422); edit_precision and mask_url are rejected (422).
• aspect_ratio auto is not allowed for text-to-image.
• Asynchronous: POST returns {generation_id, status:'processing'}. Poll GET /api/video-generation/{generation_id}/status until status='completed'; the first image URL is in video_url and all output images are in result_images (array). The status response has no image_url field. With num_images > 1, all images are in result_images.

Example request body

{
  "mode": "ideogram-4-5",
  "generation_type": "text-to-image",
  "prompt": "A vintage travel poster with the bold title \"VISIT LISBON\" and a yellow tram",
  "duration": "0",
  "quality": "low",
  "num_images": 1,
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "enable_prompt_expansion": true
}

image-to-image

Edits an image (optionally with a mask and reference images) with accurate text rendering via Ideogram 4.5.