Get Task (Volc Compatible)

​

Overview

​

Status Values

• queued: accepted and waiting to run.
• running: generation is in progress.
• succeeded: result is ready and content.video_url is present.
• failed: generation failed; inspect error.code and error.message.
• cancelled: the task was cancelled before completion.
• expired: the task expired before completion.

​

Response Fields

• id: compatibility task ID, starting with cgt-.
• model: model identifier echoed for compatibility.
• status: one of the status values above.
• content.video_url: final video URL on success.
• content.last_frame_url: present only when requested and available.
• usage: token usage when available.
• created_at and updated_at: task timestamps.
• error: present only when the task failed; omitted for non-failed tasks.

​

Example

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-260128",
  "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
    }
}