# 官方原格式

{% 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-zh.mjapiapp.com/api/flux-api/guan-fang-yuan-ge-shi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.