Skip to content
媒体

Images ​

图像生成与编辑,OpenAI Images 协议。仅 OpenAI 与 Grok 分组可用。

生成图像 ​

POST/v1/images/generations
modelstring必填

图像模型 ID,例如 gpt-image-1。

promptstring必填

图像描述。

sizestring

尺寸,例如 1024x1024、1536x1024。

ninteger

生成数量。

bash
curl https://api.thetaio.tech/v1/images/generations \
  -H "Authorization: Bearer $THETAIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-1", "prompt": "极简风格的山脉线稿", "size": "1024x1024"}'

响应中 data[] 包含 url 或 b64_json,取决于上游返回格式。

编辑图像 ​

POST/v1/images/edits

使用 multipart/form-data 上传原图(和可选遮罩),其余字段同生成接口。

bash
curl https://api.thetaio.tech/v1/images/edits \
  -H "Authorization: Bearer $THETAIO_API_KEY" \
  -F model=gpt-image-1 \
  -F image=@input.png \
  -F prompt="把背景换成白色"

异步任务 ​

生成耗时长时,使用异步端点避免连接超时:

方法路径
POST/v1/images/generations/async
POST/v1/images/edits/async
GET/v1/images/tasks/{task_id}

完整流程见异步图像任务。

批量任务 ​

Gemini 图像模型的批量生成,适合一次提交大量提示词。

方法路径说明
POST/v1/images/batches提交批量任务
GET/v1/images/batches列出批量任务
GET/v1/images/batches/models支持的模型
GET/v1/images/batches/{id}查询任务
GET/v1/images/batches/{id}/items查询各条目状态
GET/v1/images/batches/{id}/items/{custom_id}/content下载单条结果
GET/v1/images/batches/{id}/download打包下载 ZIP
POST/v1/images/batches/{id}/cancel取消任务
DELETE/v1/images/batches/{id}/outputs删除输出文件
DELETE/v1/images/batches/{id}删除任务记录
json
{
  "model": "gemini-2.5-flash-image",
  "items": [
    { "custom_id": "cover_001", "prompt": "干净的产品主图……", "output_count": 1 }
  ],
  "image_size": "1K",
  "response_mime_type": "image/png"
}
限制值
每条提示词的输出数 output_count1–4
每个任务的输出图片总数≤200
每条参考图数量Flash Image ≤3,Pro Image ≤14
参考图格式image/png、image/jpeg、image/webp
每个任务内联参考图总大小≤128MB

任务状态依次为 queued → running → processing_results → settling → completed,终态还包括 failed、cancelled、output_deleted。超出 200 张的工作量请拆成多个任务提交。