# 图片生成

## 1. 概述

通过本接口创建文生图/图生图任务，获得任务`id`字段后，在[查询结果](https://docs.console.zenlayer.com/api/cn/compute/aig/image-generation/flux/flux-get-result)接口中通过携带`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。详见[概述](#1-概述)列出的可用版本，如 `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. 其它各模型详细定制参数可参照 [官方文档](https://api.bfl.ml/scalar#tag/tasks/POST/v1/flux-pro)

***

## 4. 请求示例

{% tabs %}
{% tab title="HTTP" %}

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

{% endtab %}

{% tab title="Shell" %}

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

{% endtab %}
{% endtabs %}

## 5. 响应示例

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