图像与多媒体

查看 GPT Image 2.6 API：GIF 表情包、2K/4K 与 token 价格，包含可运行的 Python、cURL 请求和实际生成的动画示例。

RouteMux 在你对话时已经用的同一个 OpenAI 兼容 base URL 上暴露图像生成与编辑。传一个 支持图像的模型 slug,请求会按各模型的定价规则计费：GPT Image 2.5 按张，GPT Image 2.6 按 token。

通过筛选目录找到支持图像的模型:

curl "https://api.routemux.com/v1/models?capability=image_generation" \
  -H "Authorization: Bearer $ROUTEMUX_API_KEY"

生成一张图

curl https://api.routemux.com/v1/images/generations \
  -H "Authorization: Bearer $ROUTEMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5-flare",
    "prompt": "一张折成「一跳」的世界纸质地图",
    "n": 1
  }'

2K / 4K(gpt-image-2.5-sunburst / flare)

openai/gpt-image-2.5-sunburst 与 openai/gpt-image-2.5-flare 都支持真实的 2K 与 4K 输出,两者档位、价格与限制相同,文生图(/v1/images/generations)与图生图 (/v1/images/edits)都可以。调用方式不变,仍是同步响应,响应体仍是 {created, data:[{b64_json}]} (base64 PNG)。档位由 size 决定:

按张固定价,不按 token 计。2K / 4K 的限制:

• n 必须为 1。
• 不支持 mask。
• 图生图最多 10 张参考图:multipart 用 image / image[] 传文件,JSON 用 image / images 传 https URL 或 data URL(也接受 images:[{image_url}])。
• 单张约 40 秒到 4 分钟,高峰会更久;客户端读超时不要用 30 / 60 / 120 秒这类默认值,建议留到 5 分钟以上。
• 表里没有列出的 size 会返回 400,不扣费。
• flare 的图生图在 2K 档实测输出 2048×1152(16:9),文生图与上表一致。
• 为避免同一张图重复扣费,2K / 4K 请求一旦开始生成,出错后网关不会自动重发,需要由你决定是否重发。

文生图(2K,16:9):

curl https://api.routemux.com/v1/images/generations \
  -H "Authorization: Bearer $ROUTEMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2.5-sunburst",
    "prompt": "A product poster of a ceramic coffee cup on a linen tablecloth, soft morning light",
    "size": "2560x1440",
    "n": 1
  }' | jq -r '.data[0].b64_json' | base64 --decode > poster-2k.png

图生图(4K,16:9,multipart 上传两张参考图):

curl https://api.routemux.com/v1/images/edits \
  -H "Authorization: Bearer $ROUTEMUX_API_KEY" \
  -F model=openai/gpt-image-2.5-sunburst \
  -F prompt="Place the logo on the cup and keep everything else unchanged" \
  -F size=3840x2160 \
  -F "image[][email protected]" \
  -F "image[][email protected]" \
  | jq -r '.data[0].b64_json' | base64 --decode > cup-4k.png

参数对照(与 OpenAI 官方)

下表只覆盖 openai/gpt-image-2.5-sunburst、openai/gpt-image-2.5-flare、openai/gpt-image-2 三个模型。 标为「不支持」的参数传了也不会生效,不要依赖;「—」表示本页不作承诺。

Nano Banana 2.1(Gemini 出图)

google/gemini-nano-banana-2.1(Google 2026-10-06 正式发布)走与上面相同的 OpenAI 兼容端点: 文生图 /v1/images/generations,图生图 /v1/images/edits,同步返回 {created, data:[{b64_json}]}。 档位由 size 决定,画幅可以用 aspect_ratio 直接指定:

• aspect_ratio(可选):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。传了就以它为准;不传则按 size 的长宽比取最接近的一种,"2K" / "4K" 这类字面量由模型自选。其他取值返回 400,不扣费。
• output_format:缺省 PNG;传 jpeg 返回 JPEG(4K PNG 约 20 MB,在意体积时建议用 JPEG)。
• n 必须为 1;不支持 mask;图生图最多 10 张参考图,传法同上。
• 单张约 25–50 秒。
• 只能同步调用:异步 job(/v1/jobs)不接这个模型。
• 账户首次充值后可用。

curl https://api.routemux.com/v1/images/generations \
  -H "Authorization: Bearer $ROUTEMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-nano-banana-2.1",
    "prompt": "An infographic about the water cycle with clear English labels",
    "size": "2K",
    "aspect_ratio": "4:5"
  }' | jq -r '.data[0].b64_json' | base64 --decode > water-cycle-2k.png

Nano Banana Pro(Gemini 3 Pro Image)

google/gemini-3-pro-image 是 Google 出图系列里的 Pro 款,模型 id 写 google/gemini-3-pro-image、gemini-3-pro-image 或 gemini-nano-banana-pro 都可以。调用方式与 Nano Banana 2.1 相同(同样的端点、size 档位、aspect_ratio、output_format):

与 Nano Banana 2.1 的不同:

• aspect_ratio 只有 10 种: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)。其他取值返回 400,不扣费。
• 图生图最多 8 张参考图。
• 4K 即使要 PNG,实测也会返回 JPEG。
• 单张约 30–60 秒。
• Gemini 原生出图接口(generateContent)不再提供,只能走上面的 OpenAI 兼容端点。

旧的 Gemini 出图模型 Gemini 2.5 Flash Image、3.1 Flash Image 已于 2026-10-18 退役,调用返回 410,请改用 Nano Banana 2.1。

长任务与异步 job

图像和视频生成可能比一个同步 HTTP 请求该挂住的时间更长。启用后,异步 job 表面允许你 提交任务并轮询结果:

POST   /v1/jobs        # kind: "image_generation" | "video_generation"
GET    /v1/jobs/:id
GET    /v1/jobs
DELETE /v1/jobs/:id     # 取消排队中的 job

异步 job 仍用你的 API 密钥鉴权、预扣钱包 Credit,并走与同步请求相同的计费路径结算 —— 没有独立的计费通道。Job 状态在 queued、running、completed、failed、cancelled、 expired 之间流转。传 X-Idempotency-Key,让重试的提交返回已有 job 而不是新建一个重复任务。

视频专属的模式见 视频生成。