视频 API 接入说明

当前仍在上游 2.5 / 30 秒通道验收，公网视频接口暂未开放；开放前请求会返回 503 service_not_ready。以下是下游调用方专用格式。

接口地址：https://api.iooai.cn
模型：genvideo-2.5 · 30 秒 · ¥2.50 / 条

1. 创建 API 令牌

在账户中心创建令牌，分组选择 default。建议使用“不限令牌额度”，实际消费仍受账户余额限制。如果给令牌设置独立额度，需预留少量余额以便查询和下载已提交的任务。

2. 提交任务

POST /v1/videos
Authorization: Bearer sk-你的IOOAI令牌
Content-Type: application/json

{
  "model": "genvideo-2.5",
  "prompt": "清晨的湖面，镜头缓慢推进，柔和的阳光",
  "seconds": "30",
  "ratio": "16:9",
  "images": []
}

ratio 支持 21:9、16:9、4:3、1:1、3:4、9:16。images 可省略，或填写最多 10 个公网图片 URL 字符串；不接受本地路径或图片文件上传。提示词可用 @图1 引用对应图片。

成功提交返回 task_... 形式的任务 ID。请立即保存 ID。提交超时或断网时不要自动重复提交，避免生成重复任务。

3. 查询状态

GET /v1/videos/task_你的任务ID
Authorization: Bearer sk-你的IOOAI令牌

提交后约 5 分钟再开始查询，之后每 30 秒一次。收到 review_required: true 时，表示提交结果待人工核对，请保留任务 ID 并联系站点管理员。

4. 下载视频

任务完成后，使用 output_url 直接下载。也可携带令牌请求 GET /v1/videos/task_你的任务ID/content，接口会跳转至临时下载地址。跳转到下载域名后不要携带 API 令牌。

下载链接由上游提供，存在有效期，请及时保存到你自己的存储。重新查询可尝试刷新链接；如果上游已删除文件，无法恢复。

计费与保存

每次接受的任务先扣 ¥2.50，上游明确报告生成失败、超时失败或取消后自动退款。网络暂时故障、查询失败或下载链接过期不等于生成失败，不会据此自动退款。

IOOAI 不在本机保存视频文件，也不持久保存视频提示词和输入图片。临时下载链接在本机最多缓存一小时；账户、任务编号和账务记录保留用于查询与对账。上游自身的保存期限由上游决定。

5. 最小 cURL 示例

curl https://api.iooai.cn/v1/videos \
  -H "Authorization: Bearer sk-你的IOOAI令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"genvideo-2.5",
    "prompt":"一只可爱的小猫在花园里玩耍",
    "seconds":"30",
    "ratio":"16:9",
    "images":[]
  }'

下游只需要保存自己的 IOOAI 令牌和任务 ID；不要向下游暴露上游 Key、后台地址或服务器凭据。