Skip to main content
POST

認証

string
必須
すべてのリクエストで Bearer Token 認証が必要です。API Key の取得:API Key 管理ページ にアクセスして API Key を取得してください。リクエスト時に次のヘッダーを追加します:

リクエストパラメータ

string
必須
動画生成モデル名。固定値は Omni-Flash-Ext です。
string
必須
動画内容の説明。シーン、人物、動作、環境、カメラワーク、映像スタイル、音声のヒントを詳しく記述することをおすすめします。例:"a girl is dancing happily in a sunny garden"
integer
デフォルト:"6"
動画時間。単位は秒です。対応値:46810
57 などの値を指定すると invalid_duration エラーが返されます。
参照動画をアップロードする場合、duration を指定する必要はありません。durationvideo_urls は同時に指定できません。
string
デフォルト:"720p"
動画解像度。大文字と小文字は区別されません。対応値:
  • 720p
  • 1080p
  • 4k
その他の解像度を指定すると invalid_resolution エラーが返されます。
string
デフォルト:"16:9"
動画のアスペクト比。横向きまたは縦向きの出力を制御します。よく使う値:
  • 16:9 - 横向き
  • 9:16 - 縦向き
デフォルト:16:9
string
互換フィールドです。aspect_ratio と同じ意味です。両方を指定する場合は同じ値にしてください。
string
生成タイプ。画像の使用方法を指定します。指定可能な値:
  • frame - 始点フレームモード。image_urls には画像を 1 枚のみアップロードでき、動画の始点フレームとして使用されます。
  • reference - 参照モード。image_urls には画像を 1 枚または 3 枚アップロードでき、参照画像として使用されます。
generation_typeframe の場合、image_urls は 1 枚のみ対応します。他の枚数を渡すと unsupported_image_count エラーが返されます。
array<url>
参照画像 URL 配列。generation_type に応じて、省略、1 枚、または 3 枚を指定できます:
  • 省略または空配列:テキストから動画
  • 1 枚:単一画像から動画
  • 3 枚:参照画像融合(generation_typereference の場合のみ対応)
generation_type との関係:
  • generation_typeframe:画像を 1 枚のみアップロードできます。
  • generation_typereference:画像を 1 枚または 3 枚アップロードできます。
公開アクセス可能な画像 URL のみ対応しています。
2 枚画像による始点フレーム + 終点フレームのモードはサポートしていません。2 枚を渡すと unsupported_image_count エラーが返されます。4 枚以上は十分に検証されていないため推奨しません。
array<url>
参照動画 URL 配列。省略、または 1 本の参照動画を指定できます。公開アクセス可能な HTTP/HTTPS 動画 URL のみ対応しています。image_urls と同時に指定できます。画像は人物や構図の参照として、動画は動きの参照として使用されます。
Omni-Flash-Ext は 0 または 1 本の参照動画のみ対応しています。2 本以上を渡すと unsupported_video_count エラーが返されます。
video_urls を指定する場合、duration を指定する必要はありません。video_urlsduration は同時に指定できません。

レスポンス

integer
レスポンスステータスコード。成功時は 200 です。
array
タスク配列を返します。

タスク結果の照会

動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータス取得 API を使用して進捗と結果を照会します。
cURL
送信後 5-10 秒待ってから最初の照会を行い、その後は 5-10 秒ごとにポーリングすることをおすすめします。1 つのタスクは通常約 3-5 分で完了します。

成功結果の例

失敗結果の例

ユースケース

シナリオ 1:テキストから動画

シナリオ 2:単一画像から動画

シナリオ 3:3 枚の参照画像融合

シナリオ 4:4K ショート動画

シナリオ 5:参照動画生成

エラーコード

タスクが失敗した場合、タスクステータス API は data.error に失敗理由を返します。よくある原因には、上流の一時的なクォータ不足、コンテンツ審査不通過、上流タイムアウトがあります。