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": "Kling-3.0-Omni",
    "prompt": "死寂系统空间中，角色被蓝色面板照亮",
    "seconds": "15",
    "size": "1280x720"
  }'

​
国产视频模型生成

国产视频模型统一使用 Geeknow 视频接口提交任务。请求时传入基础模型或组合计费模型，接口会根据模型、分辨率、场景和音频等参数应用对应生成配置与计费规则。

​
方法与路径

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": "Kling-3.0-Omni",
    "prompt": "死寂系统空间中，角色被蓝色面板照亮",
    "seconds": "15",
    "size": "1280x720"
  }'

​
请求字段

​
model
string
required
模型名称。推荐传基础模型，例如 Kling-2.6、Vidu-q2-pro、GV-3.1-fast；也可以直接传组合计费模型，例如 kling-3.0-omni-1080p-ref-audio、vidu-q2-pro-reference-1080p-offpeak。
​
prompt
string
required
提示词。文生视频必须传；图生、参考图、动作控制等场景也建议传清楚运动、镜头、主体和风格。
​
seconds
string | integer
生成时长。顶层 seconds 优先级最高，例如 "seconds": "5"。
​
duration
integer
时长兼容字段。优先级低于顶层 seconds。
​
size
string
快速尺寸字段，支持 720P / 1080P，也支持 WxH，例如 720x1280。
​
image
string
单张参考图或首帧图。当前支持可访问的 http(s) 图片 URL 或文件 ID；不支持 data:image/...;base64,... 这类 base64 data URI。
​
images
array<string>
多张参考图。每张图会作为图片素材处理；最多 3 张。
​
input_reference
string | array<string>
参考图兼容字段。国产模型侧建议优先使用 image / images。

​
参数优先级

时长优先级：
  1. 顶层 seconds
  2. 顶层 duration
  3. 默认 5
分辨率优先级：
  1. 顶层 size
  2. 模型默认值
文生 / 图生判定：
  • 有 image、images 或 input_reference 这类参考输入时，按图生或参考输入场景处理。
  • 没有参考输入时，按文生视频处理。

​
场景字段

场景关键字段
文生视频model + prompt + seconds + size
图生视频image / images / input_reference
多图参考images
首尾帧支持的模型可按顺序传入 images

​
size 规则

  • 顶层 size 支持 720P / 1080P，也支持 WxH。
  • 当只传 size=WxH 时，接口会推导分辨率和宽高比。
示例：
  • size=720x1280 + model=Kling-3.0-Omni 会推导为竖屏视频。
  • size=1280x720 + model=Kling-3.0-Omni 会推导为横屏视频。

​
相关页面