Panduan Cepat API
Buat dan periksa pembuatan gambar-ke-video.
1. Atur kredensial
export SEEDANCE_BASE_URL="https://api.seedance2video.io/v1"
export SEEDANCE_API_KEY="sd_live_replace_me"Simpan Key hanya di pengelola secret sisi server atau n8n Credential.
2. Buat generasi
Host input harus disetujui untuk API Key Anda sebelum digunakan.
curl --request POST "$SEEDANCE_BASE_URL/videos" \
--header "Authorization: Bearer $SEEDANCE_API_KEY" \
--header "Idempotency-Key: order-10086-shot-1" \
--header "Content-Type: application/json" \
--data '{
"model": "seedance-2.0-pro",
"mode": "image-to-video",
"prompt": "Subjek perlahan berbalik menghadap kamera.",
"inputs": [{
"type": "image",
"url": "https://media.example.com/reference.png"
}],
"parameters": {
"duration_seconds": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}'API mengembalikan 202 Accepted dengan id, status, status_url, dan billing.cost_credits. Penagihan menggunakan perhitungan dan urutan konsumsi kredit yang sama dengan PC.
3. Periksa generasi yang sama
curl "$SEEDANCE_BASE_URL/generations/GENERATION_ID" \
--header "Authorization: Bearer $SEEDANCE_API_KEY"Patuhi retry_after_seconds atau header Retry-After. Lanjutkan pemeriksaan selama status queued atau processing.
4. Baca URL hasil
{
"status": "completed",
"output": {
"urls": ["https://.../completed-video.mp4"],
"video_url": "https://.../completed-video.mp4"
},
"billing": {
"unit": "credits",
"cost_credits": 355,
"policy": "same_as_pc"
}
}Jika permintaan pembuatan mengalami timeout, coba lagi dengan body dan Idempotency-Key yang persis sama. Jangan otomatis membuat permintaan baru dengan Key baru.