GPT88 Agent Docs
ImageOpenAI7 家上游

gpt-image-2

OpenAI gpt-image-2 · IMAGE 模型

在 gpt88.cc 获取 API Key快速开始

模型概览

  • 这是一个图像生成模型，适合把文本提示词转成静态图片或视觉素材。
  • 它属于 OpenAI 路线，通常更适合直接接入现有 OpenAI SDK、工具调用和结构化输出工作流。

适用场景

  • 需要把文案或提示词转换成图片素材时
  • 做海报、电商主图、品牌概念图或社媒配图时
  • 先用一条最小 prompt 验证输出风格，再扩展到批量生成时

接入说明

  • 图片与视频模型统一使用图片与多媒体 Base URL https://img.gpt88.cc。
  • 第一次接入时，建议先用 /v1/images/generations 验证 API Key、模型名 gpt-image-2 和当前线路是否匹配。
  • 媒体类模型通常先验证上传 / 返回结构，再扩展到正式的素材或媒体管线。

使用提醒

  • 价格、限速、SLA、上下文长度、是否开放多模态等动态值以 gpt88.cc 控制台为准。
  • 如果请求延迟偏高或连接不稳定，请先检查 API Key、模型、endpoint 和请求格式。

能力标签

该模型的能力标签以 gpt88.cc 控制台为准。本页只展示协议字段与请求示例，具体能力 / 推荐场景 / 上下文长度等信息会随上游版本变更，请在 gpt88.cc 控制台 查看实时清单。

推荐场景

该模型的推荐场景以 gpt88.cc 控制台为准。本页只展示协议字段与请求示例，具体能力 / 推荐场景 / 上下文长度等信息会随上游版本变更，请在 gpt88.cc 控制台 查看实时清单。

接口路径

POSThttps://img.gpt88.cc/v1/images/generations

该路径由模型分类决定：Chat / Image / Video / Audio 使用不同 endpoint，同一分类内通常只需要替换 model 字段。

请求需在 Header 中携带 Authorization: Bearer <API_KEY>。 完整字段说明见 图片生成 API 。

API 文档

Endpoint
POST /v1/images/generations
Model ID
gpt-image-2
Content-Type
application/json
接口类型
图像生成接口，支持文生图；部分模型支持图生图
Base URL
图片接口使用图片与多媒体 Base URL https://img.gpt88.cc。

Headers / 鉴权

  • Authorizationstring必填
    使用 Bearer <GPT88_API_KEY>。API Key 在 gpt88.cc 控制台创建。
  • Content-Typestring必填
    请求体格式。音频转写上传文件时使用 multipart/form-data。
    默认值：application/json
  • Acceptstring
    非流式接口返回 JSON；Chat 流式请求会返回 SSE 数据流。
    默认值：application/json

请求参数

以下字段按当前模型分类生成。价格、上下文长度、限速、可用线路等动态信息以 gpt88.cc 控制台为准。

  • modelstring必填
    当前模型 ID：gpt-image-2。复制时请保持大小写一致。
  • promptstring必填
    生成或编辑图片的文字指令。建议写清主体、风格、构图和不希望改变的内容。
  • imagefile | file[]
    图生图参考图文件。OpenAI 官方编辑接口使用上传文件，而不是图片 URL。
  • sizestring
    输出尺寸或画幅配置。不同图像模型支持范围不同，以控制台为准。
    默认值：1024x1024
  • resolutionstring
    输出清晰度，例如 1K。是否支持更高清晰度以控制台为准。
  • ninteger
    生成图片数量。批量生成时请关注账号限速与并发。
    默认值：1

响应字段

响应结构保持 OpenAI 兼容风格；媒体类模型可能返回异步任务 ID 或资源 URL。

  • createdinteger必填
    生成时间，Unix 秒。
  • dataarray<Image>必填
    生成结果数组，通常包含图片 url 或 b64_json。
  • usageobject
    部分模型会返回用量统计；是否返回以模型实际响应为准。

状态码

  • 200OK必填
    请求成功，响应体结构见上方响应字段。
  • 400Bad Request
    请求字段不合法，例如缺少必填字段、图片尺寸格式错误或文件格式不支持。
  • 401Unauthorized
    API Key 缺失、无效或格式错误。
  • 404Not Found
    Endpoint 或模型不存在。请确认路径为 /v1/images/generations，模型 ID 为 gpt-image-2。
  • 429Rate Limited
    触发限速、并发限制或余额不足。控制台会展示当前账号可用额度。
  • 5xxUpstream Error
    上游或请求异常。保持统一 Base URL 重试，并保留请求 ID 便于排查。

错误与排查

  • 401：检查 Authorization 是否为 Bearer <API_KEY>，以及 Key 是否仍有效。
  • 404：检查 endpoint 是否为 /v1/images/generations，以及模型名 gpt-image-2 是否在控制台可见。
  • 429：触发限速或余额不足时，降低并发、缩短请求，或到控制台查看额度。
  • 5xx：保持统一 Base URL 重试，并记录请求 ID 方便排障。

请求示例

文生图

只传 prompt，由模型直接生成一张新图片。

curl https://img.gpt88.cc/v1/images/generations \
  -H "Authorization: Bearer $GPT88_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "极简风格的 API 文档站封面",
    "size": "1024x1024",
    "n": 1
  }'

图生图

参考图生成

上传参考图文件，在保留主体或风格的基础上继续生成。

import requests

with open("reference.png", "rb") as f:
    resp = requests.post(
        "https://img.gpt88.cc/v1/images/edits",
        headers={
            "Authorization": "Bearer YOUR_GPT88_API_KEY",
        },
        files={
            "image": f,
        },
        data={
            "model": "gpt-image-2",
            "prompt": "保留参考图主体，改成极简 API 文档站封面风格",
            "size": "1536x1024",
            "quality": "high",
        },
    )
print(resp.json())

期望响应（精简示例）：

200 OKjson
{
  "created": 1730000000,
  "data": [
    { "url": "https://cdn.gpt88.cc/images/gpt-image-2-001.png" }
  ]
}