GPT Image

GPT Image 模型适合提示词遵循、文字渲染、清晰构图或大尺寸输出要求较高的场景。Pixapi 使用 OpenAI 兼容图片 endpoint 暴露这些模型。

API 形式

操作	Endpoint	模式
图片生成	POST /v1/images/generations	同步
图片生成任务	POST /v1/async/images/generations	异步
图片编辑	POST /v1/images/edits	同步
图片编辑任务	POST /v1/async/images/edits	异步

模型 id

模型 id	适合场景
gpt-image-2	OpenAI 质量档位、自定义尺寸、更大输出和图片编辑。
gpt-image-1.5	快速 GPT 图片生成与编辑，文字渲染能力强。

GPT Image 字段

字段	类型	必填	说明
model	string	是	使用 gpt-image-2 或 gpt-image-1.5。
prompt	string	是	图片提示词，长度限制取决于所选模型。
image	string 或 string[]	编辑必填	输入图片 URL；支持多参考图时可传图片 URL 数组。
n	number	否	返回图片数量，当前仅支持传 1。
size	string	否	auto、1024x1024、1536x1024、1024x1536 等常用预设尺寸，或自定义 WIDTHxHEIGHT 值。
quality	string	否	模型支持时可选 low、medium、high 或 auto。

自定义尺寸必须使用 WIDTHxHEIGHT 格式，并满足供应商限制和所选输出档位。

价格

模型	每张积分
gpt-image-2	1 起
gpt-image-1.5	1 起

gpt-image-1.5 仅按 1K 尺寸计费（1024x1024、1536x1024、1024x1536 或 auto）：low/medium/high 为 1/4/14。不支持 2K 或 4K。

gpt-image-2 按下方尺寸和质量矩阵计费。quality=auto 按 high 计费，size=auto 默认进入 1K 档。

尺寸档	长边	low	medium	high / auto
1K	<= 1536px	1	4	14
2K	<= 2048px	2	17	67
4K	<= 3840px	4	34	133

请求显示的 costCredits 等于矩阵值乘以 n。

生成示例

const response = await fetch('https://api.pixapi.ai/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt: 'A clean SaaS hero image showing API model orchestration',
    n: 1,
    size: '1536x1024',
    quality: 'high',
  }),
});

const image = await response.json();

编辑示例

curl https://api.pixapi.ai/v1/images/edits \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Replace the background with a bright studio setup",
    "image": "https://cdn.example.com/input.png",
    "size": "auto",
    "quality": "auto"
  }'

响应

{
  "created": 1766880000,
  "data": [
    {
      "url": "https://cdn.pixapi.ai/generated/gpt-image.png"
    }
  ]
}