Skip to main content
通过 即刻API 直连 Azure OpenAI Sora 2 官方端点（sora-2-official），支持文本生成视频和图生视频，所有任务均为异步处理。

​
请求参数

​
model
string
required
视频生成模型名称。支持的模型：
  • sora-2-official — Azure Sora 2 官方模型
示例："sora-2-official"
​
prompt
string
required
视频生成的自然语言描述。建议包含镜头类型、主体、动作、场景、光线和相机运动，以减少歧义。保持描述单一目的以获得最佳效果。示例："一只金毛犬在草地上奔跑，阳光明媚"
​
duration
integer
default:"4"
视频时长（秒）。支持的值：
  • 4 — 4 秒（默认）
  • 8 — 8 秒
  • 12 — 12 秒
示例：12
​
aspect_ratio
string
default:"9:16"
视频宽高比。支持的格式：
  • 16:9 — 横屏（1280×720）
  • 9:16 — 竖屏（720×1280，默认）
​
image_urls
string[]
用于图生视频的参考图像 URL 数组。⚠️ 仅支持 URL 格式
  • 公开可访问的图像 URL（http:// 或 https://）
  • 可使用上传图片接口上传本地图片获取 URL
  • 仅使用第一张图片作为参考
  • 支持格式：JPEG、PNG、WebP
  • 图片尺寸必须为 1280×720（16:9）或 720×1280（9:16）

​
请求示例

curl --request POST \
  --url https://geekapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-official",
    "prompt": "一只金毛犬在草地上奔跑，阳光明媚",
    "duration": 12,
    "aspect_ratio": "16:9"
  }'

​
返回示例

200
{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "sora-2-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {
    "size": "1280x720",
    "seconds": "12"
  }
}

​
响应字段

字段类型说明
idstring任务唯一标识符，用于查询任务状态
objectstring对象类型，固定为 generation.task
modelstring使用的模型名称
statusstring任务状态：queued / in_progress / completed / failed
progressinteger任务进度百分比（0–100）
created_atinteger任务创建时间戳（Unix 时间戳）
metadataobject任务元数据，包含尺寸和时长信息

​
查询任务状态

提交后，使用以下接口轮询任务进度： 
GET https://geekapis.com/v1/videos/generations/{task_id}