Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Highest-quality video generation with omni-reference support. See supported inputs, parameters, pricing, response fields, and API examples.
bytedance/seedance-2.0-pro
| Request type | Required inputs | Optional inputs | Notes |
|---|---|---|---|
| Text-to-video | prompt | aspect_ratio, duration, resolution, generate_audio, seed | No frame or reference URLs |
| First/last frame | At least one of first_frame_url or last_frame_url | prompt, duration, resolution, generate_audio, seed | prompt optional when a frame URL is set. Provide first_frame_url, last_frame_url, or both |
| Omni-reference | prompt, at least one of image_urls or video_urls | video_urls, audio_urls, duration, resolution, generate_audio, seed | Reference assets in prompt as @Image1..@Image9, @Video1..@Video3, @Audio1..@Audio3. audio_urls requires at least one image_urls or video_urls entry |
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Conditional | "" | Text prompt (max 5000 chars). Required for text-only requests and when image_urls, video_urls, or audio_urls are present. Optional when a frame URL is set. Reference assets as @Image1..@Image9, @Video1..@Video3, @Audio1..@Audio3 |
aspect_ratio | string | No | "adaptive" | adaptive, 1:1, 3:4, 4:3, 9:16, 16:9, 21:9 |
duration | integer | No | 4 | Output duration in seconds (4–15). Sent to provider as frames = 24 × seconds + 1 (97–361) |
resolution | string | No | "480p" | 480p, 720p, 1080p, 4k |
generate_audio | boolean | No | true | Whether to generate synchronized audio for the output video |
seed | integer | No | — | Seed for reproducibility. Omit for a random seed. |
first_frame_url | string | No | null | First frame image URL. Formats: png, webp, jpeg, gif. Max 30 MB. Dimensions: 300–6000 px (short side). Aspect ratio: 0.4–2.5 |
last_frame_url | string | No | null | Last frame image URL. Same format/size constraints as first_frame_url |
image_urls | string[] | No | null | Reference image URLs (max 9). Formats: png, webp, jpeg, jpg, gif. Max 30 MB each. Dimensions: 300–6000 px. Aspect ratio: 0.4–2.5. Reference as @Image1, @Image2, … |
video_urls | string[] | No | null | Reference video URLs (max 3). Formats: mp4, mov. Max 50 MB each. Duration: 2.0–15.2 s per clip, combined total ≤ 15.2 s. Resolution: 480p–1080p. Dimensions: 300–6000 px. Aspect ratio: 0.4–2.5. Reference as @Video1, @Video2, … |
audio_urls | string[] | No | null | Reference audio URLs (max 3). Requires at least one image_urls or video_urls entry. Formats: wav, mp3. Max 15 MB each. Duration: 2–15 s per clip, combined total ≤ 15 s. Reference as @Audio1, @Audio2, … |
nsfw_check | boolean | No | true | Check uploaded media inputs for NSFW content |
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "bytedance/seedance-2.0-pro",
"input": {
"prompt": "Cinematic slow-motion shot of a dancer performing on a rain-soaked stage",
"aspect_ratio": "16:9",
"duration": 10,
"resolution": "1080p"
}
}'
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "bytedance/seedance-2.0-pro",
"input": {
"prompt": "The car accelerates and drives away into the sunset",
"duration": 12,
"first_frame_url": "https://example.com/start.jpg",
"last_frame_url": "https://example.com/end.jpg"
}
}'
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "bytedance/seedance-2.0-pro",
"input": {
"prompt": "Make @Image1 come alive in the style of @Video1",
"duration": 8,
"image_urls": [
"https://example.com/portrait.jpg"
],
"video_urls": [
"https://example.com/animation-style.mp4"
]
}
}'
@Image1, first video = @Video1, first audio = @Audio1, etc. Images, videos, and audio are numbered independently.
{
"code": 200,
"success": true,
"data": {
"task_id": "abc123def456",
"status": "processing"
}
}