メインコンテンツへスキップ
POST

認証

Authorization
string
必須
すべてのAPIエンドポイントはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してください使用時はリクエストヘッダーに追加します:

生成モード

SkyReels V4 はリクエストフィールドに応じて自動的に対応モードへルーティングします。mode フィールドを指定する必要はありません
厳格な排他性:I2V フィールド(first_frame_image / end_frame_image / mid_frame_images)と Omni フィールド(ref_images / ref_videos)は同時に使用できません。違反した場合は 422 を返します。
@tag メカニズムmid_frame_images / ref_images / ref_videos を使用する際、各要素は @ で始まる tag(例:@image1@Actor-1@video1)を宣言し、その tag必ず prompt 内に出現する必要がありますprompt を「脚本」、tag を具体的な素材(画像 / 動画)を指す「キャラクターポインタ」と考えてください。例えば prompt に "@Actor-1 が @video1 のシーンに入る" と書くと、システムは @Actor-1 に対応する参照画像の被写体と @video1 に対応する動作参照を生成過程に注入します。

リクエストパラメータ

共通フィールド

model
string
必須
以下の 2 つの段階をサポート:
model フィールドは明示的に渡す必要があります。デフォルト値はありません。
料金は解像度と ref_videos の使用有無と強く関連します:1080p は 480p / 720p より大幅に高価、ref_videos(動画入力あり)は動画入力なしの約 1.5~2 倍です。音声と動画の同時出力は現在サポートされていません。
prompt
string
必須
テキストプロンプト、最大 1280 tokensシーン、被写体、動作、スタイルなどを詳しく記述すると、より良い生成結果が得られます。ref_images / ref_videos / mid_frame_images を使用する場合、prompt には対応する @tag(例:@Actor-1@video1@image1)を必ず含める必要があります。例:"@Actor-1 walks through a neon-lit street at night."
duration
integer
デフォルト:"5"
出力動画の長さ(秒)
  • 範囲:[3, 15]
  • デフォルト:5
ref_videos.type=reference を渡した場合、duration は参照動画の長さで上書きされます(上限 10 秒)。
resolution
string
デフォルト:"1080p"
動画解像度選択肢:
  • 480p
  • 720p
  • 1080p(デフォルト)
aspect_ratio
string
デフォルト:"16:9"
アスペクト比選択肢:
  • 16:9(デフォルト)
  • 4:3
  • 1:1
  • 9:16
  • 3:4
I2V モードでは aspect_ratio は無視されます(出力比率は入力画像によって決まります);Omni が ref_videos を伴う場合も同様に無視されます。
prompt_optimizer
boolean
デフォルト:"true"
プロンプトを自動最適化するかどうか有効にすると、システムが自動的にプロンプトを最適化し、より良い生成結果を得られるようにします。

I2V 専用フィールド

first_frame_image
string
動画の先頭フレーム画像 URL(jpg / jpeg / png / gif / bmp)指定すると、この画像が動画の 先頭画面 として使用されます。
end_frame_image
string
動画の末尾フレーム画像 URL(jpg / jpeg / png / gif / bmp)指定すると、この画像が動画の 末尾画面 として使用されます。first_frame_image と組み合わせて先頭・末尾フレーム制御が可能です。
mid_frame_images
object[]
中間キーフレームリスト、最大 6 個。各要素の構造は以下のとおり:

Omni 専用フィールド

ref_images
object[]
参照画像リスト(すべての要素の type は一致する必要があります)。各要素の構造は以下のとおり:
ref_videos
object[]
参照動画リスト、最大 1 個。各要素の構造は以下のとおり:

サポートされる生成シーン

以下のシーンは skyreels-v4-fastskyreels-v4-std両方 でサポートされます:

パラメータ制約

以下の制約に違反した場合、リクエストは拒否され 422 を返します。課金は発生しません

レスポンス

code
integer
レスポンスステータスコード、成功時は 200
data
array
レスポンスデータ配列

リクエスト例

ケース 1:テキストから動画(最小)

ケース 2:テキストから動画(完全パラメータ)

ケース 3:画像から動画 - 先頭フレーム

ケース 4:画像から動画 - 先頭・末尾フレーム + 中間キーフレーム

ケース 5:Omni - 単一被写体参照

ケース 6:Omni - 複数被写体 + 動画モーション参照

このケースは ref_videos.type=reference を使用するため、リクエストの duration は参照動画の実際の長さで上書きされます(上限 10 秒)。ここで "duration": 5 を渡しても、最終的な動画長は参照動画に従います。

ケース 7:Omni - グリッドコラージュ(grid)

ケース 8:Omni - 動画拡張(extend)

ケース 9:Omni - 声紋付き(音声同期)

タスク結果の照会動画生成は非同期タスクで、提出後に task_id が返されます。タスク状態取得 エンドポイントを使用して生成の進捗と結果を照会してください。