API docs / Video models
Seedance 2.0 Mini (Text to video) API
Draft the whole shot from a prompt, with native audio, at Mini prices.
- Model id
bytedance/seedance-2.0/mini/text-to-video- Provider
- ByteDance
- Output
- Video
- Price
- From 377 credits per run, the same as on voor.ai. Options such as length or resolution can change it.
Request
POST https://voor.ai/v1/generations with "model": "bytedance/seedance-2.0/mini/text-to-video". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.
curl https://voor.ai/v1/generations \
-H "Authorization: Bearer $VOOR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "bytedance/seedance-2.0/mini/text-to-video",
"input": {
"prompt": "A red fox standing in fresh snow at golden hour, soft light"
},
"callback_url": "https://example.com/webhooks/voor"
}'
# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
-H "Authorization: Bearer $VOOR_API_KEY"Input parameters
| Name | Type | Details |
|---|---|---|
promptrequired | string | The text prompt used to generate the video |
first_frame | array of URLs | The URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP. Max 30 MB. Each file: up to 30 MB. Up to 1 files · Accepts image/* |
last_frame | array of URLs | The URL of the image to use as the last frame of the video. When provided, the generated video will transition from the starting image to this ending image. Supported formats: JPEG, PNG, WebP. Max 30 MB. Each file: up to 30 MB. Up to 1 files · Accepts image/* |
reference_images | array of URLs | Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPEG, PNG, WebP. Max 30 MB per image. Up to 9 images. Total files across all modalities must not exceed 12. Each file: up to 30 MB. Upload up to 9 reference images. They are numbered in upload order and can be inserted into the prompt as @image1, @image2, and so on. Up to 9 files · Accepts image/* |
reference_videos | array of URLs | Reference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 3 videos, combined duration must be between 2 and 15 seconds, total size under 50 MB. Each video must be between ~480p (640x640) and ~720p (834x1112) in resolution. Combined duration: 2–15s. Combined size: under 50 MB. Upload up to 3 reference videos. They are numbered in upload order and can be inserted into the prompt as @video1, @video2, and so on. Up to 3 files · Accepts video/* |
reference_audios | array of URLs | Reference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 3 files, combined duration must not exceed 15 seconds. Max 15 MB per file.If audio is provided, at least one reference image or video is required. Combined duration: up to 15s. Each file: up to 15 MB. Upload up to 3 reference audio files. They are numbered in upload order and can be inserted into the prompt as @audio1, @audio2, and so on. Up to 3 files · Accepts audio/* |
aspect_ratio | string | The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide. Default: One of: auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
resolution | string | Video resolution - 480p for faster generation, 720p for balance. Default: One of: 480p, 720p |
duration_seconds | number | Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. Default: One of: auto, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
generate_audio | boolean | Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not. Default: |