图片生成¶

1. 概述¶

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

说明：

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

2. 请求说明¶

请求方法:POST

请求地址:

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

说明：

$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`

说明：

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

4. 请求示例¶

HTTPShell

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.serevixai.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.serevixai.ai/flux/v1/get_result?id=1981b99c-a825-4d19-adc6-7dda6118c4ea"
}