API
VELIN 图片 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 · 字段与限制
字段说明
prompt必填。画面描述，中英文都行。
model必填。从 /api/models 里选。
size比例。如 16:9、1:1、9:16、3:4 等，以 /api/models 返回的为准。
resolution1K / 2K / 4K。越大越慢越贵。
refs参考图，可重复。最多 14 张，单张不超过 8MB。
- 限流：单张生成每分钟最多 8 次，批量每分钟 2 次。超了返回 429。
- 额度不足：返回 402，body 里带 need（需要多少）与 have（还剩多少）。
- 图片保留：出来的图默认保留 10 小时。想长期留，调 POST /api/gallery/{id}/keep。
- Prompts and generated images are deleted after 10 hours; reference images are deleted as soon as the job ends.
- 接入：只需要这把密钥和下面的接口地址。模型、渠道这些都不用你配置。
充值出图额度请到 生图充值 页。
Guides
联系我们 / Contact
有问题、需要大批量或代理价格？直接联系我们，Telegram 回复最快。
