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_count | 1–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 张的工作量请拆成多个任务提交。