图像模型进阶用户更新于
POST/v1/images/generations

API 调试台

POST/v1/images/generations
查看密钥

使用你填写的 Key 发送真实请求，按对应接口计费。

GPT Image 2.6 Flare

请求 ID gpt-image-2.6-flare

协议

认证

请求需要 API Key。在控制台的 API Key 管理 获取密钥。发送 JSON 请求时，设置 Content-Type: application/json。

  • Authorization: Bearer YOUR_API_KEY

请求参数

POST /v1/images/generations

参数类型是否必填说明
modelstring必填填写此模型的请求 ID gpt-image-2.6-flare.
promptstring必填描述要生成的图像。
sizestring视条件生成 GIF 时使用 auto。静态图使用 aspect_ratio 和 image_size。
aspect_ratiostring视条件输出图像的宽高比。 可用值 auto, 1:1, 3:2, 2:3, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4. 默认 auto. 仅静态图使用，GIF 请求省略。
image_sizestring视条件输出分辨率档位。 可用值 1K, 2K, 4K. 省略时根据 size 推导。 默认 1K. 仅静态图使用，GIF 请求省略。
resolutionstring视条件静态图的分辨率别名。如果与 image_size 同时填写，两者必须相同。 仅静态图使用，GIF 请求省略。
output_formatstring选填png 生成静态图，gif 生成动画。GIF 时使用 size: "auto"、n: 1，帧参数自动设置。 默认 png.
backgroundstring选填仅支持自动背景。 可用值 auto.
qualitystring选填生成质量设置。 可用值 auto, low, medium, high. 默认 auto.
ninteger选填每次请求生成一张。 默认 1.
image_urlsstring[]选填JSON 参考图数组。每项可为公开 HTTPS 图片链接或 Base64 图片 data URL。 兼容字段 image_input. 参考图上限 8. 2K 或 4K 静态图请使用 PNG、JPEG 或 WebP 参考图。
?asyncstring选填URL 查询参数。传 1、true 或 yes 返回 202 和 task_id。省略时等待生成结果。

POST /v1/images/edits

参数类型是否必填说明
modelstring必填填写此模型的请求 ID gpt-image-2.6-flare.
promptstring必填描述要对参考图进行的修改。
aspect_ratiostring选填输出图像的宽高比。 可用值 auto, 1:1, 3:2, 2:3, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4. 默认 auto.
image_sizestring选填输出分辨率档位。 可用值 1K, 2K, 4K. 省略时根据 size 推导。 默认 1K.
resolutionstring选填静态图的分辨率别名。如果与 image_size 同时填写，两者必须相同。
output_formatstring选填编辑输出使用 PNG。 默认 png.
backgroundstring选填仅支持自动背景。 可用值 auto.
qualitystring选填生成质量设置。 可用值 auto, low, medium, high. 默认 auto.
ninteger选填每次请求生成一张。 默认 1.
image_urlsstring[]视条件JSON 参考图数组。每项可为公开 HTTPS 图片链接或 Base64 图片 data URL。 兼容字段 image_input. 参考图上限 8. 使用 JSON 编辑时至少传一张。 2K 或 4K 静态图请使用 PNG、JPEG 或 WebP 参考图。
image[]file[]视条件使用 multipart/form-data 编辑时，至少上传一张图片，可重复传此字段。单文件也可用 image。 参考图上限 8. 2K 或 4K 静态图请使用 PNG、JPEG 或 WebP 参考图。
?asyncstring选填URL 查询参数。传 1、true 或 yes 返回 202 和 task_id。省略时等待生成结果。

请求示例

先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY，并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时，按对应客户端指南配置。

示例中的素材 URL 和素材 ID 需要替换成自己的有效素材。

Images Generations

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-flare",
  "prompt": "A watercolor illustration of a paper lantern by a lake.",
  "output_format": "png",
  "aspect_ratio": "16:9",
  "image_size": "1K",
  "n": 1
}'

Images Generations · 生成 GIF

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations?async=1' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-flare",
  "prompt": "A paper lantern sways gently in a seamless loop.",
  "output_format": "gif",
  "size": "auto",
  "n": 1
}'

Images Generations · 参考图生成 GIF

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations?async=1' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-flare",
  "prompt": "Animate the lantern in the reference image in a seamless loop while preserving the composition.",
  "output_format": "gif",
  "size": "auto",
  "n": 1,
  "image_urls": [
    "https://example.com/reference.png"
  ]
}'

Images Edits

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/edits' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-flare",
  "prompt": "Change the background to a pale blue wall. Preserve the subject.",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "output_format": "png",
  "aspect_ratio": "16:9",
  "image_size": "1K",
  "n": 1
}'

查询图片任务

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

响应与任务

HTTP 200 · 同步成功

使用 ?sync=1 时，成功响应中的 data[].url 是图片地址。created 为 Unix 秒时间戳，id 为任务 ID。

json
{
  "id": "d142c93a-de26-40c9-be62-0de840d10960",
  "created": 1781599773,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

HTTP 202 · 异步提交

json
{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "pending"
}

使用 ?async=1 后，用同一 API Key 查询 GET /v1/images/tasks/{task_id}。status 可为 pending、completed 或 failed。完成后从 result_url 读取图片地址。

HTTP 200 · 查询到已完成任务

json
{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "completed",
  "model": "gpt-image-2.6-flare",
  "result_url": "https://example.com/generated-image.png"
}

常见错误

查询返回 failed 时读取 error。若存在 error_detail，根据 retryable 判断是否适合重新提交。

响应示例与错误处理

完整接入指南 · 查看完整接口指南，了解请求字段、任务状态和响应格式。

能力与限制

  • text_to_image · 支持
  • image_to_image · 支持
  • image_editing · 支持
  • reference_images · 有条件支持 — 需要以支持的请求格式提供有效参考图
  • 限制 参考图：最多 8 张 · 分辨率: 1K, 2K, 4K · 输入：Static PNG or animated GIF. GIF uses size: auto and n: 1. Static 2K/4K reference images must be PNG, JPEG, or WebP.

模型能力目录 · 查看定价

相关指南

图片生成 API

用 OpenAI 兼容接口生成或编辑图片，提交提示词、尺寸和参考图，读取同步结果或查询异步任务状态。

模型能力目录

按文本、图片和视频分类查看公开模型的规范化请求 ID、兼容协议、支持客户端、工具调用、输入输出能力与限制，并根据最近核对日期判断信息新鲜度。

注册并获取 API Key