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": "sora-2",
    "prompt": "猫咪听歌摇头晃脑，下大雨",
    "size": "1280x720",
    "seconds": "12"
  }'

{
  "id": "video_abc123",
  "task_id": "video_abc123",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600,
  "size": "1280x720",
  "seconds": "12"
}

​
Sora 视频生成

Sora 当前通过 POST /v1/videos 提交异步视频任务。
  • 请求体推荐使用 JSON。
  • 文生视频只需要 model、prompt、size、seconds。
  • 首帧/参考图生视频使用 input_reference，也兼容 image / images。
  • 比例和分辨率使用顶层 size。

​
当前模型

  • sora-2
  • sora-2-pro

​
方法与路径

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": "sora-2",
    "prompt": "猫咪听歌摇头晃脑，下大雨",
    "size": "1280x720",
    "seconds": "12"
  }'

​
响应示例

{
  "id": "video_abc123",
  "task_id": "video_abc123",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600,
  "size": "1280x720",
  "seconds": "12"
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
required
模型名称。当前支持 sora-2 和 sora-2-pro。
​
prompt
string
required
视频生成提示词。
​
size
string
目标尺寸。sora-2 支持 720x1280、1280x720；sora-2-pro 支持 720x1280、1280x720、1792x1024、1024x1792。建议显式传入，避免依赖上游默认值。
​
seconds
string | integer
目标秒数。推荐以字符串传入，例如 "4"、"8"、"12"。部分 OpenAI/OAI Sora 渠道只接受 4、8、12。
​
duration
integer
兼容字段。未传 seconds 时会被作为秒数使用。
​
input_reference
string | array<string>
参考图输入。JSON 中可传图片 URL、base64 或 data URI；也兼容 multipart 的 input_reference 文件字段。
​
image
string
兼容参考图字段。存在时会被视为图生视频输入。
​
images
array<string>
兼容多参考图字段。存在时会被视为图生视频输入。
​
metadata
object
供应商扩展参数。

​
当前规则

项目规则
默认尺寸建议请求中显式传 size，避免依赖默认值
sora-2 尺寸校验720x1280、1280x720
sora-2-pro 尺寸校验720x1280、1280x720、1792x1024、1024x1792
时长校验部分 OAI 渠道限制为 4、8、12 秒
参考图格式JSON 可用 URL、base64、data URI；multipart 仍兼容

​
相关接口