Skip to main content
POST
https://www.geeknow.top
/
v1
/
videos
curl -X POST https://www.geeknow.top/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo_3_1",
    "prompt": "在广场中央跳舞，镜头缓慢推进，电影感光照",
    "size": "1280x720",
    "duration": 10
  }'

{
  "id": "video_abc123",
  "task_id": "video_abc123",
  "object": "video",
  "model": "veo_3_1",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600
}

​
Veo 视频生成

Veo 系列用于提交异步视频生成任务，适合文生视频和带参考图的视频生成场景。
  • 通过 model 选择 veo_3_1 或 veo_3_1-fast
  • 支持 JSON 请求；带本地参考图时也支持 multipart/form-data
  • 异步处理模式，提交成功后返回 id / task_id
  • 任务状态和结果通过 GET /v1/videos/{task_id} 查询

​
当前模型

模型说明
veo_3_1标准质量视频生成模型
veo_3_1-fast更快的视频生成模型

​
方法与路径

POST /v1/videos

curl -X POST https://www.geeknow.top/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo_3_1",
    "prompt": "在广场中央跳舞，镜头缓慢推进，电影感光照",
    "size": "1280x720",
    "duration": 10
  }'

​
响应示例

{
  "id": "video_abc123",
  "task_id": "video_abc123",
  "object": "video",
  "model": "veo_3_1",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600
}

​
认证

使用 Bearer Token 认证： 
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
required
模型名称。可选值：veo_3_1、veo_3_1-fast。
​
prompt
string
required
视频提示词。建议描述主体、动作、镜头、场景、光照和风格。
​
size
string
输出尺寸。常见值：1280x720、720x1280。横向尺寸通常对应 16:9，纵向尺寸通常对应 9:16。
​
duration
integer
目标时长，单位为秒。不同模型可用时长可能不同，建议使用当前模型支持的常见值，例如 8 或 10。
​
image
string
JSON 请求中的单张参考图。支持 Data URL 或 base64 字符串，常用于首帧 / 参考图生视频。
​
images
array<string>
JSON 请求中的参考图数组。当前建议只传一张参考图；如果传入多张，实际效果取决于当前模型支持。
​
input_reference
file | string
参考图字段。使用 multipart/form-data 上传本地图片时，文件字段名为 input_reference；使用 JSON 时建议改用 image 或 images。

​
Response

​
id
string
视频任务 ID。查询任务时使用这个值。
​
task_id
string
兼容字段，通常与 id 相同。
​
object
string
固定为 video。
​
model
string
本次请求使用的模型。
​
status
string
任务状态。常见值包括 queued、in_progress、completed、failed。
​
progress
integer
任务进度百分比。
​
created_at
integer
任务创建时间，Unix 秒级时间戳。
​
completed_at
integer
任务完成时间，Unix 秒级时间戳。任务完成后返回。
​
video_url
string
视频结果地址。任务完成后可在查询接口返回。
​
error
object
任务失败时返回的错误信息。

​
使用场景

场景推荐参数
文生视频model、prompt、size、duration
JSON 参考图生视频model、prompt、size、duration、image
上传参考图生视频multipart/form-data，并上传 input_reference 文件

​
注意事项

  • 这是异步接口，提交成功不代表视频已经生成完成。
  • 提交后请使用 GET /v1/videos/{task_id} 查询任务状态。
  • 参考图建议使用清晰主体和明确构图，避免过小或过度压缩的图片。
  • 不同模型和账户配置可能影响可用时长、尺寸和预计耗时。

​
相关接口