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

文生图

POST
/v1/images/generations
最后修改时间：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。
下面的请求使用 gpt-image-2、1024x1024、n=1。响应中的 data[0].url 是结果图片地址。

cURL（Bash）#

请求参数

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/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-image-2",
    "prompt": "A serene koi pond at sunset, ukiyo-e style.",
    "size": "1024x1024",
    "n": 1
}'
响应示例响应示例
200 - 成功示例
{
    "created": 1791115198,
    "data": [
        {
            "url": "https://example.com/generated-image.png"
        }
    ]
}
修改于 2026-10-04 13:51:37
下一页
图生图 / 多图参考（1–16 张）
Built with