拍图猫文档快速开始
创建密钥，发起第一次请求，下载结果
1. 创建密钥
「账户 → 开发者中心 → API 密钥 → 创建 API 密钥」。填名称，勾选权限，选有效期。
第一次接入至少勾 generate:write（出图）和 assets:read（下载图片）。
密钥以 sk_ 开头，只显示一次。丢失后只能撤销并重新创建。
2. 鉴权
所有接口都用请求头鉴权：
Authorization: Bearer sk_你的密钥3. 生成图片
curl -X POST https://paitumao.com/api/v1/generate \
-H "Authorization: Bearer sk_你的密钥" \
-H "Content-Type: application/json" \
-d '{
"prompt": "白底T恤主图，模特正面，柔和布光",
"model": "nano-banana-2",
"ratio": "3:4",
"n": 1
}'成功响应：
{
"ok": true,
"turn_id": "t_xxxxxxxxxx",
"session_id": "s_xxxxxxxxxx",
"credits_charged": 16,
"duration_ms": 18320,
"warnings": [],
"images": [
{
"id": "img_xxxxxxxx",
"filename": "xxxxxxxx.png",
"url": "/api/file/xxxxxxxx.png",
"width": 1536,
"height": 2048
}
]
}参数全表、模型能力、计费规则见 API 参考。
4. 下载图片
images[].url 是相对路径，带同一把密钥请求。接口会 302 到一个一小时有效的直链，所以要跟随跳转：
curl -L https://paitumao.com/api/file/xxxxxxxx.png \
-H "Authorization: Bearer sk_你的密钥" \
-o result.png缩略图、下载参数和图片保留期见图片下载。
5. 处理错误
出错时 HTTP 状态码非 2xx，响应体是：
{
"error": {
"code": "insufficient_credits",
"message": "积分不足：需要 16，当前 3。请联系 … 充值。",
"request_id": "req_xxxxxxxxxxxxxxxxxxxx"
}
}程序按 code 分支，别按 message 匹配，它会改。完整列表见错误格式。