GPT Image 2.6 API：OpenAI 接入指南

通过 OpenAI Images API 将图片生成接入自己的应用。先生成静态图片并检查返回文件，再扩展到编辑、GIF 或 SVG。本指南单独说明官方 API，与本站浏览器生成器区分。

配置 OpenAI 认证

使用具备相应模型权限的 OpenAI API 密钥。在服务端设置 OPENAI_API_KEY，并以 Bearer token 认证。不要将密钥打包到浏览器或放入公开环境变量。模型权限、验证要求及限流取决于 OpenAI 账号。

GPT Image 2.6 Flare 与 Sunburst 模型 ID

model 使用 gpt-image-2.6-flare 或 gpt-image-2.6-sunburst。新图片使用 POST /v1/images/generations，带图片输入的编辑使用 POST /v1/images/edits。比较模型时保持提示词与参数一致。

模型	OpenAI 模型 ID
flare	`gpt-image-2.6-flare`
sunburst	`gpt-image-2.6-sunburst`

服务端 JavaScript 示例

安装官方 openai Node.js SDK，在服务端环境中设置 OPENAI_API_KEY。示例将 base64 响应保存为 PNG；实际执行会产生 OpenAI API 调用费用。

// npm install openai
import OpenAI from "openai";
import { writeFile } from "node:fs/promises";

const client = new OpenAI(); // reads OPENAI_API_KEY
const result = await client.images.generate({
  model: "gpt-image-2.6-flare",
  prompt: "A blue ceramic mug on a pale stone table, soft window light",
  size: "1024x1024",
  quality: "medium",
  complexity: "medium",
  output_format: "png",
  n: 1,
});
const encoded = result.data?.[0]?.b64_json;
if (!encoded) throw new Error("No image returned");
await writeFile("mug.png", Buffer.from(encoded, "base64"));

图片、GIF、SVG 与参考图参数

参数	传入内容
`prompt`	描述主体、构图和约束。编辑时明确哪些部分必须保持不变。
`size`	使用 size，例如 1024x1024；尺寸及总像素限制以当前模型文档为准。
`quality`	渲染细节：这些模型支持 low、medium、high、xhigh、max。
`complexity`	使用 complexity：low、medium、high，规划复杂度与画质分开控制。
`output_format`	选择支持的输出格式，例如 png、gif、svg。请检查实际下载文件，不能只凭请求参数判断格式是否正确。
`image`	通过 multipart form data 向 /v1/images/edits 上传图片文件；在提示词中说明修改目标及必须保留的部分。
`frame_count / frame_duration_ms`	GIF 的 frame_count 支持 2–16 帧；frame_duration_ms 支持 20–2000 毫秒，按 10 毫秒取整。默认值及像素限制请查看 OpenAI 文档。

GIF 使用 output_format=gif，解码后保存为 .gif；SVG 请求 svg 并保存为 .svg。请检查实际文件的尺寸、透明背景和帧节奏。本站表单预设不代表官方 API 的最大能力。

GPT Image 2.6 API 费用与本站积分

OpenAI API 与本站独立计费。官方价格页列出模型 token 单价，输出成本取决于实际 token 用量，输入 token 也可能产生费用。建议用代表性请求核对 usage，不要假定每张图片固定收费。本站浏览器每次成功生成使用 20 积分，次数包与订阅不能充值到 OpenAI API 账号。

处理认证、限流与失败请求

401 时检查 OpenAI 密钥和认证头。权限错误时检查项目权限及模型可用性。400 时核对错误信息及参数。429 时先区分速率限制和额度不足，再按退避策略重试。遇到 5xx 或超时，请保留请求 ID 排查，避免盲目重复提交付费请求。

可以把本站当作公开 API 调用吗？

本页是 OpenAI API 教程，不是本站提供的公开 API 服务。自己的应用请使用 OpenAI 凭据。如果希望直接在浏览器操作，可使用本站生成器，一起保存提示词、参数与原文件，无需编写接入代码。

文档与下一步

文档核对日期：2026 年 11 月 6 日。代码为接入示例，本次编写指南没有额外执行该示例生成。