概览
接入拍图猫 API
用 API 密钥从你自己的程序调用拍图猫:生成图片、下载图片、拉取已发布的图片包。
能做什么
| 接口 | 用途 | 需要的权限 |
|---|---|---|
POST /api/v1/generate | 出图,同步返回图片地址 | generate:write |
GET /api/file/<filename> | 下载图片或缩略图 | assets:read |
GET /api/v1/image-pack-publications | 列出已发布的图片包,增量拉取 | documents:read |
GET /api/v1/image-pack-publications/<id> | 读一个发布版本的完整内容 | documents:read |
接入前要知道的
- 密钥只显示一次。 在「账户 → 开发者中心」创建,
sk_开头,关掉弹窗就再也看不到。 - 权限在创建时定死。 每把密钥只能访问勾选了的接口,缺权限返回
403 insufficient_scope。 - 出图是同步的。 一个请求等到图出完才返回,最长 5 分钟。
- 图片没有公开直链。
images[].url是相对路径,要带同一把密钥请求。 - 出错有统一格式。
{ error: { code, message, request_id } },程序按code分支,反馈问题带request_id。
目录
- 快速开始 —— 创建密钥,发起第一次请求,下载结果
- 密钥管理 —— 创建、到期、撤销、日志、安全建议
- 权限 —— 每把密钥可访问的接口
- 图片下载 —— 原图、缩略图、下载参数、保留期
- 错误格式 —— 统一错误体、完整错误码、重试建议
- 限额 —— 每把密钥的请求上限、新账号限制
- 图片包拉取 —— 增量拉取已发布的图片包
- 发布通知 —— 发布后主动通知你的地址,签名验证与重试规则
出图接口的完整参数、模型表和计费在 API 参考。
拍图猫文档