4 个模型
秒做开放 API
一个 Key 调用全部模型
图片、视频、音频与文本模型都在这里，统一按秒做点数计费。生成类能力走异步任务，文本模型兼容主流 SDK。
- 71个模型可调用
- 8类能力
- 失败自动退点
POST /v1/tasks
Host: api.miaozuo.cn
Authorization: Bearer $MIAOZUO_API_KEY
Content-Type: application/json
Idempotency-Key: order-20261009-0001
{
"model": "qwen-image-3.0",
"input": {
"prompt": "一只戴宇航员头盔的橘猫，蓝色星空背景",
"ratio": "1:1",
"count": 1
}
}
立即返回任务对象status: "queued"，所需点数已冻结
Webhook 回调任务结束时通知你的服务器
异步任务 + Webhook
图片、视频、音频等生成类模型提交后立即返回任务编号，生成完成后通过查询或 Webhook 回调取回结果。
异步任务按点数计费，失败自动退回
统一按秒做点数计费：提交时先冻结，成功后按实际用量结算，失败或取消自动退回。
计费与点数可选的请求签名
可给单个 Key 开启「必须签名」，每个请求带时间戳、随机串和 HMAC-SHA256 签名，防篡改、防重放。
请求签名幂等提交
提交任务时带上 Idempotency-Key：相同的键只创建一个任务、只冻结一次点数，网络超时用同一个键重试即可。
幂等提交文本模型兼容主流格式
文本模型同步调用，兼容三种主流请求格式，支持流式返回；现有代码换成秒做的地址和 Key 就能直接使用。
文本模型限速与重试
按 Key 限制每分钟请求数与并发数，超出返回 429 且不创建任务、不扣点；按 Retry-After 或指数退避重试。
限速与并发
