IOOAI API 统一文档
一份文档覆盖全部模型。模型、价格、格式限制都实时读取线上配置,新上的模型会自动出现在这里。
快速开始(所有视频模型通用)
所有视频模型用同一个接口,只换 model 和各模型支持的字段。流程:提交任务 → 拿到 id → 轮询查询 → status 为 completed 后读取 output_url 下载视频。
| 步骤 | 接口 | 说明 |
|---|---|---|
| 1 提交 | POST /v1/videos | JSON 请求体;也可用 multipart/form-data 直接上传参考文件(仅标注“支持直传”的模型)。成功返回任务 id(形如 task_xxx),此时按模型价格预扣费用。 |
| 2 查询 | GET /v1/videos/{id} | 建议每 10–20 秒查一次。status:queued / in_progress / submission_uncertain / completed / failed。 |
| 3 下载 | output_url | 完成后返回下载链接;若 download_ready 为 false 表示还在转存,稍后再查即可。链接有有效期,请尽快下载保存。 |
| 查模型 | GET /v1/models | 返回当前 key 有权限使用的全部模型。 |
通用字段:model(必填)、prompt(必填)、seconds(时长,见各模型)、ratio(比例,见各模型)、images / videos / audios(参考素材链接数组,上限见各模型)。各模型的专属字段写在下面的模型说明里。
加载中…
我的 key 能用哪些模型
输入你的 API key,只显示这个 key 能调用的模型。key 只在你的浏览器里直接发给 API,不会经过本页面的服务器,也不会被保存。
全部模型总览
| 加载中… |
逐个模型说明
错误与注意事项
| 情况 | 说明 |
|---|---|
| HTTP 400 | 参数不符合该模型的限制(时长、比例、素材数量等),error.message 会说明原因,请对照本页修改;不扣费。 |
| HTTP 401 / 403 | key 无效、已过期,或这个 key 没有该模型的权限。 |
| HTTP 402 / 余额不足 | 余额不够本次费用(按秒计费模型 = 单价 × 秒数)。 |
| HTTP 429 | 提交过快或当前线路繁忙,稍等几秒后重试。 |
| HTTP 503「结果不确定」 | 网络中断导致无法确认是否提交成功,不要立刻重复提交,先用已有任务 id 查询或联系客服。 |
status: failed | 生成失败会自动退还本次费用。 |
status: submission_uncertainreview_required: true | 提交结果尚未确认,需核实是否已受理;此时 progress 为 0,预扣金额待核对。保存原任务 id 并继续查询,请勿重复提交。兼容旧响应时,review_required: true 同样表示待核实,不能视为正在生成。 |
参考素材链接必须是公网可访问的 HTTPS 地址(带域名,不能是 IP 或内网地址)。按秒计费的模型,实际扣费 = 单价 × 请求的秒数;按次计费的模型与秒数无关。