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。

请求参数(规范)

参数类型必填说明
modelstring是固定为 agnes-image-2.5-flash
promptstring是生成或编辑指令
sizestring是档位:1K、2K、3K、4K
ratiostring否1:1、3:4、4:3、16:9、9:16、2:3、3:2、21:9,默认 1:1
extra_body.imagestring[]图生图必填公共图片 URL 或 Data URI Base64,最多 3 张
extra_body.response_formatstring否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),微信等客户端会抓取该图作为卡片封面。