AI 生图 API 怎么接入？GPT-image / Nano Banana Pro 生图 API 实操教程（2026）
一个很具体的场景：你在做电商的商品后台，运营每上一个新 SKU，都要手动去网页版工具生成几张白底主图、几张场景图，再下载、重命名、传回系统。一天几十个 SKU，光这一步就耗掉一个人。你想要的是——运营在后台填好提示词或传一张原图，点一下，系统自动调模型出图、自动回填到商品图库。这一步靠网页版做不到，得用 生图 API：用代码把请求发给模型、拿回图片。
下面这篇按真实接入顺序走一遍：拿 Key → 发第一个请求 → 接收图片 → 图生图换背景 → 批量出图 → 报错排查。每步都说清"为什么这么做"，末尾给 3 个可直接复制的生图提示词和 FAQ。
AI 生图 API 是什么？和网页版有什么区别？
一句话：AI 生图 API 是让你用代码（而不是在网页上点）把提示词或图片提交给生图模型、拿回图片文件的接口。 网页版适合人手动一张张出图；API 适合把出图这一步接进自己的系统，做成"填参数就自动出图"的功能，或者一次批量跑几十上百张。
常见的生图模型有 GPT-image-2、Nano Banana Pro 等。GPT-image-2 是 OpenAI 的图像生成模型，擅长按指令精确出图和处理文字排版；Nano Banana Pro 是 Google 的图像模型，图生图、换背景、保持商品主体一致性上很顺手。在统一接入方式下，通常一个账户、一份文档、一种鉴权就能覆盖这几款模型，切换 model 参数即可，不用每个模型单独对接。想先看单个模型能出什么效果，可以看 GPT-image-2 工具页。
第一步：拿 API Key，放对地方
先注册账户，在控制台创建一个 API Key——它是你所有调用的身份凭证。
为什么强调"放对地方"：这个 Key 等于你账户的钥匙，一旦泄露别人就能用你的额度。正确做法是放到服务端环境变量里（比如 .env 里的 IMAGE_API_KEY），由后端代码读取，绝不要写死在前端 JS、也别提交进 Git 仓库。如果不小心提交了，第一时间去控制台把旧 Key 作废、重建一个。
第二步：发出第一个文生图请求
读文档确认三件事：接口地址、模型名、必填参数，然后发一个最小请求跑通链路。
先别追求效果，目标是"能拿到一张图"。一个可参照的请求结构（伪代码，实际字段以文档为准）：
curl https://<接入地址>/v1/images/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "白底商品主图：一副黑色无线耳机居中摆放，顶部柔和打光，浅阴影，干净留白，真实产品摄影质感，无文字",
"size": "1024x1024",
"n": 1
}'
几个参数的作用：model 指定用哪个模型；prompt 是提示词；size 是出图尺寸（电商主图常用 1:1，详情页长图用竖版）；n 是一次出几张。返回里一般是图片的 URL 或 base64 编码，取回来存进你的对象存储或图库即可。
为什么先跑最小请求：把"鉴权对不对、地址通不通、返回格式长什么样"这些链路问题先解决掉，再谈提示词调优，排错会清晰很多。
第三步：图生图 / 换背景怎么传参？
结论：在文生图请求基础上，多传一个原图入参（图片 URL 或按文档要求的编码），提示词用来描述"保留什么、改什么"。 电商用得最多的不是纯文生图，而是图生图——拿已有的白底商品图，换成不同风格的场景背景，主体不变、背景批量换。
curl https://<接入地址>/v1/images/edit \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"image": "https://你的图床/sku12345_white.jpg",
"prompt": "保持这副耳机的外形、颜色、logo 完全不变，把背景换成北欧风原木桌面，左侧自然窗光，浅景深，真实摄影感，无文字",
"size": "1024x1024"
}'
关键在提示词里明确写"保持 XX 不变"，模型才知道哪些是不能动的主体。想一次给一个 SKU 出多种背景，就用同一张原图、只改提示词里的场景描述循环调用。
第四步：批量出图，别一次性全发出去
批量场景要做一个任务队列，控制并发、失败重试、按商品 ID 归档，别写个 for 循环把几百个请求瞬间全发出去。
为什么：瞬时并发过高容易触发限流（返回 429），而且一旦中间失败，没有重试和归档机制就得从头来。工程上的稳妥做法：
- 把待出图的 SKU 列表放进队列，设一个并发上限（比如同时最多跑 5 个）。
- 每个任务失败自动重试，重试间隔逐次拉长（退避），别死磕。
- 成图按商品 ID 命名归档，方便回填和对账，也避免重复生成。
这套逻辑和批量出图工具的思路一致，想先在网页/工具层面把批量流程理顺再接 API，可参考《批量出图工具怎么选》。
生图 API 怎么计费？
按量计费——按实际调用量结算，用多少付多少，适合从小批量测试到正式放量。 生图消耗通常和出图尺寸、数量相关，图越大、一次出得越多，单次消耗越高。上生产前建议先拿几十个真实 SKU 跑一轮，估出"单张大致消耗"，再按每天出图量推算预算，比拍脑袋靠谱。视频类 API 的接入思路和这套基本一致，只是视频是异步返回，可对照《Veo 3.1 API 怎么调用》。
3 个可直接复制的生图提示词
- 白底主图（适合 3C / 家居小件）：
白底商品主图，[商品] 居中摆放，顶部柔和打光，浅阴影，干净留白，真实产品摄影质感，构图留出四周边距，无文字 - 场景氛围图（适合美妆 / 食品 / 家居）：
把 [商品] 放进 [北欧原木桌面 / 大理石台面 / 窗边生活场景]，自然窗光从左侧进入，浅景深突出商品，真实摄影感，暖色调，无文字 - 图生图换背景（适合服饰 / 通用）：
保持这件 [商品] 的外形、颜色、材质、logo 完全不变，仅把背景替换为 [目标场景]，光影自然贴合，边缘干净，真实摄影质感，无文字
方括号里换成你的品类和场景即可。同一张原图换不同场景描述循环调用，就是电商批量换背景的核心玩法。
常见问题 FAQ
Q：不会写代码，能用 AI 生图 API 吗？
A：API 面向开发者。如果只是自己要出几张图，直接用网页版更省事；要接进系统、做成"填参数自动出图"的功能或批量自动化，才需要 API。
Q：一个 Key 能同时调 GPT-image-2 和 Nano Banana Pro 吗？
A：在统一接入方式下，一个账户和 Key 可覆盖多款图像模型，按文档切换 model 参数即可，不用每个模型单独对接。
Q：文生图和图生图是两个接口吗？
A：通常是两个入口——文生图走 generate、图生图/换背景走 edit（多传一个原图入参）。具体字段名以文档为准。
Q：生成的图能商用吗？
A：可用于商品展示、营销素材等商业场景；涉及品牌 logo、人物肖像等，仍要遵守相应平台与法律的合规要求，别用敏感或侵权素材。
Q：想先看效果再决定接不接 API？
A：先用网页版把提示词和风格调顺，跑通后再把同样的提示词逻辑搬进 API，接入会顺很多，也能提前估准消耗。
小结
AI 生图 API 怎么接，核心就几步：注册拿 Key 并放进服务端环境变量、读文档发一个最小文生图请求跑通链路、图生图多传一张原图并写清"保持什么不变"、批量出图用队列控并发加重试、按量计费先小批量估消耗。国内可通过 AI生成中文站直接调用，配中文文档，GPT-image-2、Nano Banana Pro 等模型一套接入方式都能覆盖。建议先用网页版把效果调顺，再接 API 做自动化，落地更稳。