4Z API

创建 gpt-image-2.6-flare

接口: POST https://4zapi.com/v1/images/generations

gpt-image-2.6-flare 是 gpt-image-2.6 系列的极速经济型版本，出图快、成本更低，适合批量预览、草稿快速生成。 需要更高画质、细节光影或多轮局部编辑一致性时，请使用 gpt-image-2.6-sunburst。

  • 同步接口，直接返回图片，无需轮询。
  • 参数与 gpt-image-2.5 一致；画质 quality 支持 xhigh、max。
  • 返回格式：未传 response_format 时返回 b64_json；传 url 时返回图片链接，链接有效期 7 天，请及时转存。
  • 图片编辑请使用 POST /v1/images/edits，model 同样填 gpt-image-2.6-flare。

参数

  • Content-Type (header, string, 必填)

请求体 (application/json)

  • model (string, 必填): 模型名 gpt-image-2.6-flare 快速迭代，延迟低，适合交互式生成与高频试稿 gpt-image-2.6-sunburst 精细视觉作业，复杂构图与图内文字更稳，生成更慢 ["gpt-image-2.6-flare", "gpt-image-2.6-sunburst"]
  • prompt (string, 必填): 所需图像的文本描述。最大长度为 32000 个字符。 GIF 输出时请在描述中写明主体、运动方式与循环效果。
  • background (string): 背景 可选：auto（默认）、opaque、transparent transparent 时 format 必须为 png 或 webp ["auto", "opaque", "transparent"]
  • complexity (string): 复杂度（2.6 新增）：渲染前的规划强度，与 quality（渲染画质）相互独立。 可选：low 、 medium 、 high（省略时按模型默认，默认 high） low 适合局部修改（换背景、改招牌）；high 适合密集文字、复杂布局与物体关系。 复杂度越高延迟越大，也可能引入多余改动，建议按任务对比后再定。 SVG 输出时 complexity 控制参考图，与 svg.reasoning.effort 相互独立。 调整复杂度不另收费。 ["low", "medium", "high"]
  • frame_count (integer): GIF 帧数（2-16），仅 output_format=gif 可用，默认 9。 帧数 × 帧尺寸 × n 需满足模型像素预算，超限请减小 frame_count、帧尺寸或 n。
  • frame_duration_ms (integer): GIF 每帧停留毫秒数，仅 output_format=gif 可用，默认 200，最小 20。 按 10ms 取整，编码后单帧延迟上限 655,350ms。
  • moderation (string): 内容审核严格度 可选：auto（默认）、low ["auto", "low"]
  • n (integer): 要生成的图像数。必须介于 1 和 10 之间。SVG 输出时必须为 1。
  • output_compression (integer): 压缩率（0-100），仅 jpeg / webp 可用。默认 100。
  • output_format (string): 图片格式 可选：png（默认）、jpeg、webp、gif、svg 透明背景请用 png 或 webp。 gif 为 2.6 新增动图输出，配合 frame_count / frame_duration_ms 使用； svg 为 2.6 新增矢量输出，仅本接口支持且 n 必须为 1。 gif 与 svg 不支持流式、partial_images、prompt_rewriter、自定义 output_compression。 （官方字段名 output_format；2.5 及更早文档中写作 format 的即本字段。） ["png", "jpeg", "webp", "gif", "svg"]
  • quality (string): 图片画质 可选：low 、 medium 、 high 、 xhigh 、 max 、 auto（默认） low 适合草稿；xhigh / max 更精细但延迟和费用更高。 SVG 输出时 quality 控制参考图的渲染画质。 ["low", "medium", "high", "xhigh", "max", "auto"]
  • response_format (string): url：返回图片 URL b64_json：返回 Base64 图片数据 ["url", "b64_json"]
  • size (string): 图片尺寸 1024x1024 正方形 1536x1024 横版 1024x1536 竖版 auto 默认，由模型自动选择 自定义尺寸写成 WIDTHxHEIGHT（如 1536x864）： 1. 宽、高均为 16px 的倍数 2. 长宽比在 1:3 与 3:1 之间 3. 单边最大 3840px 4. 总像素范围 655,360 ~ 8,294,400 超过 2560x1440 的分辨率属实验性能力。 GIF 输出时 size 描述每一帧的尺寸；帧数 × 帧尺寸需满足模型的像素预算。
  • svg (object): SVG 作者模型与推理设置（仅 output_format=svg 时使用）。 顶层 model 选择生成参考图的图像模型；svg.model 选择撰写 SVG 的作者模型。 开启模型选择时必须提供 svg.model，缺失会报错：SVG generation requires '***.model'。 若收到该报错，说明请求未携带（或中转未透传）svg 对象。 计费 = 参考图按图像模型费率 + SVG tokens 按作者模型费率，响应 svg_usage 汇报作者模型用量。

请求示例

{
  "model": "gpt-image-2.6-flare",
  "n": 1,
  "prompt": "一只橘猫趴在窗台上晒太阳，水彩画风格",
  "size": "1024x1024"
}