# Seedance 2.0 Mini Reference-to-Video Multimodal reference-to-video with ByteDance Seedance 2.0 Mini on E2X ($0.045/s 480p, $0.09/s 720p, 25% off). Pass up to 9 images, 3 videos, and 3 audio tracks. ## API Information - **Provider:** bytedance - **Model Slug:** bytedance/seedance-2.0-mini/reference-to-video - **Category:** reference-to-video - **Status:** active - **Base Cost:** $0.045 per second - **List Price:** $0.06 per second - **Active Discount:** 25% off — already reflected in Base Cost above - **Estimated Processing Time:** 160 seconds ## Input Schema | Parameter | Type | Required | Default | Constraints | Description | |-----------|------|----------|---------|-------------|-------------| | prompt | string | Yes | - | max 50000 chars | Use @Image1..@Image9, @Video1..@Video3, @Audio1..@Audio3 placeholders to reference uploaded media | | reference_urls | array | No | - | items: 0-9 | Reference images (max 9) — use @Image1..@Image9 in prompt | | reference_video_urls | array | No | - | items: 0-3 | Reference video clips (max 3) — use @Video1..@Video3 in prompt | | reference_audio_urls | array | No | - | items: 0-3 | Reference audio tracks (max 3) — use @Audio1..@Audio3 in prompt | | aspect_ratio | string | No | 16:9 | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | - | | resolution | string | No | 720p | 480p, 720p | Resolution | | duration | string | No | 5 | 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 | Duration (seconds) | | has_sound | boolean | No | true | - | - | | seed | integer | No | - | min: 0 | - | ### Parameter Details #### `prompt` - Type: `string` - Required: Yes - Description: Use @Image1..@Image9, @Video1..@Video3, @Audio1..@Audio3 placeholders to reference uploaded media #### `reference_urls` - Type: `array` - Required: No - Description: Reference images (max 9) — use @Image1..@Image9 in prompt #### `reference_video_urls` - Type: `array` - Required: No - Description: Reference video clips (max 3) — use @Video1..@Video3 in prompt #### `reference_audio_urls` - Type: `array` - Required: No - Description: Reference audio tracks (max 3) — use @Audio1..@Audio3 in prompt #### `resolution` - Type: `string` - Required: No - Description: Resolution #### `duration` - Type: `string` - Required: No - Description: Duration (seconds) ## Required Parameters Example ```bash curl -X POST https://api.e2x.ai/v1/jobs/submit \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "bytedance/seedance-2.0-mini/reference-to-video", "input": { "prompt": "Describe the scene in detail" } }' ``` ## Full Example ```bash curl -X POST https://api.e2x.ai/v1/jobs/submit \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "bytedance/seedance-2.0-mini/reference-to-video", "input": { "prompt": "Describe the scene in detail", "reference_urls": [ "https://example.com/reference-urls-item" ], "reference_video_urls": [ "https://example.com/reference-video-urls-item" ], "reference_audio_urls": [ "https://example.com/reference-audio-urls-item" ], "aspect_ratio": "16:9", "resolution": "720p", "duration": "5", "has_sound": true, "seed": 0 } }' ``` ## JavaScript Fetch Example ```javascript const response = await fetch('https://api.e2x.ai/v1/jobs/submit', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ "model": "bytedance/seedance-2.0-mini/reference-to-video", "input": { "prompt": "Describe the scene in detail", "reference_urls": [ "https://example.com/reference-urls-item" ], "reference_video_urls": [ "https://example.com/reference-video-urls-item" ], "reference_audio_urls": [ "https://example.com/reference-audio-urls-item" ], "aspect_ratio": "16:9", "resolution": "720p", "duration": "5", "has_sound": true, "seed": 0 } }) }); const result = await response.json(); console.log(result); ``` ## Output Schema ```json {} ``` ## Job Polling After submitting, poll for the job status: ```bash curl https://api.e2x.ai/v1/jobs/{JOB_ID} \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Status Values | Status | Description | |--------|-------------| | `pending` | Job submitted, waiting in queue | | `processing` | Job is being processed by a worker | | `completed` | Job finished - check `data.outputs[0].url` | | `failed` | Job failed - check `data.error.message` | | `cancelled` | Job was cancelled | ### Python Polling Example ```python import time, requests job_id = submit_response.json()["data"]["jobId"] while True: resp = requests.get(f"https://api.e2x.ai/v1/jobs/{job_id}", headers={"Authorization": "Bearer YOUR_API_KEY"}) data = resp.json()["data"] if data["status"] == "completed": print("Done!", data["outputs"][0]["url"]) break elif data["status"] == "failed": raise Exception(f"Job failed: {data['error']['message']}") time.sleep(2) ``` ## Usage Notes - All monetary values are in micro-cents (1,000,000 = $1 USD) - For structured parameters such as `elements` or `shots`, send real JSON arrays/objects, not quoted strings. - Use `webhookUrl` parameter in your submit request to receive completion callbacks instead of polling - API Base URL: `https://api.e2x.ai/v1`