Logo拍图猫文档
Logo拍图猫文档
首页拍图猫是什么如何出图积分API 参考
开发者中心
快速开始密钥管理权限图片下载错误格式限额图片包拉取发布通知

概览

接入拍图猫 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

接入前要知道的

  1. 密钥只显示一次。 在「账户 → 开发者中心」创建,sk_ 开头,关掉弹窗就再也看不到。
  2. 权限在创建时定死。 每把密钥只能访问勾选了的接口,缺权限返回 403 insufficient_scope。
  3. 出图是同步的。 一个请求等到图出完才返回,最长 5 分钟。
  4. 图片没有公开直链。 images[].url 是相对路径,要带同一把密钥请求。
  5. 出错有统一格式。 { error: { code, message, request_id } },程序按 code 分支,反馈问题带 request_id。

目录

  1. 快速开始 —— 创建密钥,发起第一次请求,下载结果
  2. 密钥管理 —— 创建、到期、撤销、日志、安全建议
  3. 权限 —— 每把密钥可访问的接口
  4. 图片下载 —— 原图、缩略图、下载参数、保留期
  5. 错误格式 —— 统一错误体、完整错误码、重试建议
  6. 限额 —— 每把密钥的请求上限、新账号限制
  7. 图片包拉取 —— 增量拉取已发布的图片包
  8. 发布通知 —— 发布后主动通知你的地址,签名验证与重试规则

出图接口的完整参数、模型表和计费在 API 参考。

API 参考

POST /api/v1/generate 的完整参数、响应与计费

快速开始

创建密钥,发起第一次请求,下载结果

目录

能做什么接入前要知道的目录