Mendapatkan Task (Kompatibel dengan Volc)

Gambaran UmumCopy Anchor Link

Gunakan ID cgt-... yang dikembalikan oleh create. Lakukan polling setiap beberapa detik selama task berstatus queued atau running. Berhentilah ketika task berstatus succeeded, failed, cancelled, atau expired.

Lihat juga Model Video Seedance 2.0 dan Pembuatan Video.

Nilai StatusCopy Anchor Link

• queued: diterima dan menunggu untuk dijalankan.
• running: pembuatan sedang berlangsung.
• succeeded: hasil sudah siap dan content.video_url tersedia.
• failed: pembuatan gagal; periksa error.code dan error.message.
• cancelled: task dibatalkan sebelum selesai.
• expired: task kedaluwarsa sebelum selesai.

Bidang ResponsCopy Anchor Link

• id: ID task kompatibilitas, dimulai dengan cgt-.
• model: pengenal model yang ditampilkan kembali untuk kompatibilitas.
• status: salah satu nilai status di atas.
• content.video_url: URL video akhir jika berhasil.
• content.last_frame_url: hanya ada jika diminta dan tersedia.
• usage: penggunaan token jika tersedia.
• created_at dan updated_at: stempel waktu task.
• error: Detail error opsional jika tersedia. Periksa error.code dan error.message; jangan menyimpulkan keberadaan field hanya dari status.

Respons tidak pernah menambahkan bidang TokenLab seperti progress, return_last_frame, watermark, priority, atau camera_fixed.

ContohCopy 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}