Video & materi

Dapatkan Tugas (Kompatibel dengan Volc)

Dapatkan tugas kompatibilitas Seedance berdasarkan ID tugas cgt-nya.

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

Gambaran Umum

Gunakan ID cgt-... yang dikembalikan oleh create. Lakukan polling setiap beberapa detik selama status tugas adalah queued atau running. Berhenti ketika status tugas adalah succeeded, failed, cancelled, atau expired.

Jangan gunakan kembali enum tugas atau struct respons v1 terpadu di sini. /v1/tasks/{id} menggunakan pending, processing, completed, dan failed; endpoint v3 ini menggunakan enum resmi di atas. Dalam objek JSON v3, duration adalah string jika ada dan error bersifat opsional serta berisi detail kesalahan jika tersedia. Klien Go yang ketat harus mendeklarasikan Duration sebagai string dengan tag JSON duration,omitempty, dan berhenti pada setiap status terminal v3.

Lihat juga Model Video Seedance 2.0 dan Pembuatan Video.

Nilai Status

  • 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: tugas dibatalkan sebelum selesai.
  • expired: tugas kedaluwarsa sebelum selesai.

Bidang Respons

  • id: ID tugas kompatibilitas, dimulai dengan cgt-.
  • model: nilai model yang Anda kirim saat membuat tugas.
  • status: salah satu nilai status di atas.
  • content.video_url: URL video akhir saat berhasil. Ini adalah tautan hasil TokenLab yang tetap valid selama 30 hari; lihat Retensi data.
  • content.last_frame_url: hanya ada saat diminta dan tersedia.
  • usage: completion_tokens dan total_tokens saat tersedia, ditambah tool_usage.web_search saat alat pencarian web dijalankan.
  • created_at dan updated_at: Unix timestamp dalam detik.
  • error: { code, message } saat detail kesalahan tersedia. Jangan menyimpulkan keberadaannya hanya dari status.
  • Nilai permintaan yang ditetapkan untuk tugas akan ditampilkan kembali saat tersedia: seed, resolution, ratio, duration (string), generate_audio, service_tier, execution_expires_after, safety_identifier, tools, draft, draft_task_id, frames, dan framespersecond.

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

ID tugas yang tidak diketahui atau kedaluwarsa akan mengembalikan 404; ID yang dimiliki oleh organisasi lain akan mengembalikan 403.

Contoh

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}

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter path

id*string

ID tugas kompatibilitas yang dikembalikan oleh endpoint pembuatan. ID dimulai dengan cgt-.

Respons

application/json

application/json

application/json

application/json

application/json

application/json