把 API 接入

用它在你自己的程序里出图。一把密钥、一个接口，按张计费，额度就是你在本站的余额。

生产环境主机：https://72agi.com（下文示例已使用该地址）。

1 · 拿到密钥

登录后打开 我的，页面上就有你的密钥，点「复制」即可。一个账号一把，随时能换。

• 别发出去：这把密钥等同于你的账号 —— 能调接口，也能登录本站。
• 弄丢了：回「我的」就能再看到，不用找客服。
• 想作废：点「换一把」，旧密钥立刻失效。

2 · 鉴权

每个请求带一个头就行：

Authorization: Bearer YOUR_KEY

也支持 Cookie（浏览器里登录后用）。不要把密钥放在 URL 查询参数里 —— 那会留在访问日志里。

3 · 模型与价格

curl https://72agi.com/api/models

返回模型、每张单价（人民币）与支持的比例。价格以下单时返回的为准。

[
  {
    "id": "nano-banana-pro",
    "name": "Nano Banana Pro",
    "prices": {"1K": 0.25, "2K": 0.25, "4K": 0.25}
  },
  {
    "id": "nano-banana-2",
    "name": "Nano Banana 2",
    "prices": {"1K": 0.25, "2K": 0.25, "4K": 0.25}
  },
  {
    "id": "nano-banana-pro-plus",
    "name": "Nano Banana Pro+",
    "prices": {"1K": 0.35, "2K": 0.35, "4K": 0.35}
  },
  {
    "id": "nano-banana-2-plus",
    "name": "Nano Banana 2+",
    "prices": {"1K": 0.35, "2K": 0.35, "4K": 0.35}
  },
  {
    "id": "gpt-image-2",
    "name": "GPT Image 2",
    "prices": {"1K": 0.25, "2K": 0.25, "4K": 0.25}
  },
  {
    "id": "gpt-image-2.5-flare",
    "name": "GPT Image 2.5 Flare",
    "prices": {"1K": 0.25, "2K": 0.25, "4K": 0.25}
  },
  {
    "id": "gpt-image-2.5-sunburst",
    "name": "GPT Image 2.5 Sunburst",
    "prices": {"1K": 0.25, "2K": 0.25, "4K": 0.25}
  }
]

4 · 生成一张图

两步：提交拿到任务号，然后轮询拿结果。单张实测 100 秒上下（4K 更久），所以别用同步等待，轮询更稳 —— 断网、刷新页面都不会丢任务。

提交（multipart 表单）：

curl -X POST https://72agi.com/api/generate \
  -H "Authorization: Bearer YOUR_KEY" \
  -F "prompt=a quiet room, cream light" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "size=16:9" \
  -F "resolution=1K"

202 {"id": "02a38b1d1b66", "status": "queued"}

轮询：

curl https://72agi.com/api/task/02a38b1d1b66

{"id": "02a38b1d1b66", "status": "processing"}

{"id": "02a38b1d1b66", "status": "succeeded",
 "url": "/outputs/02a38b1d1b66.png", "price": 0.25}

status 有四个值：queued / processing / succeeded / failed。建议每 3–5 秒轮一次。

成功时 url 是本站路径，不是服务链接。加上域名即可下载：

失败会自动退款，error 里是原因。出图占用的额度在提交时就扣，失败时退回。

5 · 图生图（参考图）

同一个接口，多传 refs 字段。最多 14 张，超出部分忽略。

curl -X POST https://72agi.com/api/generate \
  -H "Authorization: Bearer YOUR_KEY" \
  -F "prompt=turn this into a watercolour" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "refs=@./source.png"

参考图会影响结果的构图与风格，也会拖慢出图。能少传就少传。

6 · 查额度

curl https://72agi.com/api/credits -H "Authorization: Bearer YOUR_KEY"
{"credits": 29.75, "unlimited": false, "role": "user"}

额度单位是人民币。unlimited 为 true 时不扣费（管理员）。想看「我是谁、能做什么」用 GET /api/session。

7 · 字段与限制

• 限流：单张生成每分钟最多 8 次，批量每分钟 2 次。超了返回 429。
• 额度不足：返回 402，body 里带 need（需要多少）与 have（还剩多少）。
• 图片保留：出来的图默认保留 10 小时。想长期留，调 POST /api/gallery/{id}/keep。
• 接入：只需要这把密钥和下面的接口地址。模型、渠道这些都不用你配置。

充值出图额度请到 生图充值 页。