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

OpenAPI Specification

接口：POST /fal-ai/flux-pro/kontext/text-to-image（完整地址 https://api.allyang.cn/fal-ai/flux-pro/kontext/text-to-image）

鉴权：请求头 Authorization 传令牌，取值形如 Bearer {{YOUR_API_KEY}}（原文该字段非必填）。

请求头

• Content-Type：可选，示例取值 application/json。

请求体参数（application/json）

原文档仅把 prompt 列为必传。

• prompt：必填，string，画面描述文字；原文档另附了一条中文示例提示。
• seed：可选，integer，随机数种子；取值固定后，同一提示词可复现同一张图。
• guidance_scale：可选，number，缺省 3.5；CFG 引导强度，数值决定成图与提示词的贴合程度，可填区间 1 至 20。
• sync_mode：可选，boolean，缺省 false；置为 true 时由接口同步等待并直接回图，耗时随之拉长。
• num_images：可选，integer，缺省 1 张，上限 4 张。
• safety_tolerance：可选，string，安全阈值档位；1 限制最紧、6 限制最松，缺省 2。
• output_format：可选，string，输出编码，jpeg 或 png 二选一，缺省 jpeg。
• aspect_ratio：可选，string，画面宽高比，可填 21:9、16:9、4:3、3:2、1:1、2:3、3:4、9:16、9:21，缺省 1:1。

响应

• 200：成功。
• status、request_id、response_url、status_url、cancel_url：string。
• queue_position：integer，排队位置。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。 建议先用较小的 num_images 试跑，确认效果后再放大出图数量；开启 sync_mode 会拉长单次请求耗时，客户端的等待上限建议一并放宽。 响应里 response_url、status_url、cancel_url 三个地址字段的具体用途，原文档未展开说明，待补。