跳转到主要内容
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1.5-official",
    "prompt": "星空下的古老城堡，电影感光影，超写实风格",
    "size": "16:9",
    "resolution": "2k",
    "quality": "high",
    "n": 1
  }'

{
  "id": "tsk_img_01KPTXXXXXXXXXXXXXXX",
  "object": "generation.task",
  "model": "gpt-image-1.5-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.toapis.com/llms.txt

Use this file to discover all available pages before exploring further.

  • OpenAI 官方 gpt-image-2 模型，通过 gpt-image-1.5-official 模型名调用
  • 异步处理模式，返回任务 ID 用于后续查询
  • 支持文生图、多参考图图生图、遮罩局部重绘（inpainting）
  • 支持 13 种宽高比，可选 1K / 2K / 4K 三档分辨率
  • 单次最多生成 4 张图，参考图最多 16 张
注意：gpt-image-1.5-official 不支持透明背景，传入 background: "transparent" 会被静默降级为 auto。

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
默认值:"gpt-image-1.5-official"
必填
图像生成模型名称固定填写 gpt-image-1.5-official
​
prompt
string
必填
图像生成的文本描述支持中英文，建议详细描述场景、风格和构图
​
size
string
默认值:"1:1"
画面宽高比支持以下比例，也可传 auto 由服务端根据 prompt 自动选择：1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 2:1 · 1:2 · 21:9 · 9:21
4K 档仅支持 6 个比例：16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21，其余比例请使用 2K。
​
resolution
string
默认值:"1k"
分辨率档位
  • 1k — 1024 基准，速度快，日常够用（默认）
  • 2k — 2048 基准，适合海报 / 高清需求
  • 4k — 3840 基准，仅支持上述 6 个比例，high 质量下耗时可达 130s

​
尺寸对照表

size1K2K4K
1:11024x10242048x2048不支持
3:21536x10242048x1360不支持
2:31024x15361360x2048不支持
4:31024x7682048x1536不支持
3:4768x10241536x2048不支持
5:41280x10242560x2048不支持
4:51024x12802048x2560不支持
16:91536x8642048x11523840x2160
9:16864x15361152x20482160x3840
2:12048x10242688x13443840x1920
1:21024x20481344x26881920x3840
21:92016x8642688x11523840x1648
9:21864x20161152x26881648x3840
​
quality
string
默认值:"high"
图片质量
  • low — 快速省钱，适合草稿/预览
  • medium — 平衡速度与质量
  • high — 最高精度，默认值（4K + high 耗时可达 120s+）
​
output_format
string
默认值:"png"
输出格式
  • png — 默认
  • jpeg — 文件更小（支持压缩）
Azure OpenAI 不支持 webp 格式。
​
output_compression
integer
默认值:100
JPEG 压缩强度，范围 0–100（0 不压缩，100 最大压缩，默认 100）仅对 output_format: "jpeg" 有效
​
n
integer
默认值:1
生成图片张数取值范围：1 ~ 10
​
image_urls
string[]
参考图 URL 数组，用于图生图
  • 最多 16 张，须为公网可访问的稳定 URL
  • 可先使用 上传图片接口 获取 URL
​
mask_url
string
遮罩图 URL，用于局部重绘（inpainting）需搭配 image_urls 使用，遮罩图尺寸须与首张参考图一致，且需包含 Alpha 通道（透明区域为待重绘区域）

​
Response

​
id
string
任务唯一标识符，用于查询任务状态
​
object
string
对象类型，固定为 generation.task
​
model
string
使用的模型名称
​
status
string
任务状态
  • queued — 排队等待处理
  • in_progress — 处理中
  • completed — 成功完成
  • failed — 失败
​
progress
integer
任务进度百分比（0-100）
​
created_at
integer
任务创建时间戳（Unix 时间戳）
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1.5-official",
    "prompt": "星空下的古老城堡，电影感光影，超写实风格",
    "size": "16:9",
    "resolution": "2k",
    "quality": "high",
    "n": 1
  }'

{
  "id": "tsk_img_01KPTXXXXXXXXXXXXXXX",
  "object": "generation.task",
  "model": "gpt-image-1.5-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}