API 文档
本站底层模型兼容 Open AI,终端用户可使用本站控制台;开发者可用会员中心的 API Key 接入本站端点。
终端点
POST http://mickeyai.top/v1/images/generations (本站,API Key 鉴权,按额度计费)
开发者接入(本站端点)
在 会员中心 → API 接入 获取 Key。请求与上游完全同构,额外按次扣除账户额度:
curl http://mickeyai.top/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "日出时分薄雾峡谷上方的发光浮空城市,电影级写实,高细节",
"size": "2K",
"ratio": "16:9",
"image": ["https://example.com/ref.png"]
}'
image 为选填参考图数组(图生图/多图合成),与上游规范一致;返回 data[0].url 为可直接下载的成品地址。鉴权失败返回 401。
请求参数(规范)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 固定为 agnes-image-2.5-flash |
| prompt | string | 是 | 生成或编辑指令 |
| size | string | 是 | 档位:1K、2K、3K、4K |
| ratio | string | 否 | 1:1、3:4、4:3、16:9、9:16、2:3、3:2、21:9,默认 1:1 |
| extra_body.image | string[] | 图生图必填 | 公共图片 URL 或 Data URI Base64,最多 3 张 |
| extra_body.response_format | string | 否 | url 或 b64_json |
请求示例(文生图)
curl https://api.agnes-ai.cn/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "agnes-image-2.5-flash",
"prompt": "A cinematic product hero image, clean lighting, high detail",
"size": "2K", "ratio": "16:9",
"extra_body": { "response_format": "url" }
}'
常见错误
· response_format 不要放在顶层,必须放在 extra_body 内;
· 图生图不要传 tags;
· 参考图必须是可公开访问的 HTTPS 地址,否则改用 Data URI Base64;
· 建议客户端超时设置为 60–360 秒。
常见问题
1920x1080 可以直接生成吗? 请求 2K + 16:9(输出 2624x1472)后在下游裁剪。
分享链接没有缩略图? 管理员在后台「SEO 设置」上传分享图(og:image),微信等客户端会抓取该图作为卡片封面。