POST /flux/videos を使用して、動画生成、キーフレーム画像からの動画生成、動画継続、ドラフト強化を実行します。action=generate（デフォルト）で、mode により生成モードを選択します。結果の照会はすべて既存の POST /flux/tasks を使用します。
現在は Beta です。テキストからの動画生成、画像からの動画生成、動画継続、ドラフト強化が公開されています。HTTP 200 とタスク ID はタスクが受理されたことのみを示すため、最終結果を引き続き照会する必要があります。
1. API Token を取得する
- Ace Data Cloud コンソールで登録またはログインし、アプリケーションを作成して API Token を取得します。汎用 API Token はプラットフォームサービスを呼び出せます。アプリケーションに Flux サービスの呼び出し権限と利用可能な残高があることを確認してください。
- Flux サービスページでプランおよび各操作の価格を確認します。残高が不足している場合は、コンソール残高ページでチャージしてください。
- リクエストでは
Authorization: Bearer <あなたの Token>を使用します。Token はサーバー側の環境変数に保存し、フロントエンドページ、公開リポジトリ、スクリーンショット、またはコールバック URL に書き込まないでください。
本記事のコードはすべて環境変数を読み取ります。
完全なフィールドおよびオンラインデバッグについては Flux Videos APIを、タスク照会については Flux Tasks APIを参照してください。
2. 操作と入力を選択する
生成モデルは
flux-3、action は generate（デフォルト）です。mode を通じて、テキストからの動画生成、画像からの動画生成、動画継続、またはドラフト強化を選択します。
共通生成パラメータ
素材 URL はサービスが読み取れる必要があります。一時的な署名 URL を使用する場合は、ダウンロードと処理に十分な有効期限を確保してください。Web ページのアドレスを画像または動画ファイルのアドレスとして使用しないでください。
3. テキストからの動画生成：完全な実測リクエストと結果
以下のリクエストは、2026-10-02 の価格改定前に本番インターフェースで正常に実行されました。action を省略することでデフォルトの生成動作を検証し、async=true により HTTP 接続の長時間待機を回避しています。
task_id を保存し、引き続き照会してください。ドキュメントのサンプルタスク ID を使用して、他のアカウントの結果を照会しないでください。
response フィールドには、最終的な業務結果が含まれます。以下は今回の実測で成功した response であり、外側のタスクメタデータは省略されています。ドキュメント内の動画 URL は、長期サンプル CDN 上の同一ファイルのコピー（SHA-256 一致）に置き換えられています。実際の呼び出しでは、今回のタスク固有の結果 URL が返されます。
これは価格改定前の過去の実測です：
list_amount=2.9871876975 Credits、当時アカウントには 10% の利用割引があり、実際の amount=2.68846892775 Credits でした。2026-10-02 に新価格は約 6.33% 引き下げられました；同じ 5.041667 秒のドラフトは現在価格で 2.798125185 Credits（利用割引前）であり、引き続き 10% の利用割引がある場合は 2.5183126665 Credits です。過去のタスクの請求額は再計算されません。他のアカウントのプランと割引は異なる場合があります；これはすべてのユーザーに固定された米ドル価格ではありません。
4. 画像から動画：通常と時間付きキーフレーム
以下はパラメータ例であり、素材 URL を置き換える必要があります。この例がすでに正常に実行されたという宣言ではありません。生成完了後は上記のフローに従って照会してください。結果構造は同じです。 1 枚または 2 枚の画像では通常の配列を使用します：[秒数, 画像 URL] のペアを使用します：
画像から動画の実測出力
今回の実測の対応する入力は以下のとおりです（完全な base64 の代わりに説明文のみを使用しており、その他のフィールドは実際のリクエストです）：
この PNG キーフレームをダウンロード 後、Python の base64.b64encode(image_bytes).decode("ascii") を使用して元の文字列を取得し、keyframes 配列に入れることができます。ドキュメント内の説明文を画像入力として使用しないでください。
以下は 2026-10-01 の本番タスクの実際の最終 response（シミュレーション応答ではありません）です；動画 URL のみがハッシュが同じ長期サンプルコピーに置き換えられています。実測入力では、1280×720 PNG の元の base64 文字列を単一のキーフレームとして使用しています；上記の URL 入力は独立したパラメータ例です。
5. 動画の継続
start_video に既存の動画ファイルアドレスを渡し、mode=v2v を指定します。長さは最大 15 秒です。
動画継続の実測出力
今回の完全な実測入力は以下のとおりです。ドラフト強化を再現する際は、自身のドラフト ID に置き換える必要があります。素材 URL には同一ファイルの長期サンプルコピーを使用しています。start_video は完了済みのドラフト動画であり、その他のパラメータは duration=5、resolution=hd、generate_audio=false です。
6. 先にドラフト、後で強化
draft=true、resolution=hdを使用してドラフトを生成し、成功するまで待機します。- 最終的な
data[0].draft_task_idからプラットフォームのドラフト ID を取得します。 - 同一の帰属を持つアプリケーション認証情報を使用して、強化リクエストを送信します。
prompt、duration、aspect_ratio、version、generate_audio、draft、keyframes、start_video を渡して元の内容を上書きすることはできません。ドラフトキャッシュは一時的なリソースですので、速やかに強化してください。永続的な保存または固定の保持日数は保証されません。本人以外／現在のアプリケーション以外のドラフト、未完了のドラフト、期限切れのキャッシュは再利用できません。ドラフトと強化は 2 回のタスクであり、成功後にそれぞれ課金されます。
ドラフト強化の実測出力
今回の完全な実測入力は以下のとおりです。ドラフト強化を再現する際は、自身のドラフト ID に置き換える必要があります。素材 URL には同一ファイルの長期サンプルコピーを使用しています。7. Python エンドツーエンド呼び出し
requests をインストールし、自身の Token を設定して、以下のスクリプトを実行するだけで「1 回送信 → ポーリング → 動画 URL の出力」を完了できます。クエリとネットワーク再試行では、課金タスクの重複送信を避けるため、元の task_id を使用する必要があります。
8. コールバックの使用
送信時にcallback_url を追加すると、タスク完了後にそのアドレスへ最終 JSON 結果が POST されます。成功時の構造は前述の response と一致し、失敗時には error が含まれます。
9. 現在の課金と価格表
2026-10-02 更新：今回、動画インターフェースの各プランの単価は約 6.33% 引き下げられました。計量方式、プラン、および消費割引ルールは変更ありません。前述の過去の実測 response 内の cost はタスク完了時の請求額であり、現在の価格を表すものではありません。 動画生成は実際の出力秒数に基づいて課金されます。以下は現在、アカウント消費割引を適用していない Credits の単価であり、Flux 価格ページ のルールと一致します。
米ドル換算：
実際の費用（USD）= cost.amount（Credits）× プラン price / プラン amount。チャージプランと消費割引は実際の価格に影響し、Credits を直接 USD とみなすことはできません。失敗したタスクには生成料金はかかりません。最終金額は完了結果とコンソールの呼び出し記録に従います。
10. よくある質問とトラブルシューティング
フィードバック時には task_id、trace_id、リクエスト時刻、およびマスキング済みパラメータを提供し、API Token は送信しないでください。その他の方法については、Flux MCP 統合ガイドを参照してください。