图像生成

Seedream、Gemini、GPT-Image-2 等多模型图片生成

支持多种模型：Seedream（中文轻量绘图）、Gemini Flash/Pro、GPT-Image-2。

Seedream 生图

中文理解最好，适合国风/二次元/日常出图。

请求：

POST /v2/extend/image/seedream/generations

参数：

参数	类型	必填	说明
prompt	string	是	图片描述
size	string	否	尺寸，最小 1920x1920（需 ≥ 368万像素）
image	array	否	参考图片（URL 或 base64）

示例：

curl https://tokenhub.piegateway.me/v2/extend/image/seedream/generations \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只在月球上弹吉他的猫",
    "size": "2048x2048"
  }'

返回：

{ "task_id": "img_gen_xxx", "model": "novita_seedream/seedream-5.0-lite" }

Gemini 生图

风格多变，支持 Flash（快速）和 Pro（高品质）。

请求：

POST /v2/extend/image/generations

参数：

参数	类型	必填	说明
model	string	否	模型名，默认 gemini-3.1-flash-image，可选 gemini-3-pro-image
prompt	string	是	图片描述
size	string	否	可选值：0.5K、1K、2K、4K
aspect_ratio	string	否	宽高比，如 1:1、3:2、2:3、3:4、4:3、16:9、9:16
output_format	string	否	输出格式：image/png、image/jpeg、image/webp

示例：

curl https://tokenhub.piegateway.me/v2/extend/image/generations \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "prompt": "a cat playing guitar on the moon",
    "size": "2K"
  }'

GPT-Image-2 生图

OpenAI 生图模型，文字渲染效果好。

请求：

POST /v2/extend/image/gpt_image/generations

参数：

参数	类型	必填	说明
prompt	string	是	图片描述
size	string	否	如 1024x1024、1024x1536 等
quality	string	否	质量档位：low / medium / high
n	number	否	生成数量（默认 1）
background	string	否	背景：opaque / transparent
output_format	string	否	输出格式：png / jpeg / webp
output_compression	number	否	压缩率（0-100）

示例：

curl https://tokenhub.piegateway.me/v2/extend/image/gpt_image/generations \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a futuristic city at sunset",
    "size": "1024x1024",
    "quality": "medium"
  }'

查询图片生成结果

所有图片生成接口都是异步的，返回 task_id 后需要轮询获取结果。

请求：

GET /v2/extend/image/tasks/{task_id}
GET /v2/extend/image/seedream/tasks/{task_id}
GET /v2/extend/image/gpt_image/tasks/{task_id}

示例：

curl https://tokenhub.piegateway.me/v2/extend/image/seedream/tasks/<task_id> \
  -H "X-API-Key: <your-api-key>"

返回示例：

{
  "task_id": "img_gen_xxx",
  "status": "succeeded",
  "model": "novita_seedream/seedream-5.0-lite",
  "result": {
    "images": [{ "url": "https://..." }]
  }
}

状态值：pending → processing → succeeded 或 failed