# 官方原格式

{% hint style="danger" %}
此文档已停止维护，最新文档地址：<https://docs.ttapi.io>
{% endhint %}

## Flux Kontext Max <a href="#page-title" id="page-title"></a>

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/bfl/v1/flux-kontext-max`

根据文本提示使用 Flux Kontext Max 模型生成 或者编辑图像。[官方文档地址](https://docs.bfl.ai/api-reference/tasks/edit-or-create-an-image-with-flux-kontext-max)

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="166">参数</th><th width="107">类型</th><th width="169">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>string</td><td>是</td><td>生成图像描述词<br>注意：Flux支持多语言理解能力，但实测英文最佳。</td></tr><tr><td><code>input_image</code></td><td>string</td><td>否</td><td>参考图像1<br>url 或 base64</td></tr><tr><td><code>input_image_2</code></td><td>string</td><td>否</td><td>参考图像2<br>url 或 base64</td></tr><tr><td><code>input_image_3</code></td><td>string</td><td>否</td><td>参考图像3<br>url 或 base64</td></tr><tr><td><code>input_image_4</code></td><td>string</td><td>否</td><td>参考图像4<br>url 或 base64</td></tr><tr><td><code>aspect_ratio</code></td><td>string</td><td>否</td><td>图像比例<br>图像的宽高比在 <code>21:9</code> 和 <code>9:21</code> 之间</td></tr><tr><td><code>seed</code></td><td>string</td><td>否</td><td>随机种子</td></tr><tr><td><code>output_format</code></td><td>string</td><td>否</td><td>输出格式 <code>png</code>  <code>jpeg</code>
<br>默认 <code>jpeg</code></td></tr><tr><td><code>prompt_upsampling</code></td><td>boolean</td><td>否</td><td>是否对提示采样<br><code>true</code> - 是   <code>false</code> - 否<br>默认 <code>false</code></td></tr><tr><td><code>safety_tolerance</code></td><td>integer</td><td>否</td><td>输入和输出调节的容差水平。在0到6之间，0表示最严格，6表示最宽松<br>默认：2</td></tr><tr><td><code>webhook_url</code></td><td>string</td><td>否</td><td>异步回调地址</td></tr></tbody></table>

{% hint style="info" %}
注意：Flux生成图像接口同步返回的并不是任务的最终结果，任务的最终返回结果需要使用webhook\_url参数接收异步通知，或者通过[Flux查询任务结果](#flux-huo-qu-tu-xiang-jie-guo)接口进行查询。
{% endhint %}

#### 返回示例

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

```json
{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "fac30d6c-d12b-465c-a580-8b1b3ae726e3"
    }
}
```

{% endtab %}
{% endtabs %}

## Flux Kontext Pro <a href="#page-title" id="page-title"></a>

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/bfl/v1/flux-kontext-pro`

根据文本提示使用 Flux Kontext Pro 模型生成 或者编辑图像。[官方文档地址](https://docs.bfl.ai/api-reference/tasks/edit-or-create-an-image-with-flux-kontext-pro)

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="166">参数</th><th width="107">类型</th><th width="169">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>string</td><td>是</td><td>生成图像描述词<br>注意：Flux支持多语言理解能力，但实测英文最佳。</td></tr><tr><td><code>input_image</code></td><td>string</td><td>否</td><td>参考图像1<br>url 或 base64</td></tr><tr><td><code>input_image_2</code></td><td>string</td><td>否</td><td>参考图像2<br>url 或 base64</td></tr><tr><td><code>input_image_3</code></td><td>string</td><td>否</td><td>参考图像3<br>url 或 base64</td></tr><tr><td><code>input_image_4</code></td><td>string</td><td>否</td><td>参考图像4<br>url 或 base64</td></tr><tr><td><code>aspect_ratio</code></td><td>string</td><td>否</td><td>图像比例<br>图像的宽高比在 <code>21:9</code> 和 <code>9:21</code> 之间</td></tr><tr><td><code>seed</code></td><td>string</td><td>否</td><td>随机种子</td></tr><tr><td><code>output_format</code></td><td>string</td><td>否</td><td>输出格式 <code>png</code>  <code>jpeg</code>
<br>默认 <code>jpeg</code></td></tr><tr><td><code>prompt_upsampling</code></td><td>boolean</td><td>否</td><td>是否对提示采样<br><code>true</code> - 是   <code>false</code> - 否<br>默认 <code>false</code></td></tr><tr><td><code>safety_tolerance</code></td><td>integer</td><td>否</td><td>输入和输出调节的容差水平。在0到6之间，0表示最严格，6表示最宽松<br>默认：2</td></tr><tr><td><code>webhook_url</code></td><td>string</td><td>否</td><td>异步回调地址</td></tr></tbody></table>

#### 返回示例

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

```json
{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "fac30d6c-d12b-465c-a580-8b1b3ae726e3"
    }
}
```

{% endtab %}
{% endtabs %}

## Flux Pro 1.1 Ultra <a href="#page-title" id="page-title"></a>

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/bfl/v1/flux-pro-1.1-ultra`

根据文本提示使用 Flux Pro 1.1 Ultra 模型生成 或者编辑图像。[官方文档地址](https://docs.bfl.ai/api-reference/tasks/generate-an-image-with-flux-11-\[pro]-with-ultra-mode-and-optional-raw-mode)

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="166">参数</th><th width="107">类型</th><th width="169">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>string</td><td>是</td><td>生成图像描述词<br>注意：Flux支持多语言理解能力，但实测英文最佳。</td></tr><tr><td><code>aspect_ratio</code></td><td>string</td><td>否</td><td>图像比例<br>图像的宽高比在 <code>21:9</code> 和 <code>9:21</code> 之间</td></tr><tr><td><code>image_prompt</code></td><td>string</td><td>否</td><td>参考图像，base64值</td></tr><tr><td><code>image_prompt_strength</code></td><td>number</td><td>否</td><td><p>prompt提示与 参考图 之间的混合</p><p>所需范围：0 - 1<br>默认：<code>0.1</code></p></td></tr><tr><td><code>raw</code></td><td>string</td><td>否</td><td>生成处理程度更低、更自然的图像<br>默认 <code>false</code></td></tr><tr><td><code>seed</code></td><td>string</td><td>否</td><td>随机种子</td></tr><tr><td><code>output_format</code></td><td>string</td><td>否</td><td>输出格式 <code>png</code>  <code>jpeg</code>
<br>默认 <code>jpeg</code></td></tr><tr><td><code>prompt_upsampling</code></td><td>boolean</td><td>否</td><td>是否对提示采样<br><code>true</code> - 是   <code>false</code> - 否<br>默认 <code>false</code></td></tr><tr><td><code>safety_tolerance</code></td><td>integer</td><td>否</td><td>输入和输出调节的容差水平。在0到6之间，0表示最严格，6表示最宽松<br>默认： 2</td></tr><tr><td><code>webhook_url</code></td><td>string</td><td>否</td><td>异步回调地址</td></tr></tbody></table>

#### 返回示例

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

```json
{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "fac30d6c-d12b-465c-a580-8b1b3ae726e3"
    }
}
```

{% endtab %}
{% endtabs %}

## Flux Pro 1.1 <a href="#page-title" id="page-title"></a>

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/bfl/v1/flux-pro-1.1`

根据文本提示使用 Flux Pro 1.1 模型生成 或者编辑图像。[官方文档地址](https://docs.bfl.ai/api-reference/tasks/generate-an-image-with-flux-11-\[pro])

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="166">参数</th><th width="107">类型</th><th width="169">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>string</td><td>是</td><td>生成图像描述词<br>注意：Flux支持多语言理解能力，但实测英文最佳。</td></tr><tr><td><code>image_prompt</code></td><td>string</td><td>否</td><td>参考图像，base64值</td></tr><tr><td><code>width</code></td><td>integer</td><td>否</td><td>生成图像的宽度<br>范围256-1440，必须是32的倍数<br>默认：1024</td></tr><tr><td><code>height</code></td><td>integer</td><td>否</td><td>生成图像的高度<br>范围256-1440，必须是32的倍数<br>默认：768</td></tr><tr><td><code>seed</code></td><td>string</td><td>否</td><td>随机种子</td></tr><tr><td><code>output_format</code></td><td>string</td><td>否</td><td>输出格式 <code>png</code>  <code>jpeg</code>
<br>默认 <code>jpeg</code></td></tr><tr><td><code>prompt_upsampling</code></td><td>boolean</td><td>否</td><td>是否对提示采样<br><code>true</code> - 是   <code>false</code> - 否<br>默认 <code>false</code></td></tr><tr><td><code>safety_tolerance</code></td><td>integer</td><td>否</td><td>输入和输出调节的容差水平。在0到6之间，0表示最严格，6表示最宽松<br>默认：2</td></tr><tr><td><code>webhook_url</code></td><td>string</td><td>否</td><td>异步回调地址</td></tr></tbody></table>

#### 返回示例

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

```json
{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "fac30d6c-d12b-465c-a580-8b1b3ae726e3"
    }
}
```

{% endtab %}
{% endtabs %}

## Flux Pro <a href="#page-title" id="page-title"></a>

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/bfl/v1/flux-pro`

根据文本提示使用 Flux Pro 模型生成 或者编辑图像。[官方文档地址](https://docs.bfl.ai/api-reference/tasks/generate-an-image-with-flux1-\[pro])

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="166">参数</th><th width="107">类型</th><th width="169">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>string</td><td>是</td><td>生成图像描述词<br>注意：Flux支持多语言理解能力，但实测英文最佳。</td></tr><tr><td><code>image_prompt</code></td><td>string</td><td>否</td><td>参考图像，base64值</td></tr><tr><td><code>width</code></td><td>integer</td><td>否</td><td>生成图像的宽度<br>范围256-1440，必须是32的倍数<br>默认：1024</td></tr><tr><td><code>height</code></td><td>integer</td><td>否</td><td>生成图像的宽度<br>范围256-1440，必须是32的倍数<br>默认：768</td></tr><tr><td><code>seed</code></td><td>string</td><td>否</td><td>随机种子</td></tr><tr><td><code>output_format</code></td><td>string</td><td>否</td><td>输出格式 <code>png</code>  <code>jpeg</code>
<br>默认 <code>jpeg</code></td></tr><tr><td><code>prompt_upsampling</code></td><td>boolean</td><td>否</td><td>是否对提示采样<br><code>true</code> - 是   <code>false</code> - 否<br>默认 <code>false</code></td></tr><tr><td><code>safety_tolerance</code></td><td>integer</td><td>否</td><td>输入和输出调节的容差水平。在0到6之间，0表示最严格，6表示最宽松<br>默认：2</td></tr><tr><td><code>steps</code></td><td>integer</td><td>否</td><td>图像生成过程中的步骤数量<br>可选范围1-50<br>默认：40</td></tr><tr><td><code>guidance</code></td><td>number</td><td>否</td><td>图像生成的指导尺度。高指导尺度在牺牲现实感的情况下提高了提示遵循度<br>可选范围1.5-5<br>默认：2.5</td></tr><tr><td><code>interval</code></td><td>number</td><td>否</td><td>用于引导控制的区间参数<br>可选范围：1-4<br>默认：2</td></tr><tr><td><code>webhook_url</code></td><td>string</td><td>否</td><td>异步回调地址</td></tr></tbody></table>

#### 返回示例

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

```json
{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "fac30d6c-d12b-465c-a580-8b1b3ae726e3"
    }
}
```

{% endtab %}
{% endtabs %}

## Flux Dev <a href="#page-title" id="page-title"></a>

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/bfl/v1/flux-dev`

根据文本提示使用 Flux Dev 模型生成 或者编辑图像。官方文档地址

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="166">参数</th><th width="107">类型</th><th width="169">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>string</td><td>是</td><td>生成图像描述词<br>注意：Flux支持多语言理解能力，但实测英文最佳。</td></tr><tr><td><code>image_prompt</code></td><td>string</td><td>否</td><td>参考图像，base64值</td></tr><tr><td><code>width</code></td><td>integer</td><td>否</td><td>生成图像的宽度<br>范围256-1440，必须是32的倍数<br>默认：1024</td></tr><tr><td><code>height</code></td><td>integer</td><td>否</td><td>生成图像的宽度<br>范围256-1440，必须是32的倍数<br>默认：768</td></tr><tr><td><code>seed</code></td><td>string</td><td>否</td><td>随机种子</td></tr><tr><td><code>output_format</code></td><td>string</td><td>否</td><td>输出格式 <code>png</code>  <code>jpeg</code>
<br>默认 <code>jpeg</code></td></tr><tr><td><code>prompt_upsampling</code></td><td>boolean</td><td>否</td><td>是否对提示采样<br><code>true</code> - 是   <code>false</code> - 否<br>默认 <code>false</code></td></tr><tr><td><code>safety_tolerance</code></td><td>integer</td><td>否</td><td>输入和输出调节的容差水平。在0到6之间，0表示最严格，6表示最宽松<br>默认：2</td></tr><tr><td><code>steps</code></td><td>integer</td><td>否</td><td>图像生成过程中的步骤数量<br>可选范围1-50<br>默认：40</td></tr><tr><td><code>guidance</code></td><td>number</td><td>否</td><td>图像生成的指导尺度。高指导尺度在牺牲现实感的情况下提高了提示遵循度<br>可选范围1.5-5<br>默认：2.5</td></tr><tr><td><code>webhook_url</code></td><td>string</td><td>否</td><td>异步回调地址</td></tr></tbody></table>

#### 返回示例

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

```json
{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "fac30d6c-d12b-465c-a580-8b1b3ae726e3"
    }
}
```

{% endtab %}
{% endtabs %}

## Flux 2 Pro <a href="#page-title" id="page-title"></a>

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/bfl/v1/flux-2-pro`

根据文本提示使用 Flux 2 Pro 模型生成 或者编辑图像。[官方文档地址](https://docs.bfl.ai/flux_2/flux2_image_editing#flux-2-image-editing-parameters)

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="166">参数</th><th width="107">类型</th><th width="169">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>string</td><td>是</td><td>生成图像描述词<br>注意：Flux支持多语言理解能力，但实测英文最佳。</td></tr><tr><td>input_image</td><td>string</td><td>否</td><td>参考图像1<br>url 或 base64</td></tr><tr><td>input_image_2</td><td>string</td><td>否</td><td>参考图像2<br>url 或 base64</td></tr><tr><td>input_image_3</td><td>string</td><td>否</td><td>参考图像3<br>url 或 base64</td></tr><tr><td>input_image_4</td><td>string</td><td>否</td><td>参考图像4<br>url 或 base64</td></tr><tr><td>width</td><td>string</td><td>否</td><td>生成图像的宽度<br>范围256-1440，必须是32的倍数<br>默认：1024</td></tr><tr><td>height</td><td>string</td><td>否</td><td>生成图像的高度<br>范围256-1440，必须是32的倍数<br>默认：768</td></tr><tr><td>seed</td><td>string</td><td>否</td><td>种子</td></tr><tr><td>output_format</td><td>string</td><td>否</td><td>输出格式 <code>png</code>  <code>jpeg</code>
<br>默认 <code>jpeg</code></td></tr><tr><td>safety_tolerance</td><td>integer</td><td>否</td><td>输入和输出调节的容差水平。在0到6之间，0表示最严格，6表示最宽松<br>默认：2</td></tr><tr><td><code>webhook_url</code></td><td>string</td><td>否</td><td>异步回调地址</td></tr></tbody></table>

#### 返回示例

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

```json
{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "fac30d6c-d12b-465c-a580-8b1b3ae726e3"
    }
}
```

{% endtab %}
{% endtabs %}

## Flux 2 Flex <a href="#page-title" id="page-title"></a>

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/bfl/v1/flux-2-flex`

根据文本提示使用 Flux 2 Pro 模型生成 或者编辑图像。[官方文档地址](https://docs.bfl.ai/flux_2/flux2_image_editing#flux-2-image-editing-parameters)

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="166">参数</th><th width="107">类型</th><th width="169">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>string</td><td>是</td><td>生成图像描述词<br>注意：Flux支持多语言理解能力，但实测英文最佳。</td></tr><tr><td>input_image</td><td>string</td><td>否</td><td>参考图像1<br>url 或 base64</td></tr><tr><td>input_image_2</td><td>string</td><td>否</td><td>参考图像2<br>url 或 base64</td></tr><tr><td>input_image_3</td><td>string</td><td>否</td><td>参考图像3<br>url 或 base64</td></tr><tr><td>input_image_4</td><td>string</td><td>否</td><td>参考图像4<br>url 或 base64</td></tr><tr><td>width</td><td>string</td><td>否</td><td>生成图像的宽度<br>范围256-1440，必须是32的倍数<br>默认：1024</td></tr><tr><td>height</td><td>string</td><td>否</td><td>生成图像的高度<br>范围256-1440，必须是32的倍数<br>默认：768</td></tr><tr><td>seed</td><td>string</td><td>否</td><td>种子</td></tr><tr><td>output_format</td><td>string</td><td>否</td><td>输出格式 <code>png</code>  <code>jpeg</code>
<br>默认 <code>jpeg</code></td></tr><tr><td>safety_tolerance</td><td>integer</td><td>否</td><td>输入和输出调节的容差水平。在0到6之间，0表示最严格，6表示最宽松<br>默认：2</td></tr><tr><td><code>webhook_url</code></td><td>string</td><td>否</td><td>异步回调地址</td></tr></tbody></table>

#### 返回示例

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

```json
{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "fac30d6c-d12b-465c-a580-8b1b3ae726e3"
    }
}
```

{% endtab %}
{% endtabs %}

## Flux 2 Max  <a href="#page-title" id="page-title"></a>

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/bfl/v1/flux-2-max`

根据文本提示使用 Flux 2 Max 模型生成 或者编辑图像。[官方文档地址](https://docs.bfl.ai/flux_2/flux2_image_editing#flux-2-image-editing-parameters)

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="166">参数</th><th width="107">类型</th><th width="169">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>string</td><td>是</td><td>生成图像描述词<br>注意：Flux支持多语言理解能力，但实测英文最佳。</td></tr><tr><td>input_image</td><td>string</td><td>否</td><td>参考图像1<br>url 或 base64</td></tr><tr><td>input_image_2</td><td>string</td><td>否</td><td>参考图像2<br>url 或 base64</td></tr><tr><td>input_image_3</td><td>string</td><td>否</td><td>参考图像3<br>url 或 base64</td></tr><tr><td>input_image_4</td><td>string</td><td>否</td><td>参考图像4<br>url 或 base64</td></tr><tr><td>width</td><td>string</td><td>否</td><td>生成图像的宽度<br>范围256-1440，必须是32的倍数<br>默认：1024</td></tr><tr><td>height</td><td>string</td><td>否</td><td>生成图像的高度<br>范围256-1440，必须是32的倍数<br>默认：768</td></tr><tr><td>seed</td><td>string</td><td>否</td><td>种子</td></tr><tr><td>output_format</td><td>string</td><td>否</td><td>输出格式 <code>png</code>  <code>jpeg</code>
<br>默认 <code>jpeg</code></td></tr><tr><td>safety_tolerance</td><td>integer</td><td>否</td><td>输入和输出调节的容差水平。在0到6之间，0表示最严格，6表示最宽松<br>默认：2</td></tr><tr><td>webhook_url</td><td>string</td><td>否</td><td>异步回调地址</td></tr></tbody></table>

#### 返回示例

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

```json
{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "jobId": "fac30d6c-d12b-465c-a580-8b1b3ae726e3"
    }
}
```

{% endtab %}
{% endtabs %}