快速开始
用一个 API Key 调用秒做的图片、视频、音频与文本模型。生成类能力走异步任务，文本模型兼容主流 SDK，统一按秒做点数计费。
基本信息
| 接口基址 | https://api.miaozuo.cn/v1 |
|---|---|
| 协议与格式 | 仅支持 HTTPS；请求与返回均为 JSON，UTF-8 编码；点数为三位小数字符串，时间为 ISO 8601（北京时间 +08:00），见公共参数 |
| 鉴权 | 请求头 Authorization: Bearer <API Key>，单个 Key 可开启请求签名，见 鉴权与签名 |
| 调用方式 | 图片、视频、音频等生成类模型为异步任务；文本模型为同步调用，支持流式返回 |
| 计费 | 秒做点数，先冻结后结算，失败自动退回，见 计费与点数；生成任务结束可 Webhook 回调 |
快速开始
三步跑通第一个生成任务：
- 1
- 2
- 3
调用示例
把 Key 放进环境变量 MIAOZUO_API_KEY，用 qwen-image-3.0 提交一个图片生成任务并取回结果。其他模型的编码、参数和价格见模型列表。
# 1. 提交任务（Idempotency-Key 建议用你的业务单号，重复提交只会创建一个任务）
curl https://api.miaozuo.cn/v1/tasks \
-H "Authorization: Bearer $MIAOZUO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-20261009-0001" \
-d '{
"model": "qwen-image-3.0",
"input": {
"prompt": "一只戴宇航员头盔的橘猫，蓝色星空背景",
"ratio": "1:1",
"count": 1
}
}'
# 2. 用返回的 id 查询任务（生产环境建议配合 Webhook，少轮询）
curl https://api.miaozuo.cn/v1/tasks/T261009170328CGM0GT \
-H "Authorization: Bearer $MIAOZUO_API_KEY"提交成功后立即返回任务对象，状态为 queued，所需点数已冻结：
返回示例
{
"id": "T261009170328CGM0GT",
"object": "task",
"model": "qwen-image-3.0",
"status": "queued",
"created_at": "2026-10-09T17:03:28+08:00",
"started_at": null,
"finished_at": null,
"input": {
"prompt": "一只戴宇航员头盔的橘猫，蓝色星空背景",
"ratio": "1:1",
"resolution": "1k",
"count": 1,
"smart_prompt": true
},
"points": {
"frozen": "33.000",
"charged": "0.000",
"refunded": "0.000"
},
"output": null,
"error": null,
"metadata": {}
}接口一览
| 接口 | 用途 |
|---|---|
POST/v1/tasks | 提交异步生成任务 |
GET/v1/tasks/{id} | 查询任务状态与结果 |
GET/v1/tasks | 任务列表 |
POST/v1/tasks/{id}/cancel | 取消排队中的任务 |
POST/v1/files | 上传参考素材（图片、音频、视频、文档） |
POST/v1/chat/completions | 文本模型 · Chat Completions 格式 |
POST/v1/responses | 文本模型 · Responses 格式 |
POST/v1/messages | 文本模型 · Messages 格式 |
GET/v1/models | 可调用的模型及参数定义 |
GET/v1/models/{id} | 单个模型的参数定义与价格 |
GET/v1/pricing | 我的价格（按会员 / 渠道等级） |
GET/v1/balance | 点数余额与 Key 额度 |
POST/v1/apps/{model}/activate | 开通场景应用 |