API 参考/图片生成
图片生成 API
用 /v1/images/generations 和 /v1/images/edits 生成或编辑图片，支持自定义尺寸和异步任务，按实际输出尺寸计费。
同步 JSON / 可选异步brush不想写代码？在浏览器里直接试试 Studio 在线生图
快速示例link
/images/generations 请求支持自定义宽高比例，平台会先按请求 size 做合法性校验和额度预留，成功后按实际输出图片尺寸结算。
cURL
curl https://api.wokey.ai/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5",
"prompt": "A quiet lake at sunrise",
"size": "1536x1024"
}'返回 data[0].b64_json；图生图使用 image 文件字段，异步模式返回任务 ID。
异步调用link
生成较慢时加请求头
Prefer: respond-async· 返回任务 ID → 查询状态 → 下载图片请求参数link
| 参数 | 是否必填 | 说明 |
|---|---|---|
| model | 必填 | 当前只支持 gpt-image-2.5。 |
| prompt | 必填 | 图片提示词，不能为空。 |
| size | 可选 | 格式为 WIDTHxHEIGHT，支持非正方形比例；每边必须在 128-4096 像素之间。省略或传 auto 时默认为 1024x1024。 |
| n | 可选 | 当前只支持 1；省略时按 1 处理。 |
| stream | 可选 | 传 true 时按 OpenAI 官方流式生图协议返回 SSE：渐进预览帧为 image_generation.partial_image 事件，最终成品为 image_generation.completed 事件。计费与非流式完全一致，预览帧不收费。 |
| partial_images | 可选 | 流式时请求的渐进预览帧数量，整数 0-3，默认 0（只发最终事件）。 |
响应参数：data[0].b64_json 为生成图片的 base64。
档位与计费link
档位按图片最长边划分。请求 size 会用于预留最高可能费用；最终以实际输出图片的最长边落档扣费。
| 档位 | 实际输出最长边 | 请求 size 预留 | 价格 |
|---|---|---|---|
| 1K | <= 1280 px | 请求最长边 <= 1280 px | $0.01 / 张 |
| 2K | 1281-2048 px | 请求最长边 1281-2048 px | $0.01 / 张 |
| 4K | 2049-4096 px | 请求最长边 2049-4096 px | $0.01 / 张 |
常见问题link
- 密钥列表里的「Studio 网页生图」是什么？可以删除吗？
- 用过 Studio 在线生图后，系统会自动为你托管一把名为「Studio 网页生图」的 API Key（早期用户可能显示为「网页生图」），网页上的每次生图都通过它走和 API 完全相同的计费与限流通道，所以调用明细里这些记录的密钥名就是它。这把 Key 的完整密钥不会下发到浏览器；删除或停用不影响使用，下次网页生图会自动重建一把。
- Studio 网页生图怎么计费？
- 和 API 生图完全一致：按张、按实际输出尺寸档位从账户余额扣费，消费自动计入用量总览和调用明细，没有独立的计费规则。
- Studio 生成的图片保存在哪里？
- 只保存在你当前浏览器本地，平台服务器不存储图片内容。换浏览器、换设备或清除站点数据后历史记录会丢失，需要长期保留请及时下载。