香蕉 OpenAPI
发布时间:2026-11-01 | 浏览:1
一个端口接入 15 款图像模型 ,按张计费、失败返还、国内直连。 把生图基础设施留给我们,把好产品留给你。
Nano Banana Pro
招牌的 Nano Banana 系列单价最低、出图最快;其余 6 款按场景按需选用。失败、超时、审核拒绝全部自动返还。
GPT Image 2 gpt-image-2 文生图 / 图生图 1 - 3 积分 / 张 查看计费规则 文生图 / 图生图
GPT Image 2.5 Flare NEW gpt-image-2.5-flare 速度优先 · 日常出图与快速原型 1 - 100 积分 / 张 查看计费规则 文生图 / 图生图 9 档画质
速度优先 · 日常出图与快速原型
GPT Image 2.5 Sunburst gpt-image-2.5-sunburst 编辑精度优先 · 商品图与创意制作 1 - 100 积分 / 张 查看计费规则 文生图 / 图生图 9 档画质
编辑精度优先 · 商品图与创意制作
Z Image Turbo NEW z-image-turbo 快速文生图 · 低成本创作 1 积分 / 张 查看计费规则 文生图
Seedream 5.0 NEW seedream-5.0 字节跳动图片生成与编辑模型 2 积分 / 张 查看计费规则 文生图 / 图生图
Seedream 5.0 Flash NEW seedream-5.0-flash 文生图与多图编辑 · 最多 10 张参考图 2 - 3 积分 / 张 查看计费规则 文生图 / 图生图
文生图与多图编辑 · 最多 10 张参考图
Seedream 5.0 Pro seedream-5.0-pro 图片生成与编辑 · 1K / 2K · 最多 10 张参考图 4 积分 / 张 查看计费规则 文生图 / 图生图
图片生成与编辑 · 1K / 2K · 最多 10 张参考图
Wan2.5 文生图 wan2.5-text-to-image 阿里通义万相文生图模型 2 积分 / 张 查看计费规则 文生图
Qwen Image qwen-image-edit-plus 阿里通义千问图片编辑模型 2 积分 / 张 查看计费规则 图生图
Nano Banana 2 ★ 招牌 nano-banana-2 第二代绘图模型&4K 2 - 3 积分 / 张 查看计费规则 文生图 / 图生图 联网
Nano Banana 2.1 ★ 招牌 NEW nano-banana-2.1 图片生成与编辑 · 1K / 2K / 4K · 最多 14 张参考图 4 - 5 积分 / 张 查看计费规则 文生图 / 图生图 联网
图片生成与编辑 · 1K / 2K / 4K · 最多 14 张参考图
Nano Banana Pro ★ 招牌 nano-banana-pro 精准中文理解输出&4K 2 - 4 积分 / 张 查看计费规则 文生图 / 图生图 联网
GPT Image 2 加速 NEW gpt-image-2-official OpenAI 图像模型 2.0 1 - 45 积分 / 张 查看计费规则 文生图 / 图生图 9 档画质
OpenAI 图像模型 2.0
Nano Banana 2 加速 ★ 招牌 nano-banana-2-official 第二代绘图模型&4K 4 - 5 积分 / 张 查看计费规则 文生图 / 图生图 联网
Nano Banana Pro 加速 ★ 招牌 nano-banana-pro-official 精准中文理解输出&4K 3 - 6 积分 / 张 查看计费规则 文生图 / 图生图 联网
异步调用:generate 提交任务,通过 query 轮询结果。参数与可用图片模型由站点模型目录统一维护。
1 . 调用 /api/ai/generate/ 提交任务,保存响应的 data.id,作为后续查询的 taskId
2 . 轮询 /api/ai/query/,直到 success 或 failed;建议每 10 秒查询一次,同一任务的上游刷新最小间隔为 10 秒
3 . 从响应的 outputImages 字段获取结果图片地址
API 仅向付费用户开放,需先完成充值,并在所有请求头中携带有效 API Key。历史充值、订阅、续费及人工充值用户均可使用;仅有赠送积分不具备 API 调用资格。积分不足时仍须充值。
上传接口使用 multipart/form-data,由客户端自动设置 Content-Type 和 boundary;不要使用 application/json 或手动填写不含 boundary 的 multipart/form-data。
aspectRatio:auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 2:1, 1:2, 3:1, 1:3, 9:21;默认 1:1
resolution:0.5K, 1K, 2K, 4K;默认 1K
参考图最多 10 张(含站点预检限制)
其他支持参数:seed, mask_url
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
4K 仅支持比例:16:9, 9:16, 2:1, 1:2, 21:9, 9:21
aspectRatio:auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 2:1, 1:2, 3:1, 1:3, 9:21;默认 auto
resolution:1k, 2k, 4k;默认 1k
参考图最多 10 张(含站点预检限制)
quality:auto, low, medium, high, xhigh, max;建议显式指定
其他支持参数:output_format (png, jpeg, webp), output_compression, background, moderation (auto, low)
options.size 或 options.aspectRatio 可传 WIDTHxHEIGHT,例如 1024x1024;不要同时传两者。正整数宽高均为 16 的倍数,单边不超过 3840,总像素为 655360–8294400,最长边 / 最短边不超过 3
aspectRatio:auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 2:1, 1:2, 3:1, 1:3, 9:21;默认 auto
resolution:1k, 2k, 4k;默认 1k
参考图最多 10 张(含站点预检限制)
quality:auto, low, medium, high, xhigh, max;建议显式指定
其他支持参数:mask_url, output_format (png, jpeg, webp), output_compression, background, moderation (auto, low)
options.size 或 options.aspectRatio 可传 WIDTHxHEIGHT,例如 1024x1024;不要同时传两者。正整数宽高均为 16 的倍数,单边不超过 3840,总像素为 655360–8294400,最长边 / 最短边不超过 3
aspectRatio:1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3;默认 1:1
resolution:1K, 2K;默认 1K
参考图最多 0 张(含站点预检限制)
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
aspectRatio:auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9;默认 1:1
resolution:2K, 3K;默认 2K
参考图最多 10 张(含站点预检限制)
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
aspectRatio:auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 2:1, 1:2;默认 auto
resolution:1K, 1.5K, 2K;默认 1K
参考图最多 10 张(含站点预检限制)
其他支持参数:output_format (jpeg, png), watermark
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
aspectRatio:auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9;默认 auto
resolution:1K, 2K;默认 1K
参考图最多 10 张(含站点预检限制)
其他支持参数:output_format (jpeg, png), watermark
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
不开放 aspectRatio / resolution 参数,使用上游默认尺寸
参考图最多 0 张(含站点预检限制)
不开放 aspectRatio / resolution 参数,使用上游默认尺寸
参考图最多 1 张(含站点预检限制)
aspectRatio:auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1;默认 1:1
resolution:0.5K, 1K, 2K, 4K;默认 1K
参考图最多 10 张(含站点预检限制)
支持 web_search;开启额外 1 积分 / 张
其他支持参数:seed, mask_url
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
aspectRatio:auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1;默认 auto
resolution:1K, 2K, 4K;默认 1K
参考图最多 10 张(含站点预检限制)
支持 web_search;开启额外 1 积分 / 张
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
aspectRatio:auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9;默认 1:1
resolution:1K, 2K, 4K;默认 1K
参考图最多 10 张(含站点预检限制)
其他支持参数:seed, mask_url
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
aspectRatio:auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 2:1, 1:2, 3:1, 1:3, 9:21;默认 1:1
resolution:0.5K, 1K, 2K, 4K;默认 1K
参考图最多 10 张(含站点预检限制)
quality:low, medium, high;建议显式指定
其他支持参数:seed, mask_url
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
4K 仅支持比例:16:9, 9:16, 2:1, 1:2, 21:9, 9:21
aspectRatio:auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1;默认 1:1
resolution:0.5K, 1K, 2K, 4K;默认 1K
参考图最多 10 张(含站点预检限制)
支持 web_search;开启额外 1 积分 / 张
其他支持参数:seed, mask_url
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
aspectRatio:auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9;默认 1:1
resolution:1K, 2K, 4K;默认 1K
参考图最多 10 张(含站点预检限制)
其他支持参数:seed, mask_url
options.size 仅作为 aspectRatio 的比例别名,不接受 1024x1024 等像素尺寸;使用所列比例与 resolution 档位,实际输出像素不保证固定
仅列出本站启用的图片模型。可选参数以各模型说明为准;未列出的能力不保证生效。参考图数量同时受模型和站点预检限制。quality 的上游默认值未统一约定,建议显式传入;分辨率和比例请按所列值填写。
上传接口使用 multipart/form-data,由客户端自动设置 Content-Type 和 boundary;不要使用 application/json 或手动填写不含 boundary 的 multipart/form-data。
data.urls 是按上传顺序返回的图片地址数组;data.results 包含各文件的 url、存储 key 和原始 filename。示例域名仅用于说明,请使用实际返回的 URL。
将 data.urls 传入 POST /api/ai/generate/ 的 options.image_urls,并设置 scene 为 image-to-image。参考图数量、格式及大小仍须满足所选模型和站点预检限制。
除 HTTP 状态外,还须检查业务 code:0 表示成功,-1 表示失败。常见错误包括 no auth, please sign in、No files provided、File … is not an image 和 upload image failed。多文件上传中途失败时,之前的文件可能已保存;只有 code 为 0 时才使用返回的完整 URL 数组。
图生图示例:分别指定画质与分辨率
API 调用要求付费用户,无需传 captchaToken;验证码不能代替付费资格。未付费账号调用将返回 paid account required for API access。当前不支持 webhook 回调,callbackUrl 不会生效,请通过 query 轮询。参考图建议每张不超过 20MB,必须提供可访问的原图链接;示例中的参考图地址需替换为真实地址。
先检查响应 code:成功为 0,失败为 -1,此时读取 message,不继续解析 data。paid account required for API access 表示账号不具备付费资格;insufficient credits 表示可用积分不足。
no auth API Key 无效或未传入
insufficient credits 积分不足
task not found 任务不存在
no permission 无权访问该任务(任务属于其他用户)
无需跳转,直接在当前页面创建并复制密钥。每个账号最多 10 个 Key,可分别用于不同项目方便撤销。
登录后即可创建 API Key
登录账号即可创建并管理 API Key
没找到答案?微信加 banana-cs 工作时间 5 分钟内回复。
01 哪些用户可以调用 API?
05 接口跟 OpenAI 直连有什么区别?
06 支持回调 webhook 吗?
09 怎么防 Key 被泄漏?
按张计费、随用随充,余额永不过期。
按张计费 · 失败返还 · 5 分钟上手