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

# Veo 3.0 Preview 图生视频

使用 Veo 3.0 Preview 视频生成模型，通过输入图像和文本描述生成高质量视频内容。该接口采用异步处理方式，需要通过 task\_id 查询最终生成结果。

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式: Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="prompt" type="string" required={true}>
  描述您想要生成的视频的文本字符串。
</ParamField>

<ParamField body="image_url" type="string" required={false}>
  输入图像的 URL。image\_url 与 image\_base64 需要提供其中一个。
</ParamField>

<ParamField body="image_base64" type="string" required={false}>
  Base64 编码的输入图像。
</ParamField>

<ParamField body="aspect_ratio" type="string" required={false}>
  指定生成视频的宽高比。

  枚举值: `16:9`、`9:16`。默认值为 `16:9`。
</ParamField>

<ParamField body="duration_seconds" type="integer" required={false}>
  您想要生成的视频文件的长度（秒）。

  枚举值: `4`、`6`、`8`。默认值为 `8`。
</ParamField>

<ParamField body="enhance_prompt" type="boolean" required={false}>
  指定是否使用 Gemini 增强您的提示词。

  默认值: `true`
</ParamField>

<ParamField body="generate_audio" type="boolean" required={true}>
  指定是否为视频生成音频。
</ParamField>

<ParamField body="negative_prompt" type="string" required={false}>
  描述您想要阻止模型生成的内容的文本字符串。
</ParamField>

<ParamField body="person_generation" type="string" required={false}>
  控制是否允许人物或面部生成的安全设置。

  枚举值:

  * `allow_adult` (默认): 仅允许生成成人
  * `dont_allow`: 不允许在图像中包含人物或面部
  * `allow_all`: 允许生成所有年龄段的人物（需项目在 allowlist 中）
</ParamField>

<ParamField body="resolution" type="string" required={false}>
  生成视频的分辨率。

  枚举值: `720p` (默认) 或 `1080p`
</ParamField>

<ParamField body="sample_count" type="integer" required={false}>
  要生成的视频样本数量。

  取值范围: 1-4
</ParamField>

<ParamField body="seed" type="uint32" required={false}>
  用于初始化随机生成过程的数字。使用相同的种子、提示词和其他参数会产生相同的输出视频，使生成过程具有确定性。

  取值范围: 0-4,294,967,295
</ParamField>

## 响应信息参数

<ResponseField name="task_id" type="string" required={true}>
  异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/docs/models/reference-get-async-task-result) 以获取生成结果
</ResponseField>