图片生成

1. 概述

通过本接口创建文生图/图生图任务，获得任务id字段后，在查询结果接口中通过携带id参数使用。

模型列表：

• flux-dev

• flux-pro

• flux-pro-1.1

• flux-pro-1.1-ultra

• flux-kontext-pro

• flux-kontext-max

• flux-pro-1.0-fill

• flux-pro-1.0-canny

• flux-pro-1.0-depth

说明：

1. 该系列模型对中文支持不太友好，使用自然语言描述时尽量使用英文

2. 请求说明

• 请求方法:POST

• 请求地址:

  https://gateway.theturbo.ai/flux/v1/$model

说明：

1. $model为要使用的模型 ID。详见概述列出的可用版本，如 flux-pro-1.1

---

3. 请求参数

3.1 Header 参数

参数名称	类型	必填	说明	示例值
Content-Type	string	是	设置请求头类型，必须为 application/json	application/json
Accept	string	否	设置响应类型，建议统一为 application/json	application/json
Authorization	string	是	身份验证所需的 API_KEY，格式 Bearer $YOUR_API_KEY	Bearer $YOUR_API_KEY

---

3.2 Body 参数 (application/json)

参数名称	类型	必填	说明	示例
prompt	string	是	图像生成的文本提示。	draw a rainbow
image_prompt	string	否	可选的 Base64 编码图像，用于与 Flux Redux 搭配使用。
width	number	否	生成图像的宽度（以像素为单位），必须是 32 的倍数。	1024
height	number	否	生成图像的高度（以像素为单位），必须是 32 的倍数。	768
prompt_upsampling	boolean	否	是否对提示词进行上采样。如果启用，将自动修改提示词，以实现更具创造性的生成效果。	false
seed	number	否	可选的种子值，用于重现某一随机结果。	42
output_format	string	否	生成图像的输出格式，可以是jpeg或png。	jpeg

说明：

1. 其它各模型详细定制参数可参照 官方文档

---

4. 请求示例

HTTP

POST /flux/v1/flux-pro-1.1
Content-Type: application/json
Accept: application/json
Authorization: Bearer $YOUR_API_KEY

{
	"prompt": "draw a rainbow",
	"width": 1024,
	"height": 768
}

Shell

curl https://gateway.theturbo.ai/flux/v1/flux-pro-1.1 \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "Authorization: Bearer $YOUR_API_KEY" \
	-d "{
	\"prompt\": \"draw a rainbow\",
	\"width\": 1024,
	\"height\": 768
}"

5. 响应示例

{
	"id": "1981b99c-a825-4d19-adc6-7dda6118c4ea",
	"polling_url": "https://gateway.theturbo.ai/flux/v1/get_result?id=1981b99c-a825-4d19-adc6-7dda6118c4ea"
}