veo-3.1 视频生成（文生 / 图生 / 首末帧 / 参考图）
POST
https://api.tokenhot.ai/v1/video/generations
POST https://api.tokenhot.ai/v1/video/generationsveo-3.1-fast / veo-3.1-fast-generate-preview / veo-3.1-generate-previewtask_id，需用 GET /v1/video/generations/{task_id} 轮询任务状态；完成后 data.url 为可直接播放/下载的视频地址。四种生成模式（统一走本接口，靠不同字段区分）
| 模式 | 关键字段 |
|---|---|
| 文生视频 | 仅 prompt（不传图片） |
| 图生视频 | images[0]（首帧 data URI base64） |
| 首末帧 | images[0]（首帧） + metadata.lastFrame（尾帧 data URI base64） |
| 参考图 | metadata.referenceImages（1–3 张 data URI base64，保持主体一致性，时长固定 8s） |
重要约束
data:image/jpeg;base64,...），不接受图片 URL；建议 720p 以上、≤ 8MB。metadata.personGeneration 仅支持 allow_adult；文生支持 allow_all。1080p / 4k 仅支持 8 秒时长；size 会自动换算成 resolution + aspectRatio。8。Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.tokenhot.ai/v1/video/generations' \
--header 'Content-Type: application/json' \
--data '{
"model": "veo-3.1-fast",
"prompt": "一只猫在窗台上看雨，电影感镜头，背景有轻柔的钢琴声",
"metadata": {
"resolution": "720p",
"aspectRatio": "16:9",
"personGeneration": "allow_all",
"durationSeconds": 8
}
}'Response Response Example
200 - 成功示例
{
"id": "task_xcbYdpdSgpns4prSfsfsokvve1xKyPXl",
"task_id": "task_xcbYdpdSgpns4prSfsfsokvve1xKyPXl",
"object": "video",
"model": "veo-3.1-fast",
"status": "queued",
"progress": 0,
"created_at": 1780993030
}