Video & Materialien
Task abrufen (Volc-kompatibel)
Ruft eine Seedance-kompatible Aufgabe über ihre cgt-Aufgaben-ID ab.
Übersicht
Verwenden Sie die cgt-... ID, die bei der Erstellung zurückgegeben wurde. Pollen Sie alle paar Sekunden, solange die Aufgabe den Status queued oder running hat. Stoppen Sie, wenn die Aufgabe succeeded, failed, cancelled oder expired ist.
Verwenden Sie hier nicht das vereinheitlichte v1-Aufgaben-Enum oder die Response-Struktur. /v1/tasks/{id} verwendet pending, processing, completed und failed; dieser v3-Endpunkt verwendet das oben genannte offizielle Enum. Im v3-JSON-Objekt ist duration ein String, sofern vorhanden, und error ist optional und enthält Fehlerdetails, falls verfügbar. Ein strikter Go-Client sollte Duration als string mit dem JSON-Tag duration,omitempty deklarieren und bei jedem v3-Terminalstatus stoppen.
Siehe auch Seedance 2.0 Videomodelle und Videogenerierung.
Statuswerte
queued: akzeptiert und wartet auf Ausführung.running: Generierung läuft.succeeded: Ergebnis ist bereit undcontent.video_urlist vorhanden.failed: Generierung fehlgeschlagen; prüfen Sieerror.codeunderror.message.cancelled: die Aufgabe wurde vor Abschluss abgebrochen.expired: die Aufgabe ist vor Abschluss abgelaufen.
Antwortfelder
id: Kompatibilitäts-Aufgaben-ID, beginnend mitcgt-.model: dermodel-Wert, den Sie bei der Erstellung der Aufgabe gesendet haben.status: einer der oben genannten Statuswerte.content.video_url: finale Video-URL bei Erfolg. Es handelt sich um einen TokenLab-Ergebnislink, der 30 Tage lang gültig bleibt; siehe Datenaufbewahrung.content.last_frame_url: nur vorhanden, wenn angefordert und verfügbar.usage:completion_tokensundtotal_tokens, falls verfügbar, sowietool_usage.web_search, wenn das Web-Such-Tool ausgeführt wurde.created_atundupdated_at: Unix-Zeitstempel in Sekunden.error:{ code, message }, wenn Fehlerdetails verfügbar sind. Schließen Sie nicht allein aus demstatusauf dessen Vorhandensein.- Die für die Aufgabe gesetzten Anfragewerte werden bei Verfügbarkeit wiederholt:
seed,resolution,ratio,duration(String),generate_audio,service_tier,execution_expires_after,safety_identifier,tools,draft,draft_task_id,framesundframespersecond.
Die Antwort fügt niemals TokenLab-Felder wie progress, return_last_frame, watermark, priority oder camera_fixed hinzu.
Eine unbekannte oder abgelaufene Aufgaben-ID gibt 404 zurück; eine ID, die zu einer anderen Organisation gehört, gibt 403 zurück.
Beispiel
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}Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Pfadparameter
Kompatibilitäts-Aufgaben-ID, die vom Erstellungs-Endpunkt zurückgegeben wurde. IDs beginnen mit cgt-.
Antwort
application/json
application/json
application/json
application/json
application/json
application/json