Video & materi
Dapatkan Tugas (Kompatibel dengan Volc)
Dapatkan tugas kompatibilitas Seedance berdasarkan ID tugas cgt-nya.
Gambaran Umum
Gunakan ID cgt-... yang dikembalikan oleh create. Lakukan polling setiap beberapa detik selama status tugas adalah queued atau running. Berhenti ketika status tugas adalah succeeded, failed, cancelled, atau expired.
Jangan gunakan kembali enum tugas atau struct respons v1 terpadu di sini. /v1/tasks/{id} menggunakan pending, processing, completed, dan failed; endpoint v3 ini menggunakan enum resmi di atas. Dalam objek JSON v3, duration adalah string jika ada dan error bersifat opsional serta berisi detail kesalahan jika tersedia. Klien Go yang ketat harus mendeklarasikan Duration sebagai string dengan tag JSON duration,omitempty, dan berhenti pada setiap status terminal v3.
Lihat juga Model Video Seedance 2.0 dan Pembuatan Video.
Nilai Status
queued: diterima dan menunggu untuk dijalankan.running: pembuatan sedang berlangsung.succeeded: hasil sudah siap dancontent.video_urltersedia.failed: pembuatan gagal; periksaerror.codedanerror.message.cancelled: tugas dibatalkan sebelum selesai.expired: tugas kedaluwarsa sebelum selesai.
Bidang Respons
id: ID tugas kompatibilitas, dimulai dengancgt-.model: nilaimodelyang Anda kirim saat membuat tugas.status: salah satu nilai status di atas.content.video_url: URL video akhir saat berhasil. Ini adalah tautan hasil TokenLab yang tetap valid selama 30 hari; lihat Retensi data.content.last_frame_url: hanya ada saat diminta dan tersedia.usage:completion_tokensdantotal_tokenssaat tersedia, ditambahtool_usage.web_searchsaat alat pencarian web dijalankan.created_atdanupdated_at: Unix timestamp dalam detik.error:{ code, message }saat detail kesalahan tersedia. Jangan menyimpulkan keberadaannya hanya daristatus.- Nilai permintaan yang ditetapkan untuk tugas akan ditampilkan kembali saat tersedia:
seed,resolution,ratio,duration(string),generate_audio,service_tier,execution_expires_after,safety_identifier,tools,draft,draft_task_id,frames, danframespersecond.
Respons tidak pernah menambahkan bidang TokenLab seperti progress, return_last_frame, watermark, priority, atau camera_fixed.
ID tugas yang tidak diketahui atau kedaluwarsa akan mengembalikan 404; ID yang dimiliki oleh organisasi lain akan mengembalikan 403.
Contoh
curl https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
-H "Authorization: Bearer $TOKENLAB_API_KEY"{
"id": "cgt-20260102030405-a1b2c",
"model": "seedance-2.0",
"status": "succeeded",
"content": {
"video_url": "https://api.tokenlab.sh/v1/media-results/3f2b8c1e-6d4a-4e9b-8a7c-2d5e1f0b9c4a.mp4?token=…"
},
"usage": {
"completion_tokens": 123456
}
}type SeedanceTask struct {
ID string `json:"id"`
Status string `json:"status"`
Duration string `json:"duration,omitempty"`
}
func isTerminal(status string) bool {
switch status {
case "succeeded", "failed", "cancelled", "expired":
return true
default:
return false
}
}curl -X GET "https://example.com/api/v3/contents/generations/tasks/string"{ "id": "string", "model": "string", "status": "queued", "content": { "video_url": "http://example.com", "last_frame_url": "http://example.com" }, "seed": 0, "resolution": "string", "ratio": "string", "duration": "string", "frames": 0, "framespersecond": 0, "generate_audio": true, "tools": { "type": "web_search" }, "safety_identifier": "string", "draft": true, "draft_task_id": "string", "service_tier": "string", "execution_expires_after": 0, "usage": { "completion_tokens": 0, "total_tokens": 0, "tool_usage": { "web_search": 0 } }, "error": { "code": "string", "message": "string" }, "created_at": 0, "updated_at": 0}Otorisasi
BearerAuth Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Lokasi: header
Parameter path
ID tugas kompatibilitas yang dikembalikan oleh endpoint pembuatan. ID dimulai dengan cgt-.
Respons
application/json
application/json
application/json
application/json
application/json
application/json