Referensi API
Gambar ke video
Buat video dari gambar dan media referensi dengan Seedance 2.0 Open API.
Dalam mode ini, Anda mengirim satu atau lebih URL media publik melalui mediaUrls.
Endpoint
POST /api/open/v1/video/generationsJenis referensi yang didukung
| Type | Common formats | Typical usage |
|---|---|---|
| Gambar | .jpg, .jpeg, .png, .webp, .gif, .bmp | Frame awal, frame akhir, referensi gaya |
| Video | .mp4, .mov, .m4v | Referensi gerakan dan kamera |
| Audio | .mp3, .wav | Referensi ritme atau timing |
Contoh request
curl --request POST \
--url https://www.seedance2.ink/api/open/v1/video/generations \
--header 'Authorization: Bearer sd2_live_your_api_key' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2.0",
"prompt": "A young woman blows out birthday candles, warm indoor lighting, shallow depth of field",
"mediaUrls": [
"https://example.com/photo.jpg"
],
"aspectRatio": "16:9",
"duration": 5,
"resolution": "720p"
}'Response sukses
{
"success": true,
"requestId": "req_1234567890",
"status": "queued",
"creditsCharged": 64
}Field request
| Field | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Salah satu dari seedance-2.0, seedance-2.0-fast, seedance-1.5-pro. |
prompt | string | Yes | Prompt bahasa alami yang menjelaskan video target. |
mediaUrls | string[] | Yes | Satu hingga lima URL media referensi publik. |
aspectRatio | string | No | Salah satu dari 16:9, 9:16, 1:1. |
duration | integer | No | seedance-2.0 dan seedance-2.0-fast mendukung 4-15 detik; seedance-1.5-pro mendukung 5 atau 10 detik. |
resolution | string | No | Salah satu dari 480p, 720p, 1080p. |
webhookUrl | string | No | URL callback yang menerima hasil akhir. |
metadata | object | No | Metadata kustom yang disimpan bersama request. |
Memeriksa hasil
curl https://www.seedance2.ink/api/open/v1/video/generations/req_1234567890 \
--header 'Authorization: Bearer sd2_live_your_api_key'{
"success": true,
"requestId": "req_1234567890",
"status": "succeeded",
"model": "seedance-2.0",
"prompt": "A river flowing through an autumn forest, aerial view, cinematic motion",
"duration": 5,
"aspectRatio": "16:9",
"output": {
"type": "video",
"url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
},
"error": null
}Batalkan job
curl --request POST \
--url https://www.seedance2.ink/api/open/v1/video/generations/req_1234567890/cancel \
--header 'Authorization: Bearer sd2_live_your_api_key'{
"success": true,
"requestId": "req_1234567890",
"status": "cancelled"
}Catatan
mediaUrlsmendukung hingga5item.- Gunakan URL HTTPS publik yang dapat diakses.
- Jika Anda tidak membutuhkan media referensi, gunakan Teks ke video.