動画生成 API

動画生成 API は、非同期の動画ジョブを作成します。作成リクエストはジョブ ID とともに HTTP 202 を返します。その ID を使い、ジョブが succeeded または failed になるまでポーリングし、完成した MP4 をダウンロードしてください。

以下の例では、ベース URL として https://api.icodeeasy.cc を使用します。以下に記載するすべてのエンドポイント呼び出しには API キーが必要です。成功後に返される署名付き結果ファイル URL のみが例外です。

Authorization: Bearer <your API key>

エンドポイント

作成・照会レスポンスの status_url と content_url は Base URL からの相対パスで、正式な照会・ダウンロード先です。これらをそのまま使用してください。読み取り専用の互換ルート GET /v1/videos/generations/{id} と GET /v1/videos/generations/{id}/content でも同じジョブを取得できます。互換ルートでの作成・削除はサポートされません。

5 分クイックスタート

1. ジョブを作成する

curl -X POST https://api.icodeeasy.cc/v1/videos/generations \
  -H 'Authorization: Bearer <your API key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao-seedance-2.5",
    "prompt": "雨の未来都市の通り、カメラがゆっくり前進し、濡れた路面にネオンが反射する",
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 4,
    "generate_audio": true
  }'

作成が受理されると HTTP 202 を返します。

{
  "id": "vid_1785398400000000000",
  "task_id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "queued",
  "model": "doubao-seedance-2.5",
  "created_at": "2026-07-30T08:00:00Z",
  "updated_at": "2026-07-30T08:00:00Z"
}

ジョブ ID には task_id の使用を推奨します。ポーリング、ダウンロード、削除に使用でき、id は互換期間中、同じ値で残ります。202 はジョブが受理されたことを示すもので、動画がすでに完成していることを示すものではありません。

2. ジョブをポーリングする

作成レスポンスの task_id を TASK_ID に設定します。

TASK_ID='vid_1785398400000000000'
curl "https://api.icodeeasy.cc/v1/videos/tasks/${TASK_ID}" \
  -H 'Authorization: Bearer <your API key>'

約 5 秒に 1 回ポーリングしてください。現在のジョブが queued または running の間は、別のジョブを作成しないでください。

{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "running",
  "model": "doubao-seedance-2.0",
  "created_at": "2026-07-30T08:00:00Z",
  "updated_at": "2026-07-30T08:00:20Z",
  "progress": 42
}

progress は参考値であり、省略される場合があります。進捗値ではなく status を正式な状態として扱ってください。

3. 動画をダウンロードする

status が succeeded になると、レスポンスに url と確定した cost_rmb が含まれます。

{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "succeeded",
  "model": "doubao-seedance-2.0",
  "created_at": "2026-07-30T08:00:00Z",
  "updated_at": "2026-07-30T08:01:18Z",
  "progress": 100,
  "url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "cost_rmb": 0.528
}

正式な認証付きコンテンツルートから、リダイレクトを許可してダウンロードしてください。

TASK_ID='vid_1785398400000000000'
curl -L "https://api.icodeeasy.cc/v1/videos/tasks/${TASK_ID}/content" \
  -H 'Authorization: Bearer <your API key>' \
  -o result.mp4

コンテンツルートは HTTP Range と一般的な条件付きダウンロードヘッダーに対応しています。成功前にコンテンツを要求すると 409 video_not_ready を返します。

ジョブのライフサイクルと安全な再試行

再試行のルール：

• HTTP 202 を受け取った後は、返された task_id を引き続きポーリングしてください。作成リクエストを繰り返すと別のジョブが作成される可能性があります。
• ポーリングとダウンロードの GET リクエストは安全に再試行できます。
• ポーリング時の HTTP 404 は生成失敗を意味しません。これを理由に再送信しないでください。元のジョブ ID を保持し、返された status_url または GET /v1/videos/tasks/{id} を確認して、ジョブ所有者の有効な API Key を使用してください。すでに成功・精算済みの場合もあるため、利用明細を確認してください。照会できない場合は、ジョブ ID と送信時刻をサポートに伝えてください。
• 作成時に submission_unknown が返った場合は、別のリクエストを送信しないでください。ジョブがすでに受理されている可能性があります。リクエスト時刻、モデル、プロンプトの概要を添えてサポートにお問い合わせください。
• 終端状態 failed が確認された後は、別の動画を生成する場合にのみ新しいジョブを作成してください。

Webhook と callback_url はサポートされていません。代わりにジョブエンドポイントをポーリングしてください。

作成リクエストのリファレンス

テキスト指示はすべて prompt に指定してください。content は参照画像と参照動画だけに使用します。

参照素材リスト（content）

content は、先頭・末尾フレーム、複数の順序なし参照画像、Seedance 2.5 の参照動画、または Motion Control の画像 1 点と動画 1 点など、1 つのジョブで複数素材を扱うためのリストです。各項目の image_url または video_url に HTTPS URL 文字列を直接指定します。

[
  { "type": "image_url", "image_url": "https://cdn.example.com/first.png", "role": "first_frame" },
  { "type": "image_url", "image_url": "https://cdn.example.com/last.png", "role": "last_frame" }
]

• 画像タイプ：image_url または input_image。
• 動画タイプ：video_url または input_video。
• フレーム役割：first_frame と last_frame。フレームに基づく生成では、末尾フレームには先頭フレームが必要です。
• Seedance 2.5 の参照動画の役割は reference_video。併用する通常の参照画像には reference_image を指定します。
• モーション役割：reference_image 1 点と reference_video 1 点。
• Grok の参照画像には役割を付けません。reference_image も使用できます。
• 参照音声は現在サポートされていません。
• メディアは、ジョブが読み取る間有効な、公開アクセス可能な HTTPS URL で指定してください。
• 画像は image_url、動画は video_url に指定します。

先頭フレーム + 末尾フレームの完全な呼び出し例

2 枚の画像を公開 HTTPS URL に配置し、その URL を content に直接指定します。

curl -X POST https://api.icodeeasy.cc/v1/videos/generations \
  -H 'Authorization: Bearer <API キー>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao-seedance-2.0",
    "prompt": "先頭フレームから末尾フレームへ滑らかにカメラを移動する",
    "content": [
      {"type":"image_url","image_url":"https://cdn.example.com/first.png","role":"first_frame"},
      {"type":"image_url","image_url":"https://cdn.example.com/last.png","role":"last_frame"}
    ],
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 4,
    "generate_audio": true
  }'

フレームに基づく生成では、先頭フレームだけを指定できます。末尾フレームを指定するには、同じリクエストに先頭フレームが必要です。

モデル別レシピ

Seedance：テキスト、先頭フレーム、末尾フレーム

Seedance 2.5、Seedance 2.0 Standard、Fast、Mini、および Seedance 1.5 Pro は、テキストからの動画生成と先頭・末尾フレームによる生成に対応しています。画像だけで生成を誘導する場合は、フレーム役割を明示してください。Seedance 2.5 は、次の参照動画モードにも対応しています。

{
  "model": "doubao-seedance-2.5",
  "prompt": "the camera circles a glass sculpture as morning light changes",
  "content": [
    { "type": "image_url", "image_url": "https://cdn.example.com/seedance-first.png", "role": "first_frame" },
    { "type": "image_url", "image_url": "https://cdn.example.com/seedance-last.png", "role": "last_frame" }
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 6,
  "generate_audio": true
}

Seedance 2.5 のテキストからの動画生成の既定値は 480p、9:16、4 秒、生成音声オンです。参照動画を使わない先頭フレーム／先頭・末尾フレームモードでは、出力比率は先頭画像に従います。ratio は adaptive を指定するか省略してください。エイリアスの aspect_ratio も同じルールです。16:9 などの固定比率を明示すると、黙って書き換えられることなく 400 invalid_request が返ります。縦長の先頭画像からは縦長の動画が生成されます。16:9 の出力が必要な場合は、先頭画像をあらかじめ 16:9 にトリミングまたは拡張し、adaptive を使ってください。テキストからの生成と参照動画モードでは、引き続き 16:9 などの固定比率を指定できます。

Seedance 2.5：参照動画

次の JSON を POST https://api.icodeeasy.cc/v1/videos/generations に送信し、Authorization: Bearer <あなたの API Key> と Content-Type: application/json を指定します：

{
  "model": "doubao-seedance-2.5",
  "prompt": "@Video1 の動きを参考に、滑らかな動画を生成する",
  "content": [
    { "type": "video_url", "video_url": "https://cdn.example.com/reference.mp4", "role": "reference_video" }
  ],
  "resolution": "480p",
  "ratio": "9:16",
  "duration": 4,
  "generate_audio": true
}

サンプル URL を、公開アクセス可能な HTTPS 動画 URL に置き換えてください。video_url には URL 文字列を直接指定します。duration は出力の長さです。参照動画の長さはサービスが読み取るため、入力の長さを指定するフィールドは不要です。複数の動画は、それぞれ reference_video を付けて content に追加します。プロンプトの @Video1、@Video2 などは、リスト内の動画の順序に対応します。

• 入力は MP4/MOV 動画を最大 10 本、各 2～30 秒、合計 30 秒以内、1 ファイルあたり 100 MiB 以内です。
• 出力は 4～30 秒で、480p と 720p に対応します。ratio と generate_audio を設定できます。Motion Control 専用のパラメーターは使用しません。
• 画像も最大 2 点まで併用できます。type: "image_url"、image_url 文字列、role: "reference_image" を指定してください。このモードでは画像は通常の参照画像となり、先頭・末尾フレームになる保証はありません。フレーム役割を指定した画像も通常の参照として扱われます。
• 動画は H.264/H.265、24～60 fps を使用してください。幅と高さは各 300～6000 ピクセル、総ピクセル数（幅×高さ）は 409,600～8,295,044、幅/高さの比率は 0.4～2.5 です。720×720 はこれらのサイズ制限を満たします。

作成に成功したら、返された status_url または GET /v1/videos/tasks/{id} で同じジョブをポーリングします。ダウンロード方法は他のモデルと同じです。参照動画モードでは参照入力と出力の両方が料金に含まれます。下の料金説明を確認してください。

MiniMax H3：テキスト、先頭フレーム、末尾フレーム

MiniMax-H3 は、同じ公開リクエストでテキストからの動画生成と先頭・末尾フレームによる生成に対応します。768P または 2K、4～15 秒、21:9、16:9、4:3、1:1、3:4、9:16 の比率を使用できます。既定値は 768P、9:16、5 秒です。generate_audio は指定しないでください。H3 の公開契約には生成音声のリクエスト切替はありません。

Kling：フレームに基づく生成

{
  "model": "kling-v3",
  "prompt": "a train enters the station through light fog",
  "content": [
    { "type": "image_url", "image_url": "https://cdn.example.com/kling-first.png", "role": "first_frame" },
    { "type": "image_url", "image_url": "https://cdn.example.com/kling-last.png", "role": "last_frame" }
  ],
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true
}

Kling の主な違い：

• kling-v2-6：末尾フレームには 1080p が必要です。生成音声は 1080p でのみ利用でき、末尾フレームとは併用できません。
• kling-3.0-turbo：先頭フレームのみ対応し、生成音声は非対応です。
• kling-v3 と kling-v3-omni：先頭・末尾フレームと生成音声に対応しています。
• kling-v3-omni：役割なしの参照画像も最大 2 点まで使用できますが、1 つのリクエストで役割なし画像とフレーム役割付き画像を混在させないでください。
• kling-video-o1：先頭・末尾フレームに対応し、生成音声は非対応です。

Grok：順序なしの参照画像

Grok は参照画像 URL を最大 7 点まで使用できます。first_frame または last_frame の役割を指定しないでください。

{
  "model": "grok-imagine-1.5-video",
  "prompt": "clouds roll over a canyon while the camera rises",
  "content": [
    { "type": "image_url", "image_url": "https://cdn.example.com/grok-reference.png" }
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 6
}

Grok の既定値は 480p、9:16、6 秒です。生成音声はサポートされていません。

Kling Motion Control

公開 HTTPS 画像 1 点と、公開 HTTPS の 3～30 秒 MP4 動画 1 点を指定します。

{
  "model": "kling-v3-motion-control",
  "prompt": "preserve the character identity and follow the reference motion",
  "content": [
    { "type": "image_url", "image_url": "https://cdn.example.com/character.png", "role": "reference_image" },
    { "type": "video_url", "video_url": "https://cdn.example.com/motion.mp4", "role": "reference_video" }
  ],
  "motion_mode": "std",
  "character_orientation": "image",
  "keep_original_sound": true
}

• character_orientation: "image"：参照動画は 3～10 秒である必要があります。
• character_orientation: "video"：参照動画は 3～30 秒である必要があります。
• Motion Control モデルには resolution、ratio、duration、generate_audio を指定しないでください。

モデル機能表

標準モデルでは、省略したオプション値に上記の各モデルの既定値が適用されます。model 自体は常に必須です。サービスはジョブ開始前に指定された組み合わせを検証します。

レスポンスとダウンロードの動作

すべてのジョブレスポンスは次の形式を使用します。

返された URL の形式を前提として保存するのではなく、GET /v1/videos/tasks/{id}/content を優先してください。-L を使用するか、HTTP クライアントでリダイレクトを有効にしてください。認証付きコンテンツエンドポイントは 200、206 Partial Content、またはリレー管理ストレージへのリダイレクトを返す場合があります。

署名付きリレーファイル URL は API キーなしで開くことができ、完全な URL を知っている人はその動画へアクセスできます。公開ログ、公開ページ、クライアント側の分析に露出させないでください。

安全な終端状態のジョブを削除すると HTTP 204 が返り、リレー管理の動画ファイルも削除される場合があります。必要な結果は、ジョブを削除する前にダウンロードして保存してください。ジョブが実行中または精算未完了の場合、削除は 409 video_delete_unsafe で拒否されます。ローカルジョブ記録を削除しても、開始済みの動画生成はキャンセルされません。

エラー処理

HTTP エラーは次の形式を使用します。

{
  "error": {
    "type": "invalid_request",
    "message": "model is not supported"
  }
}

失敗したジョブのレスポンス例：

{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "failed",
  "model": "doubao-seedance-2.0",
  "error": { "code": "generation_failed" }
}

課金

動画生成では、月間クォータではなくアカウント残高を使用します。

通常の動画ジョブ料金 = 選択したモデル／仕様の表示 RMB 単秒価格 × 課金秒数

料金ページ で現在の単秒価格を確認してください。解像度、生成音声、または Motion Control モードによって、適用される単秒価格が異なる場合があります。参照動画を使用しない標準モデルの課金秒数は、指定した duration です。Motion Control は、検出された参照動画の長さを整数秒に切り上げて使用します。Seedance 2.5 の参照動画は、出力秒数だけではなく、以下の料金確保と実際の料金による精算ルールを使用します。

ジョブ作成時に見積料金を確保し、利用可能残高から差し引くため、生成中でも残高は減少します。残高不足の場合は生成開始前に 402 を返します。成功時に最終料金と確保額との差額を精算し、利用明細を記録します。cost_rmb が最終料金です。明確に失敗した場合は確保額を全額返金します。隣接するリクエスト明細の残高差には動画料金の確保や返金が含まれることがあり、そのリクエストの料金とは限りません。

Seedance 2.5 参照動画の料金

参照動画モードでは「参照動画の合計長さを整数秒に切り上げた値 + 出力秒数」と、料金ページの参照動画の見積単価を使って料金を確保します。たとえば、2 秒の参照動画から 4 秒の出力を生成する場合、まず 6 秒分の見積額を確保します。これは最終料金の保証ではありません。

最終料金は実際の使用量に基づいて精算します。確保額より低ければ差額を返金し、高ければ差額を追加で差し引きます。cost_rmb と使用量明細には最終料金が表示されます。失敗が確定した場合は確保額を全額返金します。進捗が 99% のままの場合、料金の精算を待っている可能性があります。元のジョブを引き続きポーリングし、再送信しないでください。

Kling 4

kling-v4：720p / 1080p、整数 3–30 秒（既定 5 秒）。音声は常時有効で generate_audio: false はローカルで拒否します。専用の omni_reference_task_type は auto / reference / edit / extend。比率は 16:9 / 9:16 / 1:1 / 21:9、参照モードのみ auto 対応。延長では ratio を省略します。首尾フレーム、参照画像最大 8 枚、動画最大 5 本に対応。動画は各 3–30 秒、合計 30 秒以内、編集/延長は 1 本です。編集で duration を省略すると入力動画の秒数を切り上げ、他のモードは既定 5 秒です。首尾フレームを含む全素材に asset_id を使います。まず POST /v1/videos/assets に multipart の kind=image または kind=video と file を送信し、返却された id を生成リクエストに指定します。画像/動画の直接 URL、音声参照、中間フレームは非対応。延長では先頭フレームなしで目標末尾フレームを指定できます。

参考価格：通常 720p ¥1.0486/秒、1080p ¥1.5729/秒。動画入力は 720p ¥0.62916/課金秒、1080p ¥0.94374/課金秒。 動画を含む参照/編集の課金秒数 = 出力秒数 + max(出力秒数, 入力合計秒数の切り上げ)。延長は追加秒数のみ。

{
  "model": "kling-v4",
  "prompt": "Preserve the subject and change the setting",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "omni_reference_task_type": "edit",
  "content": [
    {
      "type": "video_url",
      "role": "reference_video",
      "asset_id": "vasset_uploaded_video"
    }
  ]
}

追加動画モデル

新モデルの素材は自分の asset_id としてアップロードします。サイト制限は画像10 MB以下、動画3秒以上・100 MiB以下です。Vidu Q4音声参照とOmni Ext動画入力は今回非対応。出力音声とは別機能です。

FLUX3 Video

FLUX3：テキスト・画像・単一動画編集、5〜20秒（既定5）、hd/fhd。比率 auto/21:9/2:1/16:9/4:3/1:1/3:4/9:16。画像は最初→中間 reference_image→最後の順に最大10枚、重複も保持。動画1本3〜30秒。draft:true はHDのみ。モード auto/t2v/i2v/v2v/draft_enhance。出力音声は既定オン、オフも同参考料金。

履歴の完了済みFLUX3ドラフトから「本生成 / 強化」を選択。model、generation_mode:draft_enhance、サイト内source_task_id、resolutionだけを送り、新しいプロンプト・素材・長さ・音声は追加しません。同ユーザー・同モデルで成功精算済みのドラフトのみ。ドラフト料金は充当されません。

Vidu

Vidu Q4：最初の画像1枚（プロンプト任意）または参照1〜15枚（プロンプト必須、最大20000文字）。文のみ・最後の画像は非対応。reference_image 1枚でも参照モード、最初の画像と混在不可。3〜16秒、540p/720p/1080p/2K/4K。Q3は参照1〜7枚必須、最大5000文字、3〜16秒。Mixは1〜16秒、720p/1080pのみ。Pro/Turboは文のみ・最初1枚・最初と最後2枚、1〜16秒、540p/720p/1080p。文のみは最大2000文字必須、画像生成は任意。全5種の既定720p・5秒。参照・文生成は1:1/9:16/16:9/3:4/4:3、最初の画像使用時は比率省略。Q3/Mixは音声指定なし、Q4/Pro/Turboは既定オンでオフも同参考料金。

Gemini Omni

Gemini Omni主線：360p/720p/1080p/4k、16:9/9:16、最初と最後または通常参照を計10枚、動画1本3〜10秒。Previewは720pのみ、通常参照16枚、動画1本3〜24秒、最初・最後のフレームモードなし、動画入力時は比率省略。両者の出力長はプロンプト指定（3〜10秒）。duration/generate_audio/seed/negative_prompt/nは送信しません。出力参考料金は素材・文脈を含まない場合があり、上限ではなく実使用量で精算。

主線/Previewの同ユーザー・同モデルで成功精算済みの履歴から「生成を続ける」。新しいプロンプト必須、source_task_idと動画入力は排他。供給元タスクIDを入力しないでください。モード auto/t2v/i2v/reference/edit/extend。

Omni Ext：360p/720p/1080p/4k、16:9/9:16、4/6/8/10秒（既定6）、動画1本ごと。文のみ、最初1枚、参照ちょうど1枚か3枚。最初と最後2枚・動画・元タスク継続は非対応。プロンプト必須、auto/t2v/frame/reference、音声指定なし。

FLUX3とOmni主線/Previewは出力参考料金。素材や文脈が別途加算される場合があり、実タスク料金を優先。予約額との差は返金または追加引落。99%で精算待ちの場合は元タスクをポーリングし、再送しないでください。

最終人民元の参考料金（1秒あたり）

Omni Ext 最終人民元参考料金（動画1本）