curl --request POST \
--url https://api.tikway.ai/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "veo-3.1-fast",
"prompt": "一只金毛寻回犬在日落时分的海滩上奔跑，镜头平稳跟随，画面具有自然细腻的电影质感。",
"duration": 8,
"resolution": "1080p",
"aspect_ratio": "16:9"
}
'{
"id": "9552de3d-171f-4cca-b492-7baa56523239",
"status": "pending",
"polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}创建 Veo 视频
通过统一的 POST /v1/videos 创建 Veo 视频任务。模型能力以当前 Tikway 网关实际可调用范围为准。
| 模型 | 分辨率 | 时长 | 支持模式 | 音频 | 参考限制 |
|---|---|---|---|---|---|
veo-3.1-fast | 720p / 1080p | 当前网关固定 8 秒 | 文生、首帧、首尾帧、最多 3 图参考 | 始终生成，不能关闭 | 不支持视频输入/延长的统一入口 |
veo-3.1-quality | 720p / 1080p | 当前网关固定 8 秒 | 文生、首帧、首尾帧、最多 3 图参考 | 始终生成，不能关闭 | 不支持视频输入/延长的统一入口 |
veo-3.1-lite | 720p / 1080p | 当前网关固定 8 秒 | 文生、首帧、首尾帧；不支持普通参考图模式 | 始终生成，不能关闭 | 不支持视频输入/延长的统一入口 |
来源：Google Veo 3.1 API。官网能力与当前网关未开放能力之间的差异见本次审计报告。
curl --request POST \
--url https://api.tikway.ai/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "veo-3.1-fast",
"prompt": "一只金毛寻回犬在日落时分的海滩上奔跑，镜头平稳跟随，画面具有自然细腻的电影质感。",
"duration": 8,
"resolution": "1080p",
"aspect_ratio": "16:9"
}
'{
"id": "9552de3d-171f-4cca-b492-7baa56523239",
"status": "pending",
"polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
创建 Veo 视频任务。参数按当前 Tikway 网关能力收窄；模型之间的差异见 operation 描述与 x-model-capabilities。
Veo 模型 ID。
veo-3.1-fast, veo-3.1-quality, veo-3.1-lite 视频生成或编辑提示词。
1当前 Tikway 路由固定生成 8 秒视频。Google 原生 Veo 3.1 还支持 4 秒和 6 秒，但当前网关尚未开放。
视频宽高比。图生视频时，部分模型会按输入素材自动决定比例。
16:9, 9:16 输出分辨率。不同模型或模式的可用值见模型能力表。
720p, 1080p 最多 3 张参考图。Veo 3.1 Lite 不支持普通参考图模式；首帧和尾帧请使用 frame_images。
3用户任务回调地址。由 Tikway 在任务状态变化后调用，不直接传给模型上游。
^https://响应
POST /v1/videos 创建视频任务成功后的响应参数，接口返回 HTTP 202。
视频生成任务的唯一标识，用于后续查询任务状态。
1"9552de3d-171f-4cca-b492-7baa56523239"
任务创建状态。pending 表示任务已创建、等待提交处理；queue 表示任务已进入生成队列。
pending, queue "queue"
视频任务查询地址，客户端可通过 GET 请求轮询任务状态。
^https://"https://api.example.com/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"