Video ve materyaller
Görevi Al (Volc Uyumlu)
Bir Seedance uyumluluk görevini cgt görev kimliği ile alın.
Genel Bakış
create tarafından döndürülen cgt-... kimliğini kullanın. Görev queued veya running durumundayken birkaç saniyede bir yoklama (poll) yapın. Görev succeeded, failed, cancelled veya expired durumuna geldiğinde durun.
Burada birleştirilmiş v1 görev enum veya yanıt yapısını yeniden kullanmayın. /v1/tasks/{id} uç noktası pending, processing, completed ve failed kullanır; bu v3 uç noktası ise yukarıdaki resmi enum değerlerini kullanır. v3 JSON nesnesinde duration mevcut olduğunda bir string'dir ve error isteğe bağlıdır; mevcut olduğunda hata detaylarını içerir. Katı bir Go istemcisi, Duration değerini duration,omitempty JSON etiketiyle string olarak tanımlamalı ve her v3 terminal durumunda durmalıdır.
Ayrıca bkz: Seedance 2.0 Video Modelleri ve Video Oluşturma.
Durum Değerleri
queued: kabul edildi ve çalıştırılmayı bekliyor.running: oluşturma işlemi devam ediyor.succeeded: sonuç hazır vecontent.video_urlmevcut.failed: oluşturma başarısız oldu;error.codeveerror.messagealanlarını inceleyin.cancelled: görev tamamlanmadan önce iptal edildi.expired: görev tamamlanmadan önce zaman aşımına uğradı.
Yanıt Alanları
id:cgt-ile başlayan uyumluluk görev kimliği.model: görevi oluştururken gönderdiğinizmodeldeğeri.status: yukarıdaki durum değerlerinden biri.content.video_url: başarı durumunda nihai video URL'si. Bu, 30 gün boyunca geçerli kalan bir TokenLab sonuç bağlantısıdır; bkz: Veri saklama.content.last_frame_url: yalnızca talep edildiğinde ve mevcut olduğunda bulunur.usage: mevcut olduğundacompletion_tokensvetotal_tokens, ayrıca web arama aracı çalıştığındatool_usage.web_search.created_atveupdated_at: saniye cinsinden Unix zaman damgaları.error: hata detayları mevcut olduğunda{ code, message }. Varlığını yalnızcastatusdeğerine bakarak tahmin etmeyin.- Görev için ayarlanan istek değerleri mevcut olduğunda yansıtılır:
seed,resolution,ratio,duration(string),generate_audio,service_tier,execution_expires_after,safety_identifier,tools,draft,draft_task_id,framesveframespersecond.
Yanıt, progress, return_last_frame, watermark, priority veya camera_fixed gibi TokenLab alanlarını asla eklemez.
Bilinmeyen veya süresi dolmuş bir görev kimliği 404 döndürür; başka bir organizasyona ait bir kimlik 403 döndürür.
Örnek
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}Yetkilendirme
BearerAuth API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Yol parametreleri
Oluşturma uç noktası tarafından döndürülen uyumluluk görevi kimliği. Kimlikler cgt- ile başlar.
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json