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.请求示例 

  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
}
  
  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"
}