Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

GPT Image 2.5 同步图像生成

使用 gpt-image-2.5 调用同步图像生成接口。请求会保持 HTTP 连接，直到图片生成完成并返回结果。客户端超时建议设置为至少 300 秒。

请求示例

Request example
curl --request POST \
  --url https://tokenflash.cn/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.5",
    "prompt": "一只橘猫坐在窗台上看夕阳，水彩插画风格",
    "size": "1536x1024",
    "quality": "medium",
    "n": 1,
    "response_format": "url"
  }'

请求参数

header Authorizationstringrequired
Bearer Token，例如 Authorization: Bearer YOUR_API_KEY。你可以在 API Key 管理页面 创建密钥。
body modelstringrequireddefault: gpt-image-2.5
固定填写 gpt-image-2.5。
body promptstringrequired
图片内容描述。支持中文和英文。建议清晰描述主体、环境、构图和风格。
body sizestringdefault: 1024x1024
输出尺寸必须使用下方列出的支持值。
body qualitystringdefault: auto
图片质量。可选值为 auto、low、medium、high。
body nintegerdefault: 1
生成数量。
body response_formatstringdefault: url
返回格式。建议填写 url。

支持尺寸

size 仅支持以下尺寸：
档位支持的 size
标准1024x1024、1536x1024、1024x1536、1024x1365、1365x1024、1088x1920、1920x1088
高分辨率2048x2048、1712x2560、2560x1712、2048x1536、1152x2048、2048x1152、2880x2880、2560x3840、3840x2560、3840x2880、2160x3840、3840x2160

成功响应

Response example
{
  "created": 1789097054,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "revised_prompt": "一只橘猫坐在窗台上看夕阳，水彩插画风格"
    }
  ],
  "usage": {
    "input_tokens": 18,
    "output_tokens": 1056,
    "total_tokens": 1074
  }
}
从 data[0].url 读取生成图片。图片 URL 可能具有有效期，请及时下载并保存到自己的存储服务。

注意事项

  • 同步请求通常需要几十秒，客户端超时建议至少为 300 秒。
  • 图片尺寸必须使用本文列出的值。
  • 生产环境应检查 HTTP 状态码，并在图片生成完成后及时转存。
  • 不能保持长连接的业务请使用 GPT Image 2.5 异步图像生成。