# FLUX.1 Kontext [Max] 文本转图像

**方法**: `POST`
**路径**: `/fal-ai/flux-pro/kontext/text-to-image`

FLUX.1 Kontext [max] 是一款高性能文本转图像AI模型，支持高还原文本描述生成高质量图片，且在各种细节和风格领域表现突出。

## 请求参数

### Header 参数

```text
Content-Type
string
可选
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
prompt
string
生成图片的文本提示
必需
示例:
一只猫咪在宇宙飞船里俯瞰地球
seed
integer
可选
随机种子，相同seed将产生相同图片。
guidance_scale
number
可选
CFG 指令引导参数，决定图片与 prompt 的贴合度，默认3.5，取值范围[1,20]。
sync_mode
boolean
可选
是否同步等待图片生成功能，true时接口直接返回图像，latency更高。
默认值:
false
num_images
integer
可选
一次生成图片数量，默认1，最多4。
>= 1
<= 4
safety_tolerance
enum<string>
可选
安全容忍度，1最严格，6最宽松。默认2。
枚举值:
1
2
3
4
5
6
默认值:
2
output_format
enum<string>
可选
生成图片的格式，支持jpeg/png，默认jpeg。
枚举值:
jpeg
png
默认值:
jpeg
aspect_ratio
enum<string>
可选
长宽比例，默认1:1
枚举值:
21:9
16:9
4:3
3:2
1:1
2:3
3:4
9:16
9:21
默认值:
1:1
示例
{
"prompt"
:
"极致特写，一只老虎的单只眼睛，正面。细节清晰，虹膜与瞳孔分明，自然光照下富有真实质感，眼部画有大白色毛笔字'FLUX'。"
,
"guidance_scale"
:
3.5
,
"num_images"
:
1
,
"safety_tolerance"
:
"2"
,
"output_format"
:
"jpeg"
,
"aspect_ratio"
:
"1:1"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/fal-ai/flux-pro/kontext/text-to-image' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "极致特写，一只老虎的单只眼睛，正面。细节清晰，虹膜与瞳孔分明，自然光照下富有真实质感，眼部画有大白色毛笔字'\''FLUX'\''。",
  "guidance_scale": 3.5,
  "num_images": 1,
  "safety_tolerance": "2",
  "output_format": "jpeg",
  "aspect_ratio": "1:1"
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
status
string
必需
request_id
string
必需
response_url
string
必需
status_url
string
必需
cancel_url
string
必需
queue_position
integer
必需
```

#### 示例

```json
{
    "status": "IN_QUEUE",
    "request_id": "551a32da-52b2-4be8-bf2f-bfb7cce2b324",
    "response_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324",
    "status_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/status",
    "cancel_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/cancel",
    "queue_position": 0
}
```