Görevi Al (Volc Uyumlu)

Genel BakışCopy Anchor Link

create tarafından döndürülen cgt-... kimliğini kullanın. Görev queued veya running durumundayken birkaç saniyede bir sorgulama (poll) yapın. Görev succeeded, failed, cancelled veya expired durumuna geldiğinde durun.

Ayrıca bkz. Seedance 2.0 Video Modelleri ve Video Oluşturma.

Durum DeğerleriCopy Anchor Link

• queued: kabul edildi ve çalışmayı bekliyor.
• running: oluşturma işlemi devam ediyor.
• succeeded: sonuç hazır ve content.video_url mevcut.
• failed: oluşturma başarısız oldu; error.code ve error.message alanlarını inceleyin.
• cancelled: görev tamamlanmadan önce iptal edildi.
• expired: görev tamamlanmadan önce zaman aşımına uğradı.

Yanıt AlanlarıCopy Anchor Link

• id: cgt- ile başlayan uyumluluk görev kimliği.
• model: uyumluluk için yansıtılan model tanımlayıcısı.
• status: yukarıdaki durum değerlerinden biri.
• content.video_url: başarı durumunda nihai video URL'si.
• content.last_frame_url: yalnızca talep edildiğinde ve mevcut olduğunda bulunur.
• usage: mevcut olduğunda token kullanımı.
• created_at ve updated_at: görev zaman damgaları.
• error: Varsa isteğe bağlı hata ayrıntıları. error.code ve error.message alanlarını inceleyin; alanın varlığını yalnızca status değerinden çıkarmayın.

Yanıt, progress, return_last_frame, watermark, priority veya camera_fixed gibi TokenLab alanlarını asla eklemez.

ÖrnekCopy 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}