ououu API 与 MCP

接口版本 v1 · 平台模型中转（对客仅显示 ououu 模型名）· 直通列表价约成本×3

认证

Authorization: Bearer <YOUR_OUOUU_API_KEY>

在「开发者接入」创建密钥。不要使用网页登录密码，也不要把密钥放在浏览器代码或公开工作流中。生成及其结果重放需要 models:read、generations:read、generations:write 三项权限；每个 MCP HTTP 请求仅允许一次协议调用，不支持数组批处理。

平台模型与零售参考

GET https://ououu.com/api/v1/models
GET https://ououu.com/api/v1/balance

模型 ID	说明	列表价参考（直通零售；便宜档约成本+10%，其余约成本×3）
ououu-script	文案 / 脚本	约 ¥0.3 / 次
ououu-image	图片生成	约 ¥0.8 / 张
ououu-video	视频生成	720p 约 ¥3/秒 · 1080p 约 ¥7.5/秒

查询不产生模型费用。已开通会员的账号，API 扣费可按会员档略低于直通列表价（普通会员约成本×2，大会员约成本×1.5）。网页欢迎赠送不算外部 API 可用额度；余额与网页共用同一钱包。对客仅显示 ououu-script / ououu-image / ououu-video，不暴露上游供应商名称。

先估价，再提交

POST /api/v1/generations/estimate
{"model":"ououu-video","prompt":"夕阳下缓慢推进的海边咖啡馆镜头","ratio":"16:9","duration":5,"resolution":"720p"}

POST /api/v1/generations
{
  "input": {"model":"ououu-video","prompt":"夕阳下缓慢推进的海边咖啡馆镜头","ratio":"16:9","duration":5,"resolution":"720p"},
  "maxCredits": 50,
  "idempotencyKey": "my-app-order-20260908-001"
}

示例预算不是报价。请使用估价返回的点数（界面可换算为 ¥），经用户确认后传入 maxCredits。未开放收费生成时返回 developer_generation_disabled，不扣费。幂等键必须稳定且唯一；网络超时后使用原幂等键查询，禁止改键盲目重试。

可用参数

模型	参数
ououu-script	prompt（8–4000 字符）
ououu-image	prompt、ratio（1:1 / 9:16 / 16:9 / 4:5）、referenceImages
ououu-video	prompt、ratio（1:1 / 9:16 / 16:9）、duration（5–10 整数秒）、resolution（720p / 1080p）、referenceImages

参考图最多 4 张，以 PNG、JPEG、WebP 的 base64 data URL 传入，单张最多 90 万字符。此版本不拉取外部图片网址。未支持或超限的参数会在调用前被拒绝。

任务与交付

GET /api/v1/generations/<request_id>
GET /api/v1/generations/<request_id>/files/0

图片和视频异步排队。status 为 succeeded 后读取 output；文件下载同样需要 Bearer 密钥。unknown 表示结果待核对，不代表失败可免费重试。

MCP

URL: https://ououu.com/api/mcp
Transport: Streamable HTTP (POST)
Header: Authorization: Bearer <YOUR_OUOUU_API_KEY>
Tools: list_models, get_balance, estimate_generation,
       create_generation, get_generation

工具按密钥权限和收费开关返回。只读密钥不会获得生成工具。

错误处理

401：密钥过期或失效；402：余额不足；403：模型或工具未授权；409：预算超限或幂等冲突；429：请求频率或预算保护；503：服务、模型或报价未就绪。不要在这些错误后自动更换幂等键重复调用。