Skip to content

图像生成 ​

兼容 OpenAI Images,根据文字生成图片。

POSThttps://api.codingrouter.ai/v1/images/generations
模型令牌分组计费
gpt-image-2、gpt-image-2.5gpt_image按 token
grok-imagine-image-2.0grok按次

Gemini 图像模型用 Gemini 接口 生成。

鉴权 ​

Authorization: Bearer <令牌>

请求参数 ​

参数类型必填说明
modelstring是见上表
promptstring是图片描述
sizestring否尺寸,规则按模型不同,见下文
qualitystring否GPT Image:low、medium、high、auto;gpt-image-2.5 另有 xhigh、max。不传按 low 计费
ninteger否GPT Image 生成张数,1 到 10;Grok 每次 1 张
output_formatstring否GPT Image:png(默认)、jpeg、webp
output_compressioninteger否0 到 100,用于 jpeg 和 webp
backgroundstring否GPT Image:auto、opaque、transparent(透明背景需 png 或 webp)
moderationstring否GPT Image:auto、low
response_formatstring否只支持 b64_json,传 url 返回 400

结果只以 base64(b64_json)返回,不提供图片链接。

GPT Image 尺寸 ​

size 为 auto(默认)或 宽x高,宽x高 需同时满足:

  • 宽和高都是 16 的倍数,单边不超过 3840;
  • 总像素在 655,360 到 8,294,400 之间(最大相当于 3840x2160);
  • 宽高比在 1:3 到 3:1 之间。

常用值:1024x1024、1536x1024、1024x1536、2048x2048、3840x2160。

Grok Imagine 尺寸与价格 ​

size实际输出每张价格
不传 / 1024x10241024×1024 JPEG$0.004
1536x10242496×1664 PNG$0.005
1024x15361664×2496 PNG$0.005
2048x20482048×2048 PNG$0.006
2048x11522816×1584 PNG$0.006

默认尺寸返回 JPEG,其他尺寸返回 PNG,保存时按实际格式命名。

请求示例 ​

bash
curl https://api.codingrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $CODINGROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只在雪地里奔跑的柴犬,电影感光线",
    "size": "1024x1024",
    "quality": "low"
  }' | jq -r '.data[0].b64_json' | base64 --decode > out.png
python
import base64
from openai import OpenAI

client = OpenAI(base_url="https://api.codingrouter.ai/v1", api_key="sk-你的令牌", timeout=300)

result = client.images.generate(
    model="gpt-image-2",
    prompt="一只在雪地里奔跑的柴犬,电影感光线",
    size="1024x1024",
    quality="low",
)
with open("out.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))
js
import fs from "node:fs";
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.codingrouter.ai/v1",
  apiKey: process.env.CODINGROUTER_KEY,
  timeout: 300_000,
});

const result = await client.images.generate({
  model: "gpt-image-2",
  prompt: "一只在雪地里奔跑的柴犬,电影感光线",
  size: "1024x1024",
  quality: "low",
});
fs.writeFileSync("out.png", Buffer.from(result.data[0].b64_json, "base64"));

Grok:把 model 换成 grok-imagine-image-2.0,令牌换成 grok 分组,去掉 quality。

响应示例 ​

json
{
  "created": 1794806592,
  "data": [{"b64_json": "<base64 图片数据>"}],
  "background": "opaque",
  "output_format": "png",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 22,
    "input_tokens_details": {"image_tokens": 0, "text_tokens": 22},
    "output_tokens": 196,
    "output_tokens_details": {"image_tokens": 196, "text_tokens": 0},
    "total_tokens": 218
  }
}

Grok 的响应只有 created 和 data。

GPT Image 计费 ​

按 token 计费,官方单价(每百万 token,实际按分组折扣):

项目价格
文本输入$5
文本输入(缓存)$1.25
图片输入$8
图片输入(缓存)$2
图片输出$30

输出 token 由尺寸和 quality 决定,例如 1024x1024 low 约 196 个,medium 约 1756 个。

接入建议 ​

  • 客户端超时设到 300 秒,高质量大尺寸可能超过 1 分钟。
  • 400 先改参数再重试;429 和 5xx 可以重试。