哈基米API站

Appearance

异步视频生成 ​

通用异步视频生成接口，用于提交视频生成任务并返回任务 ID。

重要提示 (关于 New API / One API 兼容性)

New API / One API 平台目前不支持 /v1/videos 系列接口。 由于 New API / One API 等中转分发平台仅对标准的 OpenAI 路由（如 /v1/chat/completions 等）进行解析和中转，因此无法通过中转平台调用此接口（会导致 404 或路由失败）。

解决方法：

  1. 直接调用： 绕过中转系统，直接向 https://api.gemai.cc 发起请求。
  2. 改用 OpenAI 兼容的 Seedance 视频生成接口： 使用完美兼容中转平台的 /v1/video/generations 接口（详见 OpenAI 兼容视频生成）。

接口信息 ​

项目值
方法POST
路径/v1/videos
完整地址https://api.gemai.cc/v1/videos
鉴权Authorization: Bearer sk-你的令牌

请求体示例 ​

json
{
  "model": "sora-2",
  "prompt": "一只橘猫在雨后的霓虹街道上奔跑，电影感，慢镜头",
  "size": "1280x720",
  "seconds": 5
}

代码示例 ​

bash
curl --location 'https://api.gemai.cc/v1/videos' \
  --header "Authorization: Bearer $GEMAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "一只橘猫在雨后的霓虹街道上奔跑，电影感，慢镜头",
    "size": "1280x720",
    "seconds": 5
  }'
javascript
const response = await fetch('https://api.gemai.cc/v1/videos', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.GEMAI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'sora-2',
    prompt: '一只橘猫在雨后的霓虹街道上奔跑，电影感，慢镜头',
    size: '1280x720',
    seconds: 5,
  }),
})

console.log(await response.json())
python
import os
import requests

response = requests.post(
    'https://api.gemai.cc/v1/videos',
    headers={
        'Authorization': f"Bearer {os.environ['GEMAI_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'model': 'sora-2',
        'prompt': '一只橘猫在雨后的霓虹街道上奔跑，电影感，慢镜头',
        'size': '1280x720',
        'seconds': 5,
    },
    timeout=120,
)

response.raise_for_status()
print(response.json())

返回示例 ​

json
{
  "id": "video_task_xxx",
  "status": "queued"
}

注意事项 ​

  • 视频生成是异步任务，需要保存任务 ID 后继续查询。
  • 建议每 3-10 秒查询一次任务状态。