RouteMarket 文档
API 手册视频

Sora 视频生成

OpenAI Sora 兼容视频任务接口

本页整理 RouteMarket 的 Sora 视频生成 兼容接口,包括可识别的端点、结构化参数和请求示例。

兼容性提示:页面由公开协议中的技术字段生成。具体模型、额度和路由能力以 RouteMarket 控制台及实际网关响应为准。

接口地址

  • DELETE https://api.routemarket.ai/v1/videos/task_xxx

参数参考

参数表 1

能力方法路径说明
创建任务POST/v1/videos-
查询任务GET/v1/videos/{video_id}-
下载文件GET/v1/videos/{video_id}/content-
删除任务DELETE/v1/videos/{video_id}-

参数表 2

模型说明
sora-2-

参数表 3

status说明
queued-
in_progress-
completed-
failed相关值:error.message

参数表 4

问题处理方式
查询不到任务检查 video_id 是否为创建响应里的 id
一直生成中视频任务耗时较长,建议每 2 到 3 秒轮询一次
下载失败优先使用 output 直链,或稍后重试下载接口

请求与响应示例

示例 1

Authorization: Bearer $ROUTEMARKET_API_KEY

示例 2

{
  "id": "task_xxx",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "size": "1280x720",
  "seconds": "8",
  "progress": 0,
  "created_at": 1760000000
}

示例 3

curl https://api.routemarket.ai/v1/videos/task_xxx \
  -H "Authorization: Bearer $ROUTEMARKET_API_KEY"

示例 4

{
  "id": "task_xxx",
  "object": "video",
  "model": "sora-2",
  "status": "completed",
  "progress": 100,
  "output": "https://api.routemarket.ai/videos/task_xxx.mp4",
  "created_at": 1760000000,
  "completed_at": 1760000090
}

示例 5

curl https://api.routemarket.ai/v1/videos/task_xxx/content \
  -H "Authorization: Bearer $ROUTEMARKET_API_KEY" \
  --output output.mp4

示例 6

curl -X DELETE https://api.routemarket.ai/v1/videos/task_xxx \
  -H "Authorization: Bearer $ROUTEMARKET_API_KEY"

示例 7

import time
import requests

API_BASE = "https://api.routemarket.ai"
API_KEY = "sk-xxx"

task = requests.post(
    f"{API_BASE}/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    },
    json={
        "model": "sora-2",
        "prompt": "镜头缓慢推进,一只未来感狐狸站在雨夜霓虹街头",
        "size": "1280x720",
        "seconds": "8",
    },
    timeout=60,
).json()

task_id = task["id"]

while True:
    result = requests.get(
        f"{API_BASE}/v1/videos/{task_id}",
        headers={"Authorization": f"Bearer {API_KEY}"},
        timeout=60,
    ).json()

    if result["status"] == "completed":
        print(result["output"])
        break

    if result["status"] == "failed":
        raise RuntimeError(result.get("error", {}).get("message", "生成失败"))

    time.sleep(3)

接入说明

  • API 基础地址:https://api.routemarket.ai
  • 推荐密钥环境变量:ROUTEMARKET_API_KEY
  • 请求使用 Authorization: Bearer <API_KEY>
  • 上线前请用实际账号验证端点、模型名、限额与异步任务状态。