济川 AI 文档

主题

生图接入（GPT-Image / Nano Banana） ​

11-06 上新：GPT-Image-2.6，能直接出动图（GIF）

型号见下表，动图用法见 动图（GIF）。从 2.5 换过来要改哪几处，见 从 2.5 换到 2.6。

生图有两种用法：

  • 网页直接画：登录 控制台 → 左侧「视频生图工作台」，选型号、写提示词、上传参考图就能出图，不用配置任何客户端。
  • 接口调用：用 OpenAI 的图片接口（/v1/images/generations、/v1/images/edits），本页讲这一种。

生成失败不扣费

没出图、图片没保存成功，都不扣费，接口会直接告诉你「本次未扣费，请重试」。（图已生成但你这边超时断开的除外，见下文。）

第一步：key 要挂在生图分组上 ​

生图型号只在生图分组里。用聊天套餐的 key 调生图，会报「你的套餐不包含模型」。

分组型号（逐字复制）价格
【生图】GPT-Image-2gpt-image-2¥0.2 / 张，1K / 2K / 4K 同价
【生图】GPT-Image-2.5gpt-image-2.5-flare、gpt-image-2.5-sunburst¥0.2 / 张，1K / 2K / 4K 同价
【生图】GPT-Image-2.6gpt-image-2.6-flare、gpt-image-2.6-sunburst（写 gpt-image-2.6 等于 flare）¥0.2 / 张，1K / 2K / 4K 同价，动图也按一张算
【生图】Nano Banana 2nano-banana-21K ¥0.25 / 2K ¥0.35 / 4K ¥0.45 每张

在控制台 → API 密钥 新建一个 key，分组选上表里的一个。价格以控制台显示为准。

余额怎么换算

充值 ¥1 到账 1 余额，表里的价格就是每张扣的余额。

第二步：地址和超时 ​

地址      https://api.jichuanai.com/v1
超时      至少 180 秒（出动图 GIF 设到 300 秒）

出图一般 20～60 秒，偶尔更久。很多客户端默认超时是 60 秒，不调大会在图快出来时断开。

断开了也可能扣费

请求发出去以后，即使你这边超时断开，只要图已经生成，仍会按张计费。所以宁可把超时设长一点。

文生图 ​

下面的命令用 Mac / Linux 终端或 Git Bash 运行。Windows 用户请用 Git Bash，不要粘贴到「命令提示符」；不想写代码可以直接用网页工作台。

bash
curl https://api.jichuanai.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  --max-time 180 \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只穿宇航服的橘猫，扁平插画",
    "size": "1024x1024",
    "n": 1,
    "response_format": "url"
  }'

返回是标准 OpenAI 图片格式：

json
{ "data": [ { "url": "https://img.jichuanai.com/..." } ] }

动图（GIF，仅 2.6） ​

GPT-Image-2.6 可以直接出循环动图：在请求里加 "output_format": "gif"。文生图和改图都能用，改图时就是「把这张图做成动图」。

bash
curl https://api.jichuanai.com/v1/images/generations   -H "Authorization: Bearer sk-你的key"   -H "Content-Type: application/json"   --max-time 300   -d '{
    "model": "gpt-image-2.6",
    "prompt": "一只橘猫在挥手，扁平插画，循环动画",
    "size": "1024x1024",
    "n": 1,
    "output_format": "gif",
    "response_format": "url"
  }'
  • 一般是 8～9 帧、循环一次 1～2 秒的小动图。
  • 比静态图慢，通常 40 秒～2 分半，超时请设到 300 秒。
  • 按张计费，一张动图和一张静态图同价。
  • 返回的链接以 .gif 结尾；返回里还多几个字段：animated（是不是动图）、frame_count（帧数）、frame_durations_ms（每帧时长），不认识这些字段的客户端会直接忽略，不影响使用。
  • 改图做动图：把上面「改图」的命令里 model 换成 gpt-image-2.6，再加 -F output_format=gif，--max-time 改成 300。

从 2.5 换到 2.6 要改什么 ​

自己写代码、或在 agent / 客户端里配了生图的，地址不用改，只改这几处：

要改的怎么改
key 的分组新建一个 key，分组选「【生图】GPT-Image-2.6」。2.5 分组的 key 调 2.6 会报「你的套餐不包含模型」
型号名gpt-image-2.5-flare → gpt-image-2.6-flare，-sunburst 同理
出动图请求里加 output_format: "gif"。很多客户端的生图设置里没有这一项，那就用上面的命令，或者直接用网页工作台
超时静态图 180 秒够用；要出动图改成 300 秒

/v1/images/generations、/v1/images/edits 两个接口、response_format、size、n 的写法都和 2.5 一样。

改图 / 参考图生图 ​

用 /v1/images/edits，图片以「文件上传」方式提交（技术上叫 multipart）：

bash
curl https://api.jichuanai.com/v1/images/edits \
  -H "Authorization: Bearer sk-你的key" \
  --max-time 180 \
  -F model=gpt-image-2 \
  -F prompt="改成水彩画风格" \
  -F image=@input.png \
  -F size=1024x1024 \
  -F response_format=url
  • 多张参考图：重复写 -F image=@a.png -F image=@b.png
  • 遮罩：-F mask=@mask.png
  • 每个文件不超过 20MB
  • 也可以用 JSON 传图片链接："images": [{"image_url": "https://..."}]

参数说明 ​

参数说明
model上表里的型号，逐字复制
prompt提示词
n一次出几张，1～10。按张计费，n=4 就扣 4 张
size尺寸，如 1024x1024、2048x2048、3840x2160，也可以直接写 1K / 2K / 4K
response_formaturl 返回链接，b64_json 直接返回图片数据。建议显式写上
output_format只对 2.6 有用：写 gif 出动图；不写就是普通图片

尺寸怎么算档：看长边。≤1024 是 1K，≤2048 是 2K，再大是 4K。不写 size 按 2K 算。 GPT-Image 三档同价，这条只影响 Nano Banana 2 的价格。

链接请尽快下载

返回的图片链接不长期保留，拿到后请及时下载保存。

Nano Banana 2 的几个限制 ​

  • 只能用图片接口（/v1/images/generations、/v1/images/edits），不能用聊天接口调
  • 不支持 stream
  • 只能用「【生图】Nano Banana 2」分组的 key

常见报错 ​

报错里看到原因怎么改
你的套餐不包含模型「…」key 不在生图分组，或型号名写错换生图分组的 key；型号逐字复制上表
images endpoint requires an image model在图片接口里填了聊天模型model 改成上表的生图型号
This model is not supported on the Chat Completions endpoint用聊天接口调了生图型号改用 /v1/images/generations
这个分组不支持 nano-banana-2，本次未扣费Nano Banana 用了别的分组的 key换「【生图】Nano Banana 2」分组的 key
n must be between 1 and 10一次要的张数超出范围n 改成 1～10
账户余额不足 / insufficient balance余额不够这次要出的张数充值后直接重试，key 不用换
没有生成出图片，本次未扣费，请重试这次没出图直接重试，没扣钱
图片没能保存，本次未扣费，请重试图片保存失败直接重试，没扣钱
客户端报超时，没收到图超时设得太短超时调到 180 秒以上，出动图调到 300 秒
用 2.5 的 key 调 gpt-image-2.6… 报「你的套餐不包含模型」2.6 是单独的分组新建一个「【生图】GPT-Image-2.6」分组的 key
加了 output_format: gif 但拿到的是普通图片型号不是 2.6model 改成 gpt-image-2.6 系列

更多通用报错见 报错对照表。

遇到问题先查「报错对照表」，仍未解决请在控制台联系客服。

济川 AI