ChatfireAPI

FLUX.1 Kontext [Pro] 文本转图片

POST

/fal-ai/flux-pro/kontext/text-to-image

绘图模型/Flux 系列/Fal.ai 平台兼容

最后修改时间：2025-07-02 09:37:55

责任人：未设置

将输入的文本描述（prompt）转换为符合描述的高质量图片，支持自定义图片数量、分辨率、种子等参数，支持同步与异步返回。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Authorization

string

可选

示例值:

Bearer {{API_KEY}}

Content-Type

string

可选

示例值:

application/json

Body 参数application/json

prompt

string

必需

用于生成图片的文本描述（必须）

seed

integer

可选

随机种子，设置相同的 seed 和 prompt 会输出相同的图片（可选）

guidance_scale

number

可选

CFG 指导强度，决定生成图片是否更贴合 prompt，默认值3.5（可选）

默认值:

3.5

sync_mode

boolean

可选

同步模式，若为 true，则直接返回图片内容（可选）

num_images

integer

可选

生成图片数量，默认为1（可选）

默认值:

safety_tolerance

enum<string>

可选

内容安全容忍度，1最严格，6最宽松，默认2（API专有，可选）

枚举值:

123456

默认值:

output_format

enum<string>

可选

图片输出格式，支持 jpeg 或 png，默认 jpeg（可选）

枚举值:

jpegpng

默认值:

jpeg

aspect_ratio

enum<string>

可选

图片输出宽高比，默认 1:1（可选）

枚举值:

21:916:94:33:21:12:33:49:169:21

默认值:

1:1

示例

{
    "prompt": "极度特写一只老虎的眼睛，正面视角。清晰聚焦于虹膜和瞳孔，展现丰富质感与色彩并有自然高光。眼睛上用白色粗笔刷书写“FLUX”。",
    "guidance_scale": 4,
    "num_images": 1,
    "output_format": "jpeg",
    "aspect_ratio": "1:1"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/fal-ai/flux-pro/kontext/text-to-image' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "极度特写一只老虎的眼睛，正面视角。清晰聚焦于虹膜和瞳孔，展现丰富质感与色彩并有自然高光。眼睛上用白色粗笔刷书写“FLUX”。",
    "guidance_scale": 4,
    "num_images": 1,
    "output_format": "jpeg",
    "aspect_ratio": "1:1"
}'

返回响应

🟢200成功

application/json

Body

status

string

必需

request_id

string

必需

response_url

string

必需

status_url

string

必需

cancel_url

string

必需

queue_position

integer

必需

示例

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

修改于 2025-07-02 09:37:55

FLUX.1 Kontext [Pro]

FLUX.1 Kontext [Multi]（实验性多图编辑）