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-1.5	快速 GPT 图片生成与编辑，文字渲染能力强。
gpt-image-2	OpenAI 质量档位、自定义尺寸、更大输出和图片编辑。

GPT Image 字段

字段	类型	必填	说明
model	string	是	使用 gpt-image-1.5 或 gpt-image-2。
prompt	string	是	图片提示词，长度限制取决于所选模型。
image	file 或 file[]	编辑必填	调用 /v1/images/edits 时上传输入图片文件。
n	number	否	返回图片数量。
size	string	否	auto、预设尺寸，或有效的自定义 WIDTHxHEIGHT。
quality	string	否	模型支持时可选 low、medium、high 或 auto。
response_format	string	否	模型支持时可选 url 或 b64_json。

自定义尺寸必须是 16 的倍数，像素总量在 655,360 到 8,294,400 之间，且宽高比不超过 3:1。

价格

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

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" \
  -F "model=gpt-image-2" \
  -F "prompt=Replace the background with a bright studio setup" \
  -F "image=@input.png" \
  -F "size=auto" \
  -F "quality=auto"

响应

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