章鱼哥AI接口文档

GPT Image

根据文字生成图片,支持尺寸控制与 URL、Base64 输出。

本系列支持的端点
  • 文生图POST https://zexapi.com/v1/images/generations
  • 图片编辑POST https://zexapi.com/v1/images/edits
  • Chat 兼容POST https://zexapi.com/v1/chat/completions
POSThttps://zexapi.com/v1/images/generations
鉴权 Authorization: Bearer YOUR_API_KEY

使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。

当前在架 GPT 图片全系列均支持同步与异步。基础型号的清晰度跟随型号;flare / sunburst 系列可用 size 选择 1K / 2K / 4K,VIP 型号可选质量。生成、编辑与 Chat 使用各自端点。
  • 返回的图片链接有时效,请及时下载或转存。

gpt-image 接口文档(OpenAI 原生格式)

接口地址

用途方法路径响应格式
文生图(图片 API)POST/v1/images/generations{ created, data: [{ url, b64_json }] }(缺省双给,可用 response_format 单选)
图生图(图片编辑)POST/v1/images/edits同上
文生图 / 图生图(Chat API)POST/v1/chat/completionschat.completion;图片在 message.content 的 markdown 里,Base64 在 message.images[0].b64_json
默认同步一次性 JSON。可选 "stream": true 走 SSE(应对 524),见下文「流式 SSE」。

功能说明

采用 OpenAI 原生端点格式的图片生成接口,支持文生图和图生图两种模式。
/v1/images/generations、/v1/images/edits:标准图片 API,缺省返回 { data: [{ url, b64_json }] }。
/v1/chat/completions:兼容 Chat Completions 调用方式;将 messages 自动转为内部提示词与参考图,响应为 Chat 格式(![image](链接)),Base64 走扩展字段。
三个端点的 response_format 语义完全一致:
传值返回内容
不传(推荐)同时返回 URL 与 Base64
"url"只返回图片 URL
"b64_json"只返回 Base64(纯字符串,不含 data: 前缀)
缺省双给时回包体积更大;若只需要链接,请显式传 "response_format": "url"。

支持的模型

当前在架 GPT 图片全系列均支持同步与异步。基础型号的清晰度跟随型号;flare / sunburst 系列可用 size 选择 1K / 2K / 4K,VIP 型号可选质量。生成、编辑与 Chat 使用各自端点。
model 参数分辨率质量说明
gpt-image-21K固定 medium同步与异步均支持;清晰度跟随型号,size 使用对应档位像素
gpt-image-2.51K固定 medium同步与异步均支持;清晰度跟随型号,size 使用对应档位像素
gpt-image-2-2K2K固定 medium同步与异步均支持;清晰度跟随型号,size 使用对应档位像素
gpt-image-2-4K4K固定 medium同步与异步均支持;清晰度跟随型号,size 使用对应档位像素
gpt-image-2.5-flare1K / 2K / 4K固定 medium用 size 选分辨率
gpt-image-2.5-sunburst1K / 2K / 4K固定 medium用 size 选分辨率
gpt-image-2.5-flare-vip1K / 2K / 4Klow / medium / high不传 quality 则自动判断
gpt-image-2.5-sunburst-vip1K / 2K / 4Klow / medium / high不传 quality 则自动判断
非 -vip 模型质量固定为 medium,可不传 quality。-vip 模型可在请求里传 quality:low、medium、high。

请求头

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY
Content-Typestring是图片 API:支持 application/json 与 multipart/form-data;Chat API:仅 application/json

一、文生图接口

接口地址

POST /v1/images/generations

请求参数

参数名类型必填说明
modelstring是模型名称,见上表
promptstring是图片描述,用于生成图片
sizestring否图片尺寸,格式 "宽x高"。同步接口用 size 选 1K / 2K / 4K,固定比例见下表
qualitystring否仅 -vip 模型:low、medium、high。不传则自动判断。其余模型质量固定为 medium,可不传
response_formatstring否不传 = URL + Base64 双给;"url" = 只要链接;"b64_json" = 只要 Base64

常用 size 速查

比例size(1K)size(2K)size(4K)
1:11024x10242048x20482880x2880
16:91280x7202560x14403840x2160
9:16720x12801440x25602160x3840
3:21248x8322496x16643504x2336
2:3832x12481664x24962336x3504
4:31152x8642304x17283264x2448
3:4864x11521728x23042448x3264
5:41120x8962240x17923200x2560
4:5896x11201792x22402560x3200
21:91456x6243024x12963696x1584

请求示例(JSON — 纯文生图,1K)

curl -X POST "https://xxxxxx.com/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "生成竖屏图片 xxx抖音带货",
    "size": "720x1280"
  }'

请求示例(JSON — 纯文生图,支持 2K/4K)

curl -X POST "https://xxxxxx.com/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "生成竖屏图片 xxx抖音带货",
    "size": "3696x1584"
  }'

四、响应示例(图片 API)

缺省(同时返回 URL 与 Base64)

{
  "created": 1782108238,
  "data": [
    {
      "url": "https://res.papir.cc/output/2026-04-18/xxxxxx.png",
      "b64_json": "iVBORw0KGgoAAAANSU..."
    }
  ]
}

只要 URL(请求体加 "response_format": "url")

{
  "created": 1782108238,
  "data": [
    {
      "url": "https://res.papir.cc/output/2026-04-18/xxxxxx.png"
    }
  ]
}

只要 Base64(请求体加 "response_format": "b64_json")

{
  "created": 1782108238,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSU..."
    }
  ]
}

图片 API 取参

需要取哪里
图片 URLdata[0].url
Base64data[0].b64_json(纯字符串,不含 data: 前缀)
请求示例(在原有请求体上增加字段即可):
{
  "model": "gpt-image-2.5-flare",
  "prompt": "一只可爱的猫",
  "size": "1024x1024",
  "response_format": "b64_json"
}

任务状态说明(异步上游时)

status说明
queued任务排队中
in_progress任务处理中
completed任务已完成
failed任务失败

五、流式 SSE(应对 524)

请求 JSON 加 "stream": true(布尔,不是字符串 "true") 后,网关立刻回 SSE,大约每 30 秒写一行 : keepalive 注释,出图后再给结果。
不传 stream 或 false:行为与上文完全一样,一次性 JSON。三个端点都支持流式:/v1/images/generations、/v1/images/edits、/v1/chat/completions。

响应头

HTTP/1.1 200 OK
Content-Type: text/event-stream; charset=utf-8
Cache-Control: no-cache, no-transform
Connection: keep-alive
X-Accel-Buffering: no
不能把整段 body 当一条 JSON 去 JSON.parse / resp.json()。必须按行读流:以 : 开头的是注释(可忽略),以 data: 开头的才是业务数据。

事件格式

类型原文说明
连接确认: connected立刻发送
心跳: keepalive约每 30 秒一条,标准 SSE comment,SDK 会忽略
结果data: {...}出图完成后的 JSON
结束data: [DONE]OpenAI 惯例,读到即可收尾
图片 API(/v1/images/generations、/edits)结果行:
: connected

: keepalive

data: {"type":"image_generation.completed","created_at":1788148391,"url":"https://cdn.example.com/out.png","b64_json":"iVBORw0KGgo..."}

data: [DONE]
response_format 语义不变:不传则 url 与 b64_json 都可能有;"url" 只有链接;"b64_json" 只有 Base64。
Chat API(/v1/chat/completions)结果行(object 为 chat.completion.chunk):
: connected

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

: keepalive

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"![image](https://cdn.example.com/out.png)\\n\\n","images":[{"type":"image_url","image_url":{"url":"https://cdn.example.com/out.png"},"b64_json":"iVBORw0KG..."}]},"finish_reason":null}]}

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]
取图:读带 delta.images 或 delta.content 的那条 data:。老客户端只看 markdown 的,用 delta.content 里的 ![image](url)。

怎么接

NewAPI(通道类型选 OpenAI / 自定义)
自己拼请求或 SDK 时,body 加 "stream": true 即可,NewAPI 会按 SSE 往下转。
NewAPI 控制台默认出图不带 stream,那种请求仍是一次性 JSON。要走 SSE 必须请求里带上这个字段。
Chat 控制台默认经常已是 stream: true,走 /v1/chat/completions 时更容易自动用上。
不要用通道「参数覆盖」给所有人强加 stream:期望一次性 JSON 的客户端会解析失败。
自建客户端
1.
按行读,跳过空行和 : 注释。
2.
data: [DONE] 结束;其它 data: 做 JSON.parse。
3.
curl 必须加 -N(关掉缓冲),否则要等全部结束才看得到心跳。
4.
前面若有 Nginx,需 proxy_buffering off;,否则心跳到不了客户端。

请求示例 — 图片 API 流式

curl -N -X POST "https://xxxxxx.com/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "生成竖屏图片 xxx抖音带货",
    "size": "720x1280",
    "stream": true
  }'

请求示例 — Chat 流式

curl -N -X POST "https://xxxxxx.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "stream": true,
    "messages": [
      { "role": "user", "content": "做一个广告" }
    ],
    "size": "720x1280"
  }'

Python 示例(图片 API 流式)

import json
import httpx

url = "https://xxxxxx.com/v1/images/generations"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "model": "gpt-image-2.5-flare",
    "prompt": "一只可爱的猫",
    "size": "1024x1024",
    "stream": True,  # 布尔,不要写成 "true"
}

result = None
with httpx.stream("POST", url, headers=headers, json=payload, timeout=600) as resp:
    resp.raise_for_status()
    for line in resp.iter_lines():
        if not line or line.startswith(":"):
            continue
        if not line.startswith("data: "):
            continue
        data = line[6:].strip()
        if data == "[DONE]":
            break
        obj = json.loads(data)
        if obj.get("type") == "image_generation.completed":
            result = obj

print(result and result.get("url"))

Python 示例(Chat 流式)

import json
import httpx

url = "https://xxxxxx.com/v1/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "model": "gpt-image-2.5-flare",
    "stream": True,
    "messages": [{"role": "user", "content": "做一个广告"}],
    "size": "720x1280",
}

url_out = None
with httpx.stream("POST", url, headers=headers, json=payload, timeout=600) as resp:
    resp.raise_for_status()
    for line in resp.iter_lines():
        if not line or line.startswith(":") or not line.startswith("data: "):
            continue
        data = line[6:].strip()
        if data == "[DONE]":
            break
        chunk = json.loads(data)
        delta = (chunk.get("choices") or [{}])[0].get("delta") or {}
        images = delta.get("images") or []
        if images and images[0].get("image_url"):
            url_out = images[0]["image_url"].get("url")
        # 也可从 delta["content"] 的 ![image](...) 里取

print(url_out)

注意事项

1.
接口格式:采用 OpenAI 原生端点,与常见 OpenAI SDK / 兼容客户端通用。
2.
524:碰到 524 时走 SSE,请求加 "stream": true(布尔),见上文「流式 SSE」。
3.
三种端点怎么选:
纯文生图、要标准 { data: [{ url, b64_json }] } → /v1/images/generations
带参考图的图生图 → /v1/images/edits
客户端已是 Chat / messages 形态 → /v1/chat/completions
4.
response_format(三个端点一致):
不传 = URL + Base64 双给
"url" = 只要图床链接
"b64_json" = 只要 Base64
Chat 端点只认字符串;传对象会被忽略,按缺省双给处理
5.
响应格式:
图片 API:读 data[0].url / data[0].b64_json;流式时读 image_generation.completed 那条 data:
Chat API:一次性读 message.content / message.images;流式读 delta.content / delta.images
6.
模型与分辨率:上表模型都支持 1K / 2K / 4K,用 size 选档。-vip 可传 quality(low / medium / high),不传则自动判断;其余模型质量固定为 medium。
7.
尺寸:同步接口用 size 控制画幅,固定比例见上文对照表,1K、2K、4K 三列都可用。
8.
参考图(图生图):
/v1/images/edits:JSON 下用字段 image(URL / Base64 / 数组);multipart 上传文件
/v1/chat/completions:在 messages[].content 里用 image_url
参考图 URL 须公网可访问(上游服务器需能下载);防盗链地址可能报 Failed to fetch image_url
9.
参考图格式:支持 JPEG、PNG、WEBP 等常见图片格式
10.
图片有效期:返回 URL 通常有时效(如约 2 小时),请及时保存
11.
回包体积:缺省双给时 Base64 会显著增大响应体;只需要链接时请传 "response_format": "url"

图片上传说明

同步文生图使用 application/json。图生图支持 JSON 和 multipart/form-data;表单图片字段统一为 input_reference,多张图片重复提交同名字段,也不使用 image 或 images。