メインコンテンツへスキップ
GET
/
volc
/
v3
/
contents
/
generations
/
tasks
/
{id}
Query a ByteDance video task
curl --request GET \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "021773297205999example",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated.mp4"
  },
  "created_at": 1773297205,
  "updated_at": 1773297260,
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24
}
ByteDance Jimeng のタスクを作成した後にこのエンドポイントを使用します。これはレンダリングを開始しません。現在のタスク状態のみを返し、ジョブ完了時には生成された動画 URL と出力メタデータを返します。

これらのフィールドを確認してください

  • 現在のプロバイダー状態を示す status
  • レンダリング完了時の content.video_url
  • アプリケーションで出力メタデータが必要な場合の resolutiondurationratioframespersecond

ポーリングループ

1

まずタスクを作成

ByteDance 動画生成 から始めてください。
2

task id でポーリング

ステータスが終端状態に達するまで、このエンドポイントを呼び出し続けてください。
3

結果を保存

content.video_url が表示されたら、長期保存が必要な場合は結果を自分のストレージにコピーしてください。

結果 URL

ByteDance のワークフローは、最初に作成し、その後 task id で照会するという流れのままです。CometAPI はその構造を維持しつつ、認証を標準化しています。返された動画 URL は永続ストレージではなく配信用 URL として扱ってください。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

パスパラメータ

id
string
必須

Task id returned by the create endpoint.

レスポンス

200 - application/json

Current task state.

id
string
必須
model
string
必須
status
string
必須

Provider task status.

created_at
integer
必須
updated_at
integer
必須
content
object
usage
object
seed
integer
resolution
string
duration
integer
ratio
string
framespersecond
integer