> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # GPT Image 2.6 图像生成 > - GPT Image 2.6 (gpt-image-2.6-sunburst / gpt-image-2.6-flare) 模型支持文本转图片、图生图、图像编辑、标注引导编辑，并支持输出 GIF 动图与 SVG 矢量图 - 异步处理模式，使用返回的任务ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的图像链接，有效期为24小时，请尽快保存 ## OpenAPI ````yaml cn/api-manual/image-series/gpt-image-2.6/gpt-image-2.6-image-generation.json POST /v1/images/generations openapi: 3.1.0 info: title: gpt-image-2.6接口 description: 使用AI模型创建图像任务，支持多种模型和参数配置 license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: 生产环境 security: - bearerAuth: [] tags: - name: 图像生成 description: AI图像生成相关接口 paths: /v1/images/generations: post: tags: - 图像生成 summary: gpt-image-2.6接口 description: >- - GPT Image 2.6 (gpt-image-2.6-sunburst / gpt-image-2.6-flare) 模型支持文本转图片、图生图、图像编辑、标注引导编辑，并支持输出 GIF 动图与 SVG 矢量图 - 异步处理模式，使用返回的任务ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的图像链接，有效期为24小时，请尽快保存 operationId: createImageGenerationGptImage26 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ImageGenerationRequest' examples: text_to_image: summary: 文生图（最简） value: model: gpt-image-2.6-sunburst prompt: 海面上绚丽多彩的美丽日落 text_to_image_hd: summary: 文生图（高清 16:9） value: model: gpt-image-2.6-sunburst prompt: 黄昏时分未来都市天际线的电影级广角镜头 size: '16:9' resolution: 4K quality: high 'n': 1 complexity: high text_to_image_pixel: summary: 文生图（指定像素） value: model: gpt-image-2.6-sunburst prompt: 极简主义 Logo 设计 size: 1024x1024 quality: medium image_edit: summary: 图生图 / 图像编辑 value: model: gpt-image-2.6-sunburst prompt: 在她旁边加一只可爱的小猫 size: '1:1' resolution: 1K quality: medium image_urls: - https://example.com/input.png callback_url: https://your-domain.com/webhook/image-done image_inpaint: summary: 局部重绘（带 mask） value: model: gpt-image-2.6-sunburst prompt: 把天空换成繁星点点的夜空 size: '1:1' resolution: 1K quality: medium image_urls: - https://example.com/input.png mask_url: https://example.com/mask.png markup_edit: summary: 标注引导编辑（markup） value: model: gpt-image-2.6-flare prompt: 把红圈里的花瓶改成纯钴蓝色陶瓷，其余部分保持不变，并去掉红圈 quality: medium image_urls: - https://example.com/kitchen.png markup_url: https://example.com/markup.png batch_generation: summary: 批量生成 value: model: gpt-image-2.6-sunburst prompt: 像素风格的可爱机器人 size: '1:1' resolution: 2K quality: high 'n': 4 gif_animation: summary: GIF 动图 value: model: gpt-image-2.6-flare prompt: 一盏灯笼在夜风中轻轻摇晃，首尾无缝循环 output_format: gif size: auto quality: medium model_params: frame_count: 9 frame_duration_ms: 200 svg_vector: summary: SVG 矢量图 value: model: gpt-image-2.6-sunburst prompt: 一家面包店的扁平风格 Logo，麦穗与圆形徽章 output_format: svg quality: medium model_params: svg_model: gpt-6.1-terra gif_animation_pixel: summary: GIF 动图（指定每帧尺寸） value: model: gpt-image-2.6-flare prompt: 一只小猫眨眼，动作自然，首尾循环 output_format: gif size: 720x720 quality: low model_params: frame_count: 16 frame_duration_ms: 200 responses: '200': description: 图像任务创建成功 content: application/json: schema: $ref: '#/components/schemas/ImageGenerationResponse' '400': description: 请求参数错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: 未认证、Token无效或过期 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: 配额不足、需要充值 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: 无权限访问 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: gpt-image-2.6-sunburst' type: invalid_request_error '429': description: 请求频率超限 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: 服务器内部错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: ImageGenerationRequest: type: object required: - model - prompt properties: model: type: string description: |- 图像生成模型名称，稳定性和可控性更好，适用于商业场景 | 模型 ID | 定位 | |---|---| | `gpt-image-2.6-sunburst` | 细节表现更好，适合精细的视觉创作 | | `gpt-image-2.6-flare` | 出图更快，适合快速迭代 | 两个模型的参数完全一致；同一 `quality` 档位下实际消耗的 token 可能略有差异，以返回的 `usage` 为准。 enum: - gpt-image-2.6-sunburst - gpt-image-2.6-flare default: gpt-image-2.6-sunburst example: gpt-image-2.6-sunburst prompt: type: string description: |- 提示词，描述想要生成的图像，或描述如何编辑已输入的图像 **长度限制（需同时满足）：** - 最多 `32,000` 字符（按 Unicode 码点统计） - `prompt` 文本本身经 UTF-8 编码后，不超过 `60,000` 字节 不同字符占用的 UTF-8 字节数不同，请以实际编码后的字节数为准。 超出任一限制时，请缩短提示词后重新提交。 **建议：** 提示词超过 `8000` tokens 时，生成图像可能与预期不符，建议精简提示词 example: 海面上绚丽多彩的美丽日落 maxLength: 32000 image_urls: type: array description: >- 参考图像列表，支持公网 URL，用于图生图与图像编辑功能 **注意：** - 单次请求支持输入图像数量：`1~16`张 - 单张图像大小：不超过 `50MB` - 单张图像像素：宽 × 高不超过 `178,956,970` px - 单张图像边长：宽 / 高均不超过 `23170` px，超过可能产生异常 - 支持的文件格式：`.jpeg`、`.jpg`、`.png`、`.webp` - 使用 URL 时，需要服务器能直接查看，或者图像URL在访问时会直接进行下载（一般这种URL是以图像的扩展名作为结尾，例如`.png`、`.jpg`） - 图生图/图像编辑场景下，传入的参考图本身会产生额外的图像输入 token 消耗 - 使用 `markup_url` 时，标注作用于第一张图像，其余图像作为参考；第一张图像的宽 × 高不得超过 `16,777,216` px - `output_format` 为 `svg` 时不支持传入参考图像 items: type: string format: uri example: - https://example.com/image1.png - https://example.com/image2.png mask_url: type: string format: uri description: >- 局部重绘遮罩图 URL —— 标记参考图上需要重新生成的区域。**仅在图像编辑模式下生效**（必须同时传 `image_urls`）；纯文生图时即使传了 `mask_url` 也会被忽略。 **格式要求：** - **必须是带 alpha 通道的 PNG**：透明像素（`alpha < 255`）= 需要重绘的区域，不透明像素 = 保留原图 - **遮罩尺寸必须与参考图完全一致**（宽 × 高，单位像素） - 单次请求仅支持一张遮罩 **注意：** - 至少要在 `image_urls` 里提供 1 张参考图，单独传 mask 不会生效 - 不能与 `markup_url` 同时使用 - 常见错误： - `Invalid mask image format - mask image missing alpha channel`：上传的图没有 alpha 通道（JPEG、不透明 PNG 等），请重新导出带透明区域的 PNG - `Invalid mask image format - mask size does not match image size`：遮罩与参考图尺寸不一致，请将遮罩调整到与参考图完全相同的像素尺寸 example: https://example.com/mask.png markup_url: type: string format: uri description: >- 标注层图像的公网 URL —— 在参考图上用圆圈、箭头、涂鸦等标出需要修改的位置，配合 `prompt` 描述具体改动。**仅在图像编辑模式下生效**（必须同时传 `image_urls`）。 **格式要求：** - **必须是带透明像素的 PNG**：只画标注内容，其余区域保持透明，不要把标注直接画在原图上 - **尺寸必须与第一张参考图完全一致**（宽 × 高，单位像素） - 第一张参考图与标注层各自的宽 × 高都不得超过 `16,777,216` px - 文件大小：不超过 `50MB` **注意：** - 标注作用于 `image_urls` 中的第一张图像，其余图像作为参考 - 不能与 `mask_url` 同时使用 - 支持普通图片和 GIF 的编辑，不支持 SVG - 也可放在 `model_params.markup_url` 中；两处同时提供时，以顶层值为准 - 建议在 `prompt` 中同时说明需要保留的内容，例如"其余部分保持不变，并去掉红圈" example: https://example.com/markup.png size: type: string description: >- 生成图像的尺寸，默认 `auto`。普通图片和 SVG 参考图共用以下规则；GIF 使用第④项的独立规则。 **① 普通图片 / SVG 参考图：比例格式（15 种）** - `1:1`：正方形 - `1:2` / `2:1`：极竖/极横 - `1:3` / `3:1`：超竖/超横（临界 3:1） - `2:3` / `3:2`：标准竖/横 - `3:4` / `4:3`：传统竖/横 - `4:5` / `5:4`：社交媒体常用 - `9:16` / `16:9`：手机/桌面宽屏 - `9:21` / `21:9`：超宽屏 **② 普通图片 / SVG 参考图：显式像素格式**：`WxH`（或 `W×H`），例如 `1024x1024`、`1536x1024`、`3840×2160` - 宽、高均必须为 `16` 的整数倍 - 每条边范围：`[16, 3840]` - 像素预算：`655,360 ≤ width × height ≤ 8,294,400`（约 0.65 MP ~ 8.29 MP） - 长宽比：`≤ 3:1` **③ 普通图片 / SVG 参考图：`auto`**：由模型自动决定尺寸（此时 `resolution` 不生效） **④ GIF 输出**：`size` 表示每一帧的尺寸，仅支持 `auto` 与显式像素格式，不支持比例格式。 - `auto` 时每帧为 `512×512` - 显式帧尺寸的宽、高均须为 `16` 的正整数倍 - GIF 单帧不适用上述普通图片的 `655,360` 像素下限，例如 `512x512` 合法 - 所有帧合成后的整张图须满足边长、总像素及长宽比限制；具体拼法与每帧尺寸上限见 `model_params.frame_count` - `resolution` 不生效 **超限处理：** - 普通图片 / SVG 参考图的比例 + `resolution` 组合若超预算，会自动按比例缩到顶格（例如 4K 2:1 → 3840×1920） - GIF 显式帧尺寸超限会直接返回 HTTP 400，不会自动缩小 default: auto example: auto resolution: type: string description: |- 分辨率档位快捷参数，仅在 `size` 为比例格式时生效，显式像素格式与 GIF 输出下此字段被忽略 **像素预算规则**（根据目标总像素数和 `size` 比例推算宽高，结果向 16 的倍数对齐）： - `1K`：~1 MP（1024² = 1,048,576 像素） - `2K`：~4 MP（2048² = 4,194,304 像素） - `4K`：~8.29 MP（3840×2160 = 8,294,400 像素，即上限） **横版/正方形对应实际输出尺寸**（竖版尺寸为对应横版的宽高调换，例如 `2:3` = `3:2` 反转）： | 比例 | 1K | 2K | 4K | |---|---|---|---| | `1:1` | 1024×1024 | 2048×2048 | 2880×2880 | | `2:1` | 1456×720 | 2896×1456 | 3840×1920 \* | | `3:1` | 1776×592 | 3552×1184 | 3840×1280 \* | | `3:2` | 1248×832 | 2512×1680 | 3520×2352 | | `4:3` | 1184×880 | 2368×1776 | 3312×2480 \* | | `5:4` | 1152×912 | 2288×1824 | 3216×2576 | | `16:9` | 1360×768 | 2736×1536 | 3840×2160（UHD）| | `21:9` | 1568×672 | 3136×1344 | 3840×1648 \* | \* 表示超像素预算后按比例自动缩到顶格。取值大小写不敏感。 enum: - 1K - 2K - 4K default: 1K example: 1K quality: type: string description: |- 渲染质量，直接影响输出 token 数和费用，默认 `medium` | 取值 | 输出 token（1024²）| 图片输出费比例（1024²）| |---|---|---| | `low` | 824 | ~0.57× | | `medium` | 1,449 | 1.0× | | `high` | 1,756 | ~1.21× | | `xhigh` | 3,122 | ~2.15× | | `max` | 7,024 | ~4.85× | **注意：** - 上表仅比较图片输出费用，不包含输入费用和 SVG 作者模型费用 - 上表按 `1024×1024` 计算，输出 token 数会随图像总像素与宽高比变化，实际请以返回的 `usage` 为准 - GIF 输出时按所有帧合成的整张图计算；SVG 输出时作用于参考图 - 快速草稿用 `low`；成品建议对比几个档位后，再在细节、耗时与成本之间取平衡 enum: - low - medium - high - xhigh - max default: medium example: medium complexity: type: string description: |- 出图前的规划深度，与 `quality` 相互独立，默认 `high` - `low`：适合换背景、改招牌文字等局部改动 - `medium`：均衡 - `high`：适合文字密集、版式复杂或物体关系复杂的画面 **注意：** - 档位越高耗时越长，也可能引入不需要的改动，建议按任务对比效果 - 调整 `complexity` 不额外计费 - SVG 输出时作用于参考图 - 也可放在 `model_params.complexity` 中；两处同时提供时，以顶层值为准 enum: - low - medium - high default: high example: high background: type: string description: |- 输出图像的背景通道，默认 `opaque` - `opaque`：不透明背景，不带 alpha 通道 - `transparent`：保留 alpha 通道 **注意：** - `transparent` 目前是 Preview 功能，效果可能不稳定 - 使用 `transparent` 时，`output_format` 只能选 `png` 或 `webp` - `output_format` 为 `gif` 或 `svg` 时仅支持 `opaque` enum: - opaque - transparent default: opaque example: opaque output_format: type: string description: >- 输出文件格式，默认 `png` - `png`：无损，支持透明背景 - `jpeg`：有损压缩，文件体积更小 - `webp`：体积与质量兼顾，同样支持透明背景 - `gif`：GIF 动图，帧数与帧间隔见 `model_params` - `svg`：SVG 矢量图，适合 Logo、图标等需要无损缩放的图形 **注意：** - `background` 为 `transparent` 时只能使用 `png` 或 `webp` - `gif` 支持文生图和图像编辑 - `gif`、`svg` 输出时 `n` 只能为 `1` - `svg` 仅支持文生图 - SVG 由模型先生成一张参考图，再由作者模型（`model_params.svg_model`）转写为矢量图，作者模型消耗的 token 按所选模型单独计费 enum: - png - jpeg - webp - gif - svg default: png example: png 'n': type: integer description: >- 生成图片数量，每张独立计费 **注意：** - 文本输入 token 会随 `n` 等比放大 - 当前对 `n > 1` 的支持并不稳定：即使传入大于 1 的值，也很可能只返回 1 张图。实际张数以响应中的 `results` 为准，计费按返回的 `usage` 结算。需要多张时，建议改为发起多次单张请求 - `output_format` 为 `gif` 或 `svg` 时只能为 `1` minimum: 1 maximum: 10 default: 1 example: 1 model_params: type: object description: |- 模型扩展参数。GIF 帧参数与 SVG 作者参数必须放在此对象中。 - `frame_count`、`frame_duration_ms` 仅可用于 `output_format=gif` - `svg_model`、`svg_reasoning_effort` 仅可用于 `output_format=svg` - 输出格式与扩展参数不匹配时，返回 HTTP 400；不会静默忽略 properties: frame_count: type: integer description: >- GIF 动图的帧数，仅在 `output_format` 为 `gif` 时可用，默认 `9`。 所有帧会合成为一张大图生成。显式帧尺寸的宽、高均须为 `16` 的正整数倍；单帧不受普通图片的最小像素限制。下表边长均以像素为单位。 | 帧数 | 每帧限制 | 尺寸示例 | |---|---|---| | `2`~`8` | ≤ 1,036,800 像素；一边 ≤ 960，另一边 ≤ 1920 | `960x1072` | | `9` | ≤ 921,600 像素；两边均 ≤ 1280 | `1280x720` | | `10`~`12` | ≤ 691,200 像素；一边 ≤ 1280，另一边 ≤ 960 | `960x720` | | `13`~`16` | ≤ 518,400 像素；两边均 ≤ 960 | `720x720` | **拼图规则（列 × 行）：** - `2`~`8` 帧：`4×2` 或 `2×4` - `9` 帧：`3×3` - `10`~`12` 帧：`3×4` 或 `4×3`，必要时尝试 `4×4` - `13`~`16` 帧：`4×4` **还需同时满足：** - 至少一种拼法能使整张图的每条边 ≤ `3840` px、总像素 ≤ `8,294,400`、长宽比 ≤ `3:1` - 选择 `4×4` 拼法时，每帧须满足 `13`~`16` 帧对应的面积与边长上限 - 任一可用拼法都无法容纳时，返回 HTTP 400；上表的面积与边长上限不是唯一约束 `size` 为 `auto` 时每帧为 `512×512`，所有帧数均可用。输出 token 按合成后的整张图计算，不按单帧分别累加。 minimum: 2 maximum: 16 default: 9 example: 9 frame_duration_ms: type: integer description: >- GIF 每帧的停留时间（毫秒），仅在 `output_format` 为 `gif` 时可用，默认 `200`，按 10 毫秒取整 minimum: 20 maximum: 2000 default: 200 example: 200 svg_model: type: string description: >- SVG 作者模型，负责把参考图转写为 SVG，仅在 `output_format` 为 `svg` 时可用，默认 `gpt-6.1-terra` **注意：** - 作者模型消耗的 token 按所选模型单独计费 - 任务结果的 `usage` 中会返回 `svg_model`、`svg_input_tokens`、`svg_output_tokens` - 作者模型的输入与输出 token 单独列出，不包含在 `usage.total_tokens` 中 enum: - gpt-6.1-terra - gpt-6.1-sol - gpt-6-astra - gpt-6-sol - gpt-6-luna default: gpt-6.1-terra example: gpt-6.1-terra svg_reasoning_effort: type: string description: >- SVG 作者模型的推理强度，仅在 `output_format` 为 `svg` 时可用，不传时使用作者模型的默认档位 `medium` | 作者模型 | 可选值 | |---|---| | `gpt-6.1-terra`、`gpt-6-sol`、`gpt-6-luna` | `none`、`low`、`medium`、`high`、`xhigh`、`max` | | `gpt-6.1-sol`、`gpt-6-astra` | `low`、`medium`、`high`、`xhigh`、`max` | **注意：** - 推理 token 计入作者模型的输出 token enum: - none - low - medium - high - xhigh - max example: medium callback_url: type: string description: |- 任务完成后的HTTPS回调地址 **回调时机：** - 任务完成（completed）、失败（failed）或取消（cancelled）时触发 - 在计费确认完成后发送 **安全限制：** - 仅支持HTTPS协议 - 禁止回调到内网IP地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x等） - URL长度不超过`2048`字符 **回调机制：** - 超时时间：`10`秒 - 失败后最多重试`3`次（会分别在失败的`1`秒/`2`秒/`4`秒后进行重试） - 回调响应体格式与任务查询接口返回的格式一致 - 回调地址若返回2xx状态码视为成功，其他状态码会触发重试 format: uri example: https://your-domain.com/webhooks/image-task-completed ImageGenerationResponse: type: object properties: created: type: integer description: 任务创建时间戳 example: 1757156493 id: type: string description: 任务ID example: task-unified-1757156493-imcg5zqt model: type: string description: 实际使用的模型名称 example: gpt-image-2.6-sunburst object: type: string enum: - image.generation.task description: 任务的具体类型 progress: type: integer description: 任务进度百分比 (0-100) minimum: 0 maximum: 100 example: 1 status: type: string description: 任务状态。排队及生成中统一返回 `processing`，最终状态为 `completed` 或 `failed`。 enum: - processing - completed - failed example: processing task_info: $ref: '#/components/schemas/TaskInfo' description: 异步任务信息 type: type: string enum: - text - image - audio - video description: 任务的输出类型 example: image usage: $ref: '#/components/schemas/Usage' description: 使用量和计费信息 ErrorResponse: type: object properties: error: type: object properties: code: type: string description: 错误代码标识符 message: type: string description: 错误描述信息 type: type: string description: 错误类型 TaskInfo: type: object properties: can_cancel: type: boolean description: 任务是否可以取消 example: true estimated_time: type: integer description: 预估完成时间（秒） minimum: 0 example: 100 Usage: type: object description: 任务创建时的预扣信息；实际消耗及 token 明细请在任务完成后通过任务查询接口获取。 properties: billing_rule: type: string description: 计费规则。GPT Image 2.6 按每 1,000 token 计费，图片、文本输入和 SVG 作者模型用量按对应单价分别结算。 enum: - per_1k_tokens example: per_1k_tokens credits_reserved: type: number description: 预估消耗积分数 minimum: 0 example: 2.5 user_group: type: string description: 用户组类别 example: default securitySchemes: bearerAuth: type: http scheme: bearer description: |- 所有接口均需要使用 Bearer Token 进行认证。 **获取 API Key ：** 访问 [API Key 管理页面](https://evolink.ai/dashboard/keys) 获取您的 API Key **使用时在请求头中添加：** ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.