1. 图片接口
极点API
极点 API · 图片生成与编辑
  • 极点 API · 图片生成与编辑
  • 图片接口
    • 文生图
      POST
    • 图生图 / 多图参考（1–16 张）
      POST
  • 数据模型
    • ImageGenerationRequest
    • ImageReference
    • ImageEditJsonRequest
    • ImageEditMultipartRequest
    • ImageResponse
  1. 图片接口

图生图 / 多图参考（1–16 张）

POST
/v1/images/edits
最后修改时间：2026-10-04 13:51:37

分辨率与宽高比#

用 size 同时指定分辨率和比例，格式为 宽x高，单位是像素，中间使用小写英文字母 x。
例如 2048x1152 是 16:9 横图，864x1536 是 9:16 竖图。
请求中无需单独添加 aspect_ratio、resolution、width 或 height；不要把 16:9、2K、4K 当作 size 的值。
比例size用途极点线路验证
1:11024x1024基础方图已实测
3:21536x1024横图1536x1024 / PNG
2:31024x1536竖图1024x1536 / PNG
16:91536x864宽屏符合官方尺寸规则；未单独实测
9:16864x1536竖屏864x1536 / PNG
4:31536x1152横图符合官方尺寸规则；未单独实测
3:41152x1536竖图符合官方尺寸规则；未单独实测
1:12048x20482K 方图符合官方尺寸规则；未单独实测
16:92048x11522K 宽屏2048x1152 / PNG
9:161152x20482K 竖屏符合官方尺寸规则；未单独实测
16:93840x21604K 宽屏3840x2160 / PNG
9:162160x38404K 竖屏符合官方尺寸规则；未单独实测
size: "auto" 属于标准协议选项，由服务决定尺寸；需要固定尺寸交付时请明确填写像素宽高。

自定义尺寸规则#

OpenAI 官方 gpt-image-2 的尺寸规则为：宽和高都应为 16 的倍数；最长边不超过 3840；长边与短边之比不超过 3:1；总像素数在 655360–8294400 之间。
表格中标为“符合官方尺寸规则”的值尚未逐项在线路实测，首次接入优先使用已实测的值。
例如 1920x1080 的高度不是 16 的倍数，16:9 可使用 1536x864 或 2048x1152。
尺寸由参数决定；在 prompt 中写“竖屏”“4K”不能替代 size。
参考图原始比例与输出比例可以不同，裁切、扩图和构图要求请写入 prompt。
来源：OpenAI gpt-image-2 尺寸规则。

其他参数与当前线路行为#

HTTP 200 表示请求完成；不能据此认定每个可选参数都按指定值执行。以下列出标准协议字段及当前线路观察结果。
参数标准值 / 写法使用建议
n标准范围 1–10；实测 1、2与参考图数量无关。2 已返回两张图片；更多张数未逐项实测。
qualitylow、medium、high、auto当前线路尚不能保证切换档位；建议省略。
output_formatpng、jpeg、webp默认示例使用 PNG；其他格式见下方实测记录。
output_compression0–100 的整数标准协议仅用于 JPEG / WebP，不控制 PNG；当前线路效果未保证。
background标准协议有 auto、opaque、transparent当前线路透明背景请求已被拒绝；推荐省略或 auto。
input_fidelitygpt-image-2 不需要设置按官方说明，此模型自动按高保真处理输入，省略该参数。

实测观察（2026-10-04）#

quality=high：图生图请求成功，但响应 quality 为 medium，因此不承诺 high 档位生效。
size=auto + quality=auto + WebP + 压缩参数：返回 1 张；响应 size=2048x2048、quality=medium、output_format=webp、background=auto；下载图片核对为 2048x2048 / PNG。
n=2：返回 2 张；响应 size=1024x1024、quality=medium、output_format=png、background=auto；下载图片核对为 1024x1024 / PNG, 1024x1024 / PNG。
background=transparent：HTTP 400，服务端明确返回 Transparent background is not supported for this model.。当前线路不支持透明背景。
JPEG + output_compression=80：返回 1 张；响应 size=1024x1024、quality=medium、output_format=jpeg、background=auto；下载图片核对为 1024x1024 / PNG。
JPEG / WebP 请求虽然在响应字段中分别写回 jpeg / webp，下载文件实测均为 PNG。请以真实文件编码判断格式；现阶段优先使用 PNG。
response_format 与 output_format 不是同一件事：前者涉及 URL / Base64 的返回方式，后者涉及 PNG / JPEG / WebP 文件编码。本线路当前接入方式为读取 data[].url；示例不设置 response_format。
mask、stream、partial_images 等高级功能不在本版验证范围。
官方枚举参考：OpenAI 图片编辑参数。
编辑现有图片，或使用多张参考图片生成新图。

JSON：URL / Base64 / 多图#

Content-Type 为 application/json，使用 images 数组，每张图为 {"image_url": "..."}。
单图公网 URL 已验证；16 张不同图片使用 Base64 data URL 已验证。
请求示例中的 example.com 是占位地址，需替换为自己的图片直链；双图 Base64 示例内置两张测试卡，可直接调试。
参考图数量由 images 数组长度决定，n=1 表示只生成一张结果。
若使用 16 张参考图，在同一个 images 数组中放入 16 个对象即可，无需更改请求路径。

文件上传#

Content-Type 为 multipart/form-data。多文件使用重复的 image[] 文件字段；单文件兼容 image。
不要同时传 image 和 image[]。让 HTTP 客户端自动生成包含 boundary 的 Content-Type。
在 Apifox 中调试文件上传时，切换 Body 为 form-data，按下方 cURL 添加文件字段。

cURL：JSON（Bash）#

将 JSON 请求体保存为 edit-request.json，再运行：

cURL：双文件上传（Bash）#

PowerShell：JSON#

curl.exe --max-time 300 'https://jidian.ai668.cc/v1/images/edits' `
  -H "Authorization: Bearer $env:JIDIAN_API_KEY" `
  -H 'Content-Type: application/json' `
  --data-binary '@edit-request.json'

响应#

HTTP 200 返回 JSON，读取 data[0].url。下面的响应示例保留实测结构，用占位地址替换临时图片下载链接。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
or
Body 参数
application/json
必填

示例

返回响应

🟢200
application/json
编辑成功，读取 data[].url。
Bodyapplication/json

⚪default
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://jidian.ai668.cc/v1/images/edits' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-image-2",
    "prompt": "给图片中右侧的小狗添加一条红围巾，保留角色和场景。",
    "images": [
        {
            "image_url": "https://example.com/reference.png"
        }
    ],
    "size": "1024x1024",
    "n": 1
}'
响应示例响应示例
200 - 单图编辑响应（下载地址已替换）
{
    "background": "auto",
    "created": 1791118432,
    "data": [
        {
            "url": "https://example.com/generated-image.png"
        }
    ],
    "model": "gpt-image-2",
    "moderation": "auto",
    "output_format": "png",
    "quality": "medium",
    "size": "1024x1024",
    "usage": {
        "input_tokens": 352,
        "input_tokens_details": {
            "image_tokens": 300,
            "text_tokens": 52
        },
        "output_tokens": 1056,
        "output_tokens_details": {
            "image_tokens": 1056,
            "text_tokens": 0
        },
        "total_tokens": 1408
    }
}
修改于 2026-10-04 13:51:37
上一页
文生图
下一页
ImageGenerationRequest
Built with