Skip to main content
ベースURL: 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 が返されます。
このページのすべてのリクエスト(ダウンロードを含む)には、次の認証ヘッダーを使用してください:

動画モデルを探す

すべてのモデルを一覧表示し、typevideo のものだけを残します:
/v1/models はクエリパラメーターを無視します。フィルタリングは、上記の jq の例のように、自分のコード内で行ってください。
同じ一覧を料金付きでモデルディレクトリでも参照できます。

適切なリクエスト形式を選ぶ

このエンドポイントは2種類の形式を受け付けており、各モデルはそのうちの1つのみを使用します。 prompt モデルに content 配列を送ると、次のレスポンスが返されます:

content 形式

この配列には画像も含めることができます。フレーム間の補間やリファレンスとして使用する場合は、image_url エントリを追加してください。フィールド名はモデルによって異なるため、各モデルのガイドに従ってください。

prompt 形式

解像度はモデルによって異なる

共通の解像度値セットはありません。サポートされていない値を送ると、タスクが作成される前に 400 が返されます。
解像度を選ぶ前に各モデルのガイドを確認してください。1080pseedance-2.5 では拒否され、720pMiniMax-H3 では拒否されます。

リクエストパラメーター

aspect_ratioseed はエラーなしで受け付けられますが、すべてのモデルで出力に影響するわけではありません。grok-imagine-video では 9:16 を指定しても 848x480 の横長クリップが返され、同じ seed を指定しても毎回異なるファイルが生成されます。モデルが向きをサポートしている場合は、そのモデルのページに記載されています。この2つのフィールドをモデル横断的な動作として使用しないでください。

タスクをポーリングする

送信が成功すると、すぐにタスクが返されます:
タスクIDを使ってステータスが終了状態になるまでポーリングします:
約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

最初と最後のフレームの制御、リファレンスメディア、タスク設定。