コンテンツにスキップ

SeeDance 2.0 利用例

動画を作成する

curl --location --request POST 'https://api-cs-al.naci-tech.com/v1/video/generations' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "sd2.0",
    "content": [
         {
            "type": "text",
            "text": "クリスマスのうさぎが空を飛んでいる"
        }
    ],
    "generate_audio": true,
    "ratio": "16:9",
    "duration": 11,
    "watermark": false
}'

成功レスポンス

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "doubao-seedance-2-0-260128",
  "status": "queued",
  "progress": 0,
  "created_at": 1774860007
}

参考リンク

動画生成結果を照会する

GET /v1/video/generations/{task_id}

タスク ID を使って、動画生成の状態と結果を照会します。

パスパラメータ

パラメータ 型 必須 説明
task_id string はい 動画作成時に返されるタスク ID。

クエリパラメータ

パラメータ 型 必須 説明
raw boolean いいえ 上流の生レスポンスを直接返すかどうか。true でより詳細な上流タスク情報を取得できます。
show_raw boolean いいえ クエリ結果に生データを含めるかどうか。true で data.data が追加されます。
show_usage boolean いいえ クエリ結果に使用量を含めるかどうか。true かつ成功完了時に data.usage が追加されます。

リクエスト例

curl --location --request GET 'https://api-cs-al.naci-tech.com/v1/video/generations/cgt-20260330164007-wnc8k' \
  --header 'Authorization: Bearer $API_KEY' \
  --header 'Content-Type: application/json'

生データと使用量を同時に確認する場合:

curl --location --request GET 'https://api-cs-al.naci-tech.com/v1/video/generations/cgt-20260330164007-wnc8k?show_raw=true&show_usage=true' \
  --header 'Authorization: Bearer $API_KEY' \
  --header 'Content-Type: application/json'

クエリ成功レスポンス

show_raw=true&show_usage=true の場合、ラップされたクエリ結果の data 内に、生タスクデータと使用量情報が含まれます（例）:

{
  "code": "success",
  "data": {
    "task_id": "cgt-20260330164007-wnc8k",
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1774860007,
    "start_time": 1774860010,
    "finish_time": 1774860088,
    "progress": "100%",
    "data": {
      "id": "cgt-20260330164007-wnc8k",
      "model": "doubao-seedance-2-0-260128",
      "status": "succeeded",
      "content": {
        "video_url": "https://example.com/generated-video.mp4",
        "last_frame_url": "https://example.com/last-frame.png"
      },
      "seed": 1345,
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 11,
      "framespersecond": 30,
      "usage": {
        "completion_tokens": 13987,
        "total_tokens": 15000
      },
      "created_at": 1774860007,
      "updated_at": 1774860088
    },
    "usage": {
      "completion_details": {
        "video_durations": 11,
        "video_tokens": 15000
      },
      "ratio": "16:9",
      "watermark": false,
      "generate_audio": true
    }
  }
}

{
  "id": "cgt-20260330164007-wnc8k",
  "task_id": "cgt-20260330164007-wnc8k",
  "object": "video",
  "model": "doubao-seedance-2-0-260128",
  "status": "completed",
  "progress": 100,
  "created_at": 1774860007,
  "completed_at": 1774860088,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}

raw=true の場合、上流の生フィールドが返ることがあります（例）:

{
  "id": "cgt-20260330164007-wnc8k",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated-video.mp4",
    "last_frame_url": "https://example.com/last-frame.png"
  },
  "seed": 1345,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 11,
  "framespersecond": 30,
  "usage": {
    "completion_tokens": 13987,
    "total_tokens": 15000
  },
  "created_at": 1774860007,
  "updated_at": 1774860088
}