Skip to content

文本转图像

1. 图像生成

POST /generate

生成图像的主要端点。

请求体

json
{
  "prompt": "图像生成的文本提示词",
  "negative_prompt": "不希望在图像中出现的内容描述(可选)",
  "height": 768,
  "width": 1024,
  "num_images_per_prompt": 1
}

参数说明

  • prompt(必填):图像生成的文本提示词

  • negative_prompt(可选):负面提示词,指导模型避免生成的内容,默认为空字符串

  • height(可选):图像高度,范围 128-2048,默认为 768

  • width(可选):图像宽度,范围 128-2048,默认为 1024

  • num_images_per_prompt(可选):每个提示词生成的图像数量,范围 1-10,默认为 1

响应 (200)

json
{
  "task_id": "任务ID",
  "status": "任务状态"
}

2. 获取任务状态

GET /task/{task_id}

查询特定任务的状态。

路径参数

  • task_id(必填):任务 ID

查询参数

  • return_base64(可选):是否在响应中包含 base64 编码的图像,默认为 false

响应 (200)

json
{
  "task_id": "任务ID",
  "status": "任务状态",
  "images_base64": ["base64编码的图像数组(如果return_base64为true)"],
  "error": "错误信息(如果有)"
}

3. 获取生成的图像

GET /image/{task_id}/{image_index}

获取特定任务生成的特定索引的图像。

路径参数

  • task_id(必填):任务 ID

  • image_index(必填):图像索引

响应 (200)

图像数据