Task abrufen (Volc-kompatibel)

ÜbersichtCopy Anchor Link

Verwenden Sie die cgt-... ID, die bei der Erstellung zurückgegeben wurde. Pollen Sie alle paar Sekunden, solange der Task den Status queued oder running hat. Stoppen Sie, wenn der Task succeeded, failed, cancelled oder expired ist.

Siehe auch Seedance 2.0 Videomodelle und Videogenerierung.

StatuswerteCopy Anchor Link

• 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: der Task wurde vor Abschluss abgebrochen.
• expired: der Task ist vor Abschluss abgelaufen.

AntwortfelderCopy Anchor Link

• id: Kompatibilitäts-Task-ID, beginnend mit cgt-.
• model: Modellkennung, die zur Kompatibilität zurückgegeben wird.
• status: einer der oben genannten Statuswerte.
• content.video_url: finale Video-URL bei Erfolg.
• content.last_frame_url: nur vorhanden, wenn angefordert und verfügbar.
• usage: Token-Verbrauch, sofern verfügbar.
• created_at und updated_at: Zeitstempel des Tasks.
• error: Optionale Fehlerdetails, sofern verfügbar. Prüfen Sie error.code und error.message; leiten Sie die Existenz des Felds nicht allein aus status ab.

Die Antwort fügt niemals TokenLab-Felder wie progress, return_last_frame, watermark, priority oder camera_fixed hinzu.

BeispielCopy Anchor Link

curl https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

{
  "id": "cgt-20260102030405-a1b2c",
  "model": "doubao-seedance-2.0",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/result.mp4"
  },
  "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}