Veo 视频生成
Veo 通过 OpenAI 格式入口提交异步视频任务，返回带 id、status、progress 的任务对象，结果用任务查询接口轮询。
http
POST /v1/videos任务提交为异步：创建成功不代表生成完成，请用返回的任务 ID 轮询状态，完成后从结果中的视频地址读取。
当前可用模型
请求头
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 请求身份认证。使用 Bearer Token，示例： | |
| string | 是 | 请求内容类型，必须设置为 |
请求体
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | 是 | 模型名称 | |
| string | 是 | 提示词，描述要生成的视频内容 | |
| string | 否 | 尺寸字符串。常见传 或 ，并据此推导 Veo 的分辨率和宽高比 | |
| string | integer | 否 | 目标时长。当前通过 提交；网关也兼容 与 | |
| string | array<string> | 否 | 参考图输入。JSON 请求可使用 URL、base64、Data URI；Veo 适配层兼容 multipart 文件上传 | |
| object | 否 | 扩展配置。Veo 链路会解析到上游的 、、 等字段 | |
| boolean | 否 | 高清增强。注意：非通用 DTO 顶层字段，建议用 与 表达清晰度或分辨率 |
请求示例
bash
curl -X POST https://octopusx.ai/v1/videos \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"model": "veo_3_1-fast",
"prompt": "在广场中央跳舞",
"size": "720x1280",
"seconds": "8",
"input_reference": "data:image/png;base64,BASE64_IMAGE"
}'响应示例
json
{
"id": "video_abc123",
"object": "video",
"model": "veo_3_1-fast",
"status": "queued",
"progress": 0,
"created_at": 1735689600,
"seconds": "8",
"size": "720x1280"
}响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
| string | 任务 ID，后续轮询使用 | |
| string | 固定为 | |
| string | 实际使用的模型 | |
| string | 任务状态，常见 、、 | |
| integer | 进度 0–100 | |
| integer | 创建时间戳 | |
| string | 请求时长 | |
| string | 请求尺寸 |
生成规则
| 项目 | 规则 |
|---|---|
| 请求格式 | JSON |
| 参考图格式 | 支持 URL、base64、Data URI，也兼容 multipart 文件 |
| 参考生视频模式 | 会把宽高比强制收敛到 |
| 参数映射 | 会进一步映射到 Veo 所需的 、 |
其它格式与模式
Remix（/v1/videos/{video_id}/remix）
在已完成或可用的 Veo 任务基础上提交新的 remix 任务，仍返回 OpenAI 风格 video 对象。路径参数 为原视频任务 ID；请求体为 JSON，同时提供 （remix 常用示例 ，以当前渠道实际可用为准）与 。新任务响应中的 会指向源视频 ID。