Skip to main content
POST
https://www.geeknow.top
/
v1
/
videos
Sora 视频生成
curl --request POST \
  --url https://www.geeknow.top/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "size": "<string>",
  "seconds": {},
  "input_reference": [
    "<string>"
  ],
  "metadata": {},
  "character_url": "<string>",
  "character_timestamps": "<string>"
}
'
{
  "id": "video_abc123",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600,
  "size": "720x1280"
}

Documentation Index

Fetch the complete documentation index at: https://docs.geeknow.top/llms.txt

Use this file to discover all available pages before exploring further.

​
Sora 视频生成

Sora 系列当前使用 POST /v1/videos 提交任务。和旧文档不同，现有插件脚本里 sora* 模型已经改成 JSON 提交。
  • 路由入口是 POST /v1/videos。
  • main.py 里 sora* 属于 JSON 提交模型。
  • 参考图会先放入 input_reference；脚本会把本地文件转成 Data URL，网关再按上游需要继续处理。
  • router/video-router.go 里 /v1/videos 仍由 controller.RelayTask 统一接收。

​
当前常用模型

  • sora-2
  • sora2-pro-landscape-25s
  • sora2-pro-landscape-hd-10s
  • sora2-pro-landscape-hd-15s
  • sora2-pro-portrait-25s
  • sora2-pro-portrait-hd-10s
  • sora2-pro-portrait-hd-15s
  • sora-2-oai

​
方法与路径

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": "720x1280",
    "seconds": "10",
    "input_reference": "data:image/png;base64,BASE64_IMAGE",
    "metadata": {
      "output_config": {
        "aspect_ratio": "9:16",
        "audio_generation": "Disabled",
        "resolution": "720P"
      }
    }
  }'

​
响应示例

{
  "id": "video_abc123",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600,
  "size": "720x1280"
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
required
模型名称。当前文档重点整理 sora-2，并附带插件里已存在的 Sora2 Pro 变体。
​
prompt
string
required
提示词。
​
size
string
尺寸字符串。脚本层常见值是 720x1280 和 1280x720；网关里 sora-2 当前也只显式校验这两种尺寸。
​
seconds
string | integer
目标秒数。脚本里统一塞入 seconds；网关会兼容字符串和整数。对 sora-2-oai，仓库代码要求必须是 4、8、12 之一。
​
input_reference
string | array<string>
参考图输入。当前脚本会把文件转成 Data URL 注入 JSON；网关侧也兼容 URL、base64、data URI 以及 multipart 文件上传。
​
metadata
object
扩展配置。脚本当前会默认放入 metadata.output_config，常见字段包括 aspect_ratio、audio_generation、resolution。
​
character_url
string
Sora 角色创建所需视频链接。这个字段在通用 DTO 中存在，但从当前路由设计看，更适合配合 /sora/v1/characters 使用，而不是作为 POST /v1/videos 主链路字段。
​
character_timestamps
string
角色片段时间范围，格式如 1,3。同样更适合角色创建链路。

​
当前规则

项目规则
默认尺寸未显式传入时，脚本按 aspect_ratio 推导横屏或竖屏尺寸
sora-2 尺寸校验当前网关只显式接受 720x1280、1280x720
sora-2-oai 秒数校验当前网关要求 4 / 8 / 12
参考图格式JSON 下可用 URL、base64、data URI；multipart 也仍被网关兼容

​
相关接口