動画生成 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.5",
  "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.5",
  "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
}

content_url を使って動画をダウンロードします。

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

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

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

参照素材リスト（content）

• URL を指定できるモデル。Seedance 2.5 や Motion Control が該当します。image_url または video_url に、ジョブが読み取る間アクセスできる公開 HTTPS URL を指定します。
• アップロードが必要なモデル。Kling 4、Kling 4.0 Flash、FLUX3 Video、このページに記載する Vidu Q3/Q4 および Gemini Omni は、同じアカウントでアップロードした素材を使用します。参照素材をアップロードし、返された id を各項目の asset_id に設定します。

先頭・末尾フレームを 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 も使用できます。
• 参照音声は現在サポートされていません。

動画の参照素材をアップロードする

multipart では file より先に kind を送信します。ファイルの種類に合わせて image または video を指定してください。

curl -sS https://api.icodeeasy.cc/v1/videos/assets \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -F 'kind=video' \
  -F '[email protected];type=video/mp4'

HTTP 201 で素材オブジェクトが返ります。ジョブ作成時はその id を content[].asset_id に指定します。

動画の参照素材を削除する

curl -i -sS -X DELETE 'https://api.icodeeasy.cc/v1/videos/assets/YOUR_ASSET_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

素材を所有するアカウントの API Key で削除します。成功時は HTTP 204 が返ります。

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

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

content_url を使ってダウンロードします。認証付きコンテンツエンドポイントは HTTP Range と一般的な条件付きヘッダーに対応し、200、206 Partial Content、またはリレー管理ストレージへのリダイレクトを返します。クライアントでリダイレクトを有効にしてください。ジョブが成功する前は 409 video_not_ready を返します。

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

終端状態のジョブを削除する

curl -i -sS -X DELETE 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

安全な終端状態のジョブを削除すると 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.5",
  "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% のままの場合、料金の精算を待っている可能性があります。元のジョブを引き続きポーリングし、再送信しないでください。

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

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 自体は常に必須です。サービスはジョブ開始前に指定された組み合わせを検証します。

Kling 4

kling-v4：720p / 1080p、整数 3–30 秒（既定 5 秒）。音声は常時有効で generate_audio: false はローカルで拒否します。Kling 4 系列の 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"
    }
  ]
}

Kling 4.0 Flash

Kling 4.0 Flash は 720p、3～20 秒（既定 5 秒）、音声付きで、omni_reference_task_type を使用します。先頭フレームは first_frame 1 枚だけ指定し、画像の比率を使うため ratio は省略します。参照生成は画像最大 10 枚、動画最大 5 本、各 3～20 秒で合計 20 秒以内。編集は 3～20 秒の動画 1 本と任意の参照画像を受け付けます。延長は動画 1 本のみで、画像と ratio は省略します。結果は追加分のみです。すべての素材に自分の asset_id を指定してください。

動画入力なしの 720p 生成と延長の追加区間は 1 秒あたり ¥0.66。編集と動画参照付き生成は課金対象の 1 秒あたり ¥0.440003 です。課金対象は出力時間に、出力時間と切り上げた入力時間の大きい方を加えた秒数です。

追加動画モデル

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

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 1.1 Flash

gemini-omni-1.1-flash

360p/720p/1080p/4k、16:9 または 9:16、4/6/8/10 秒（既定 6 秒）に対応します。プロンプトは必須です。テキストのみ、先頭フレーム 1 枚、または参照画像 1 枚か 3 枚を指定できます。generation_mode は auto、t2v、frame、reference。音声設定は省略します。末尾フレーム、動画入力、タスク延長は非対応です。動画 1 本ごとに課金します。

Gemini Omni Flash Preview

gemini-omni-flash-preview は 720p、通常の参照画像最大 16 枚、または 3～24 秒の動画 1 本に対応します。動画入力時は ratio を省略します。出力の 3～10 秒はプロンプトで指定します。duration、generate_audio、seed、ネガティブプロンプト、生成数は省略します。

精算済みの自分の Preview タスクは、履歴から「生成を続ける」を選び、新しいプロンプトを指定します。サイトの source_task_id と入力動画はどちらか一方を使用します。モードは auto/t2v/i2v/reference/edit/extend です。

FLUX3 と Gemini Omni Flash Preview の出力料金は参考値です。素材や文脈の利用分が追加される場合があり、実際のタスク料金で精算します。99% で精算待ちの場合は、元のタスクを引き続き確認してください。

Gemini Omni 1.2 Flash

Gemini Omni 1.2 Flash は 360p/720p/1080p/4k と 16:9 または 9:16 に対応し、すべてのモードでプロンプトが必要です。テキストや首尾フレームには generation_mode: auto、最大 10 枚の参照画像には reference を指定します。参照画像と首尾フレームは併用できません。出力は 3～15 秒（既定 10 秒）、首尾フレーム指定時は 3～10 秒です。

編集または延長は generation_mode: edit または extend を使い、15 秒、64 MB 以下の MP4/MOV 1 本を asset_id で指定します。編集時は duration を省略し、元動画の長さで課金します。延長時は duration に追加する 3～10 秒を指定し、追加分のみ課金します。自分の同モデルの完了済みタスクはサイトの source_task_id で延長できます。generate_audio は省略します。

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

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