IOOAI API 统一文档

一份文档覆盖全部模型。模型、价格、格式限制都实时读取线上配置,新上的模型会自动出现在这里。
接入地址 … 鉴权 请求头 Authorization: Bearer 你的key 下载 本文档 Markdown 版 机器可读规格 models.json
快速开始我的 key 能用哪些模型全部模型总览逐个模型说明错误与注意事项

快速开始(所有视频模型通用)

所有视频模型用同一个接口,只换 model 和各模型支持的字段。流程:提交任务 → 拿到 id → 轮询查询 → status 为 completed 后读取 output_url 下载视频。

步骤接口说明
1 提交POST /v1/videosJSON 请求体;也可用 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 / 403key 无效、已过期,或这个 key 没有该模型的权限。
HTTP 402 / 余额不足余额不够本次费用(按秒计费模型 = 单价 × 秒数)。
HTTP 429提交过快或当前线路繁忙,稍等几秒后重试。
HTTP 503「结果不确定」网络中断导致无法确认是否提交成功,不要立刻重复提交,先用已有任务 id 查询或联系客服。
status: failed生成失败会自动退还本次费用。
status: submission_uncertain
review_required: true
提交结果尚未确认,需核实是否已受理;此时 progress 为 0,预扣金额待核对。保存原任务 id 并继续查询,请勿重复提交。兼容旧响应时,review_required: true 同样表示待核实,不能视为正在生成。

参考素材链接必须是公网可访问的 HTTPS 地址(带域名,不能是 IP 或内网地址)。按秒计费的模型,实际扣费 = 单价 × 请求的秒数;按次计费的模型与秒数无关。