ビデオと素材

タスクの取得 (Volc互換)

cgtタスクIDを使用して、Seedance互換タスクを取得します。

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

概要

作成時に返された 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
  }
}
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}

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

パスパラメータ

id*string

作成エンドポイントによって返される互換タスクID。IDはcgt-で始まります。

レスポンス

application/json

application/json

application/json

application/json

application/json

application/json