> ## 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.

# 万相 Wan 2.7 参照動画生成

万相 Wan 2.7 参照動画生成モデルは、マルチモーダル入力（テキスト/画像/動画）に対応し、人物や物体を主人公として、単一キャラクターのパフォーマンス動画や複数キャラクターのインタラクション動画を生成できます。インテリジェントな絵コンテに対応し、複数ショットの動画を生成できます。720P と 1080P の解像度、2〜10 秒の長さに対応し、秒単位で課金されます。出力にはデフォルトで音声が含まれます。

<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="seed" type="integer">
  生成結果の再現性を高めるための乱数シード。値の範囲は \[0, 2147483647] です。

  値の範囲：\[0, 2147483647]
</ParamField>

<ParamField body="size" type="string" default="1920*1080">
  出力動画の解像度（幅*高さ）。料金に影響します。720P 帯：1280*720（16:9）、720*1280（9:16）、960*960（1:1）、1088*832（4:3）、832*1088（3:4）。1080P 帯：1920*1080（16:9）、1080*1920（9:16）、1440*1440（1:1）、1632*1248（4:3）、1248\*1632（3:4）。

  選択可能な値：`1280*720`, `720*1280`, `960*960`, `1088*832`, `832*1088`, `1920*1080`, `1080*1920`, `1440*1440`, `1632*1248`, `1248*1632`
</ParamField>

<ParamField body="audio" type="boolean" default={true}>
  音声付き動画を生成するかどうか。料金に影響します。デフォルトは true（音声付き動画）です。
</ParamField>

<ParamField body="media" type="object[]" required={true}>
  キャラクターの外見、動作、音色を抽出するための参照メディア配列。配列の順序に従って、prompt 内の character1、character2 などに対応します。画像数は 0〜5、動画数は 0〜3、合計数は 5 を超えないようにしてください。画像形式：JPEG、JPG、PNG、BMP、WEBP、解像度は \[240,8000] ピクセル、10MB 以下。動画形式：MP4、MOV、長さは 1〜30 秒、100MB 以下。音声形式：MP3、WAV、FLAC、長さは 3〜30 秒。

  配列の長さ：1 - 5

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="url" type="string" required={true}>
      メディアファイルの URL。
    </ParamField>

    <ParamField body="type" type="string" required={true}>
      メディアタイプ。reference\_image：キャラクターの外見を抽出するための参照画像；reference\_video：キャラクターの動作と外見を抽出するための参照動画；first\_frame：動画の開始画面を制御するための最初のフレーム画像。

      選択可能な値：`reference_image`, `reference_video`, `first_frame`
    </ParamField>

    <ParamField body="reference_voice" type="string">
      キャラクター参照音声の URL。キャラクターの音色をクローンして音声付き動画を生成するために使用します。形式：MP3、WAV、FLAC、長さは 3〜30 秒。
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  生成動画に含めたい要素や視覚的特徴を記述するためのテキストプロンプト。character1、character2 などの識別子を通じて参照キャラクターを引用します。各参照（動画または画像）には単一のキャラクターのみを含めてください。中国語と英語に対応し、最大 1500 文字です。

  長さの制限：0 - 1500
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  生成動画の長さ。単位は秒で、秒単位で課金されます。値の範囲は \[2, 10] の整数です。

  値の範囲：\[2, 10]
</ParamField>

<ParamField body="shot_type" type="string" default="single">
  ショットタイプ。single は単一ショット（デフォルト）、multi は複数ショットです。このパラメータは prompt よりも優先されます。

  選択可能な値：`single`, `multi`
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  ウォーターマーク識別子を追加するかどうか。ウォーターマークは動画の右下に配置されます。
</ParamField>

<ParamField body="negative_prompt" type="string">
  動画画面に表示したくない内容を記述するためのネガティブプロンプト。中国語と英語に対応し、最大 500 文字です。

  長さの制限：0 - 500
</ParamField>

## レスポンス情報

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