# FLUX.1 [Dev] 文本生成图片

**方法**: `POST`
**路径**: `/fal-ai/flux-1/dev`

图片描述词，即你期望模型生成的场景、内容描述。必填项。

## 请求参数

### Header 参数

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

### Body 参数 application/json

```text
prompt
string
必需
图片描述词，即你期望模型生成的场景、内容描述。必填项。
num_images
integer
可选
生成图片数量（最大4）。默认 1。
image_size
可选
预设图片尺寸（或自定义分辨率，见下），默认 landscape_4_3。
One of:
object
string
sync_mode
boolean
可选
同步生成（true则等图片上传后直接返回，false则异步，默认false）。
guidance_scale
number
可选
引导系数(数值越大图片内容更贴近prompt)，默认3.5，范围1~20。
num_inference_steps
integer
可选
推理迭代步数，影响图片精细度，默认28，范围1~50。
seed
integer
可选
随机数种子，设置后同样描述和参数多次请求生成一致图片。
enable_safety_checker
boolean
可选
启用内容安全检查（默认true）。
示例
{
"prompt"
:
"string"
,
"num_images"
:
0
,
"image_size"
:
{
}
,
"sync_mode"
:
true
,
"guidance_scale"
:
0
,
"num_inference_steps"
:
0
,
"seed"
:
0
,
"enable_safety_checker"
:
true
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/fal-ai/flux-1/dev' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "string",
    "num_images": 0,
    "image_size": {},
    "sync_mode": true,
    "guidance_scale": 0,
    "num_inference_steps": 0,
    "seed": 0,
    "enable_safety_checker": true
}'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
object
```

#### 示例

```json
{}
```