> ## 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](/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](/docs/models/reference-get-async-task-result) 来检索生成的输出。
</ResponseField>