跳转到主要内容
POST
/
v3
/
async
/
veo-3.1-generate-reference
Veo 3.1 参考图像生成视频
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.1-generate-reference \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "prompt": "<string>",
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "sample_count": 123,
  "enhance_prompt": true,
  "generate_audio": true,
  "negative_prompt": "<string>",
  "reference_images": [
    {}
  ],
  "person_generation": "<string>"
}
'
{
  "task_id": "<string>"
}

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.

使用 Google Veo 3.1 模型通过1-3张参考图像引导生成视频。支持720p和1080p分辨率，支持16:9和9:16宽高比。时长固定为8秒。参考类型仅支持asset。
这是一个异步API，只会返回异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 来检索生成结果。

​
请求头

​
Content-Type
string
必填
枚举值: application/json
​
Authorization
string
必填
Bearer 身份验证格式: Bearer {{API 密钥}}。

​
请求体

​
seed
integer
随机种子，用于复现生成结果。取值范围：[0, 4294967295]
​
prompt
string
必填
描述期望视频内容的文本提示词。
​
resolution
string
默认值:"720p"
输出视频分辨率。可选值：720p, 1080p
​
aspect_ratio
string
默认值:"16:9"
输出视频宽高比。可选值：16:9, 9:16
​
sample_count
integer
默认值:1
生成视频样本数量（1-4）。取值范围：[1, 4]
​
enhance_prompt
boolean
默认值:true
是否使用AI改写提示词以获得更好的生成效果。
​
generate_audio
boolean
默认值:false
是否同时生成音频。
​
negative_prompt
string
描述需要在生成视频中避免的内容。
​
reference_images
array
必填
1-3张参考图像，用于引导视频生成。每个元素包含图像URL或Base64编码数据和参考类型。数组长度：1 - 3
​
person_generation
string
默认值:"allow_adult"
是否允许生成成人人物。allow_adult：允许生成成人；dont_allow：不允许生成人物。可选值：allow_adult, dont_allow

​
响应信息

​
task_id
string
使用 task_id 请求 查询任务结果 API 来检索生成的输出。