Pixapi

外观

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.5-flare速度优先，适合商品图变体和批量创作。
gpt-image-2.5-sunburst质量优先，适合精细合成、广告素材和局部编辑。
gpt-image-2OpenAI 质量档位、自定义尺寸、更大输出和图片编辑。
gpt-image-1.5快速 GPT 图片生成与编辑，文字渲染能力强。

Flare 和 Sunburst 的请求参数、同步/异步生成与编辑接口及积分计费均与 GPT Image 2 一致。切换模型只需修改 model 值。

请求字段 ​

通用字段放在请求体一级，下面列出的模型专用参数放进 providerOptions。

字段类型必填说明
modelstring是gpt-image-2, gpt-image-1.5, gpt-image-2.5-flare, gpt-image-2.5-sunburst. 模型 ID，区分大小写。
promptstring是描述主体、构图、风格或需要修改的内容。Pixapi 最多保留前 2,000 字符；生成和编辑都要提供非空提示词。
ninteger否默认 1，只支持整数 1。
sizestring否填写 宽x高 像素尺寸，例如 1024x1024。 默认 auto。自定义尺寸：宽高为 16 的倍数，长边 ≤ 3840，宽高比不超过 3:1，总像素 655,360–8,294,400。
imagestring / string[]编辑时必填公网 HTTP(S) 图片 URL 或 URL 数组；/images/edits 必填。 最多 14 个 URL，不支持 Base64 输入。
qualitystring否auto（默认）、low、medium、high，较高质量可能耗时更长。
providerOptionsobject否模型专用选项，详见下表。

providerOptions ​

本表所有字段都写在 providerOptions 内，不要与 model 并列。

字段类型说明
output_formatstring输出图片格式：png（默认，支持透明背景）、jpeg（文件更小，不含 Alpha）、webp（支持透明背景）。
backgroundstring背景模式：auto（默认）、opaque（不透明）、transparent（透明）。transparent 只能与 output_format: "png" 或 output_format: "webp" 搭配，JPEG 不支持 Alpha 通道。
moderationstring内容审核强度：auto 或 low（更宽松）。默认：1.5／2 为 auto，2.5 为 low。
output_compressioninteger输出压缩强度 0–100，仅对 jpeg 和 webp 输出生效。
mask_urlstring局部重绘的公网 PNG 遮罩 URL。必须传 image，且与第一张图尺寸一致；透明像素表示编辑区域。使用带 Alpha 通道、低于 4 MB 的 PNG。
nsfw_checkboolean是否审核提示词和图片，默认 false。

输入规则 ​

Pixapi 只接受 1 张输出、最多 14 张参考图。输出尺寸请通过 size 指定。

自定义尺寸必须使用 WIDTHxHEIGHT 格式（例如 1536x864），并同时满足以下全部限制：

限制要求
16 的倍数宽和高都必须能被 16 整除。
宽高比介于 1:3 到 3:1 之间。
单边上限任何一边都不得超过 3840px。
像素下限不得少于 655,360（约等于 1024x640）。
像素上限不得超过 8,294,400（4K，等于 3840x2160）。

由于上限按总像素数计算，4K 并不等于 3840px 的长边：正方形时边长最大只能到 2880x2880（√8,294,400 = 2880）。各版式可用的最大尺寸如下：

版式尺寸总像素
横版3840x21608,294,400
竖版2160x38408,294,400
正方2880x28808,294,400
超宽 3:13840x12804,915,200

超过 2560x1440 的输出属于实验性尺寸，稳定性不作保证。

价格 ​

模型每张积分
gpt-image-2.5-flare1 起
gpt-image-2.5-sunburst1 起
gpt-image-21 起
gpt-image-1.51 起

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

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

尺寸档长边lowmediumhigh / auto
1K<= 1536px1414
2K<= 2048px21767
4K<= 3840px434133

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

生成示例 ​

ts
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.5-flare',
    prompt: 'A clean SaaS hero image showing API model orchestration',
    n: 1,
    size: '1536x1024',
    quality: 'high',
  }),
});

const image = await response.json();

编辑示例 ​

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

响应 ​

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