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

NameTypeDetails
promptrequiredstring

The text prompt used to generate the video

first_framearray 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_framearray 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_imagesarray 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_videosarray 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_audiosarray 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_ratiostring

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: auto

One of: auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

resolutionstring

Video resolution - 480p for faster generation, 720p for balance.

Default: 480p

One of: 480p, 720p

duration_secondsnumber

Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt.

Default: auto

One of: auto, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

generate_audioboolean

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: true