メインコンテンツへスキップ
POST
/
v3
/
async
/
pixverse-pixverse-c1-reference-to-video
Pixverse C1 参照画像から動画生成
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/pixverse-pixverse-c1-reference-to-video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "images": [
    {
      "type": "<string>",
      "ref_name": "<string>",
      "image_url": "<string>"
    }
  ],
  "prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "generate_audio_switch": true
}
'
{
  "task_id": "<string>"
}
Pixverse C1 参照画像から動画生成ツールは、1〜7枚の参照画像に基づいて映画品質の動画を生成できます。プロンプト内で @ref_name 構文を使用して参照画像を引用でき、複数のキャラクター/オブジェクトの一貫性、複数解像度(360p〜1080p)、可変長(1〜15秒)、および音声生成に対応しています。
これは非同期APIであり、非同期タスクの task_id のみを返します。この task_id を使用して タスク結果照会 API にリクエストし、生成結果を取得してください。

リクエストヘッダー

Content-Type
string
必須
列挙値: application/json
Authorization
string
必須
Bearer 認証形式: Bearer {{API キー}}。

リクエストボディ

images
array
必須
参照画像リスト(1〜7枚)配列長:1 - 7
prompt
string
必須
シーン説明テキスト。@ref_name 構文を使用してアップロードした参照画像を引用します(例:「@hero が @city の中を走る」)。@ref_name の後にはスペースが必要で、引用名は images 内の ref_name と一致している必要があります
duration
integer
デフォルト:5
生成する動画の長さ(秒)。範囲は 1〜15値の範囲:[1, 15]
resolution
string
デフォルト:"720p"
出力動画の解像度指定可能な値:360p, 540p, 720p, 1080p
aspect_ratio
string
デフォルト:"16:9"
出力動画のアスペクト比指定可能な値:16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9
generate_audio_switch
boolean
デフォルト:false
動画のネイティブ音声も同時に生成するかどうか

レスポンス情報

task_id
string
必須
task_id を使用して タスク結果照会 API にリクエストし、生成された出力を取得します。