> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pixverse C1 参照画像から動画生成

Pixverse C1 参照画像から動画生成ツールは、1〜7枚の参照画像に基づいて映画品質の動画を生成できます。プロンプト内で @ref\_name 構文を使用して参照画像を引用でき、複数のキャラクター/オブジェクトの一貫性、複数解像度（360p〜1080p）、可変長（1〜15秒）、および音声生成に対応しています。

<Tip>
  これは**非同期**APIであり、非同期タスクの task\_id のみを返します。この task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成結果を取得してください。
</Tip>

## リクエストヘッダー

<ParamField header="Content-Type" type="string" required={true}>
  列挙値: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 認証形式: Bearer \{\{API キー}}。
</ParamField>

## リクエストボディ

<ParamField body="images" type="object[]" required={true}>
  参照画像リスト（1〜7枚）

  配列長：1 - 7

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="type" type="string" required={true}>
      参照画像タイプ：subject は参照画像の人物/オブジェクトを主体として動画生成を行うことを表します。background は参照画像のシーン/環境を背景として動画生成を行うことを表します

      指定可能な値：`subject`, `background`
    </ParamField>

    <ParamField body="ref_name" type="string" required={true}>
      参照画像の短い識別名。prompt 内で @ref\_name 構文によりこの参照画像を引用するために使用します。@ref\_name の後にはスペースが必要です
    </ParamField>

    <ParamField body="image_url" type="string" required={true}>
      参照画像の URL アドレス
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  シーン説明テキスト。@ref\_name 構文を使用してアップロードした参照画像を引用します（例：「@hero が @city の中を走る」）。@ref\_name の後にはスペースが必要で、引用名は images 内の ref\_name と一致している必要があります
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  生成する動画の長さ（秒）。範囲は 1〜15

  値の範囲：\[1, 15]
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  出力動画の解像度

  指定可能な値：`360p`, `540p`, `720p`, `1080p`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  出力動画のアスペクト比

  指定可能な値：`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9`
</ParamField>

<ParamField body="generate_audio_switch" type="boolean" default={false}>
  動画のネイティブ音声も同時に生成するかどうか
</ParamField>

## レスポンス情報

<ResponseField name="task_id" type="string" required={true}>
  task\_id を使用して [タスク結果照会 API](/ja/docs/models/reference-get-async-task-result) にリクエストし、生成された出力を取得します。
</ResponseField>