ビデオと素材
タスクの取得 (Volc互換)
cgtタスクIDを使用して、Seedance互換タスクを取得します。
概要
作成時に返された cgt-... IDを使用します。タスクが queued または running の間は数秒ごとにポーリングを行ってください。タスクが succeeded、failed、cancelled、または expired になったら停止します。
ここで統一されたv1タスクのenumやレスポンス構造体を再利用しないでください。/v1/tasks/{id} では pending、processing、completed、failed が使用されますが、このv3エンドポイントでは上記の公式enumが使用されます。v3のJSONオブジェクトにおいて、duration は存在する場合は文字列となり、error はオプションで、利用可能な場合にエラー詳細が含まれます。厳密なGoクライアントを実装する場合、Duration を string 型としてJSONタグ duration,omitempty を付けて宣言し、すべてのv3終了ステータスで停止するようにしてください。
Seedance 2.0 ビデオモデル および ビデオ生成 も参照してください。
ステータス値
queued: 受理され、実行待ちの状態。running: 生成が進行中。succeeded: 結果の準備が完了し、content.video_urlが存在します。failed: 生成に失敗。error.codeとerror.messageを確認してください。cancelled: 完了前にタスクがキャンセルされました。expired: 完了前にタスクの有効期限が切れました。
レスポンスフィールド
id:cgt-で始まる互換タスクID。model: タスク作成時に送信したmodel値。status: 上記のステータス値のいずれか。content.video_url: 成功時の最終的な動画URL。これは30日間有効なTokenLabの結果リンクです。データ保持 を参照してください。content.last_frame_url: 要求され、利用可能な場合にのみ存在します。usage: 利用可能な場合のcompletion_tokensおよびtotal_tokens。さらに、Web検索ツールが実行された場合はtool_usage.web_searchが含まれます。created_atおよびupdated_at: 秒単位のUnixタイムスタンプ。error: エラー詳細が利用可能な場合の{ code, message }。statusだけで存在を推測しないでください。- タスクに設定されたリクエスト値は、利用可能な場合にエコーバックされます:
seed、resolution、ratio、duration(文字列)、generate_audio、service_tier、execution_expires_after、safety_identifier、tools、draft、draft_task_id、frames、framespersecond。
レスポンスには、progress、return_last_frame、watermark、priority、camera_fixed といったTokenLabフィールドは追加されません。
不明なタスクIDや期限切れのタスクIDは 404 を返します。別の組織に属するIDは 403 を返します。
例
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
}
}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}認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
パスパラメータ
作成エンドポイントによって返される互換タスクID。IDはcgt-で始まります。
レスポンス
application/json
application/json
application/json
application/json
application/json
application/json