Video & Materialien

Task abrufen (Volc-kompatibel)

Ruft eine Seedance-kompatible Aufgabe über ihre cgt-Aufgaben-ID ab.

GET
/api/v3/contents/generations/tasks/{id}

Ü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 und content.video_url ist vorhanden.
  • failed: Generierung fehlgeschlagen; prüfen Sie error.code und error.message.
  • cancelled: die Aufgabe wurde vor Abschluss abgebrochen.
  • expired: die Aufgabe ist vor Abschluss abgelaufen.

Antwortfelder

  • id: Kompatibilitäts-Aufgaben-ID, beginnend mit cgt-.
  • model: der model-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_tokens und total_tokens, falls verfügbar, sowie tool_usage.web_search, wenn das Web-Such-Tool ausgeführt wurde.
  • created_at und updated_at: Unix-Zeitstempel in Sekunden.
  • error: { code, message }, wenn Fehlerdetails verfügbar sind. Schließen Sie nicht allein aus dem status auf 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, frames und framespersecond.

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
  }
}
Go
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
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

id*string

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