图像生成
兼容 OpenAI Images,根据文字生成图片。
POST
https://api.codingrouter.ai/v1/images/generations| 模型 | 令牌分组 | 计费 |
|---|---|---|
gpt-image-2、gpt-image-2.5 | gpt_image | 按 token |
grok-imagine-image-2.0 | grok | 按次 |
Gemini 图像模型用 Gemini 接口 生成。
鉴权
Authorization: Bearer <令牌>
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 见上表 |
prompt | string | 是 | 图片描述 |
size | string | 否 | 尺寸,规则按模型不同,见下文 |
quality | string | 否 | GPT Image:low、medium、high、auto;gpt-image-2.5 另有 xhigh、max。不传按 low 计费 |
n | integer | 否 | GPT Image 生成张数,1 到 10;Grok 每次 1 张 |
output_format | string | 否 | GPT Image:png(默认)、jpeg、webp |
output_compression | integer | 否 | 0 到 100,用于 jpeg 和 webp |
background | string | 否 | GPT Image:auto、opaque、transparent(透明背景需 png 或 webp) |
moderation | string | 否 | GPT Image:auto、low |
response_format | string | 否 | 只支持 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 | 实际输出 | 每张价格 |
|---|---|---|
不传 / 1024x1024 | 1024×1024 JPEG | $0.004 |
1536x1024 | 2496×1664 PNG | $0.005 |
1024x1536 | 1664×2496 PNG | $0.005 |
2048x2048 | 2048×2048 PNG | $0.006 |
2048x1152 | 2816×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.pngpython
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 可以重试。
