Video ve materyaller

Görevi Al (Volc Uyumlu)

Bir Seedance uyumluluk görevini cgt görev kimliği ile alın.

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

Genel Bakış

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

Burada birleştirilmiş v1 görev enum veya yanıt yapısını yeniden kullanmayın. /v1/tasks/{id} uç noktası pending, processing, completed ve failed kullanır; bu v3 uç noktası ise yukarıdaki resmi enum değerlerini kullanır. v3 JSON nesnesinde duration mevcut olduğunda bir string'dir ve error isteğe bağlıdır; mevcut olduğunda hata detaylarını içerir. Katı bir Go istemcisi, Duration değerini duration,omitempty JSON etiketiyle string olarak tanımlamalı ve her v3 terminal durumunda durmalıdır.

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

Durum Değerleri

  • queued: kabul edildi ve çalıştırılmayı 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ı

  • id: cgt- ile başlayan uyumluluk görev kimliği.
  • model: görevi oluştururken gönderdiğiniz model değeri.
  • status: yukarıdaki durum değerlerinden biri.
  • content.video_url: başarı durumunda nihai video URL'si. Bu, 30 gün boyunca geçerli kalan bir TokenLab sonuç bağlantısıdır; bkz: Veri saklama.
  • content.last_frame_url: yalnızca talep edildiğinde ve mevcut olduğunda bulunur.
  • usage: mevcut olduğunda completion_tokens ve total_tokens, ayrıca web arama aracı çalıştığında tool_usage.web_search.
  • created_at ve updated_at: saniye cinsinden Unix zaman damgaları.
  • error: hata detayları mevcut olduğunda { code, message }. Varlığını yalnızca status değerine bakarak tahmin etmeyin.
  • Görev için ayarlanan istek değerleri mevcut olduğunda yansıtılır: seed, resolution, ratio, duration (string), generate_audio, service_tier, execution_expires_after, safety_identifier, tools, draft, draft_task_id, frames ve framespersecond.

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

Bilinmeyen veya süresi dolmuş bir görev kimliği 404 döndürür; başka bir organizasyona ait bir kimlik 403 döndürür.

Örnek

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}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

id*string

Oluşturma uç noktası tarafından döndürülen uyumluluk görevi kimliği. Kimlikler cgt- ile başlar.

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json