https://router.flatkey.ai
Flatkey は1つの非同期エンドポイントを通じて動画を生成します。タスクを送信し、完了するまでポーリングしてからMP4をダウンロードします。このページでは、すべての動画モデルに共通する内容を説明します。各モデル固有のオプションについては、Seedance または MiniMax H3 を参照してください。
1つの非同期ワークフロー
POST /v1/videos でタスクを作成し、GET /v1/videos/{task_id} でポーリングし、metadata.url からMP4をダウンロードします。2つのリクエスト形式
content 配列を使うモデルと、prompt 文字列を使うモデルがあります。誤った形式を送ると 400 が返されます。動画モデルを探す
すべてのモデルを一覧表示し、type が video のものだけを残します:
適切なリクエスト形式を選ぶ
このエンドポイントは2種類の形式を受け付けており、各モデルはそのうちの1つのみを使用します。prompt モデルに content 配列を送ると、次のレスポンスが返されます:
content 形式
image_url エントリを追加してください。フィールド名はモデルによって異なるため、各モデルのガイドに従ってください。
prompt 形式
解像度はモデルによって異なる
共通の解像度値セットはありません。サポートされていない値を送ると、タスクが作成される前に400 が返されます。
リクエストパラメーター
タスクをポーリングする
送信が成功すると、すぐにタスクが返されます:
約15秒ごとにポーリングしてください。5秒のクリップは通常2〜4分で完成します。
MP4をダウンロードする
ダウンロードURLはmetadata.url に含まれており、同じ認証ヘッダーが必要です:
エンドツーエンドの例
トラブルシューティング
prompt is required
prompt を期待するモデルに content 配列を送信しています。適切なリクエスト形式を選ぶのテーブルを確認してください。
unsupported resolution または resolution must be 768P or 2K
その値は別のモデル向けです。解像度はモデルによって異なるを参照してください。
No available channel for model ...
現在そのモデルはルーティング不可能な状態です。リトライするのではなく、別の動画モデルを選んでください。このエラーは自然には解消されません。現在の利用可能状況はモデルディレクトリで確認してください。
duration must be between 4 and 15
MiniMax-H3 はその範囲の duration を必要とします。明示的に指定してください。
タスクが queued のまま変わらない
動画生成には秒ではなく数分かかります。スタックと判断する前に、15秒間隔でポーリングを続けてください。
モデルガイド
Seedance
テキストから動画への生成に加え、バーチャルおよびリアルな人物のアセットライブラリ。
MiniMax H3
最初と最後のフレームの制御、リファレンスメディア、タスク設定。