Flux Dev

Flux-dev 是一个拥有 120 亿参数的整流流 Transformer 文本转图像模型。

功能

flux-dev 是一个 120 亿参数的整流流 Transformer，可以根据文字描述生成图像。

核心功能

高质量图像生成： 根据文本提示词生成细节丰富、视觉效果出色的图像。
通过引导蒸馏实现高效训练： 使用引导蒸馏技术提升训练效率和模型响应能力。
开放权重： 开放模型权重，方便科学研究和创意开发。
用途灵活： 适合个人、科学和商业应用，在不同使用场景中都具有灵活性。

限制

创意导向： 主要用于创意图像合成，不适合生成事实准确的内容。
固有偏见： 输出可能反映训练数据中存在的偏见。
输入敏感性： 生成图像的质量和一致性很大程度上取决于输入文本质量；细微变化可能导致输出不同。
依赖提示词： 模型表现与提示词的清晰度和结构密切相关，可能需要仔细编写提示词才能获得最佳结果。

不适用的用途

模型及其衍生模型不得以任何违反适用国家、联邦、州、地方或国际法律法规的方式使用，包括但不限于：

剥削、伤害或试图剥削/伤害未成年人，包括招揽、制作、获取或传播儿童剥削内容。
以伤害他人为目的生成或传播可验证的虚假信息。
创建或传播可能被用于伤害个人的个人可识别信息。
骚扰、虐待、威胁、跟踪或欺凌个人或群体。
制作未经同意的裸体或非法色情内容。
做出会不利影响个人法律权利或产生约束性义务的完全自动化决定。
协助大规模虚假信息活动。

加速推理

我们的加速推理方案采用 WavespeedAI 的先进优化技术。这种创新的融合技术显著降低了计算开销和延迟，在不牺牲质量的情况下实现快速图像生成。整个系统经过设计，可以高效处理大规模推理任务，同时确保实时应用在速度与准确性之间达到良好平衡。更多详情请参阅相关博客文章。

身份验证

身份验证详情请参阅身份验证指南。

API 端点

提交任务并查询结果

提交任务

curl --location --request POST "https://api.muapi.ai/api/v1/flux-dev-image" \
--header "Content-Type: application/json" \
--header "x-api-key: ${MUAPIAPP_API_KEY}" \
--data-raw '{
    "prompt": "A stylish model, fashion show, showcase a designer outfit, orange colour suit, conspicuous jewelry, fashion show background, vibrant color, dramatic makeup",
    "image": "",
    "size": "1024*1024",
    "num_inference_steps": 28,
    "seed": -1,
    "guidance_scale": 3.5,
    "num_images": 1
}'

获取结果

curl --location --request GET "https://api.muapi.ai/api/v1/predictions/${requestId}/result" \
--header "x-api-key: ${MUAPIAPP_API_KEY}"

任务提交参数

参数	类型	必填	默认值	范围	描述
prompt	string	是	A stylish model, fashion show, showcase a designer outfit, orange colour suit, conspicuous jewelry, fashion show background, vibrant color, dramatic makeup	-	用于生成图像的提示词。
image	string	否	-	-	用于生成图像的输入图像。
mask_image	string	否	-	-	mask 图像告诉模型哪些位置需要生成新像素（白色），哪些位置需要保留原图（黑色）；它相当于用于定向编辑的模板或引导。
strength	number	否	0.8	0.00 ~ 1.00	表示转换参考图像的程度。
size	string	否	1024*1024	每个维度 512 ~ 1536	生成图像的尺寸。
num_inference_steps	integer	否	28	1 ~ 50	执行的推理步数。
seed	integer	否	-1	-1 ~ 9999999999	对同一版本模型使用相同 seed 和相同提示词，每次都会输出相同图像。
guidance_scale	number	否	3.5	1.0 ~ 20.0	CFG（Classifier Free Guidance）比例，用于控制生成图像贴合提示词的程度。
num_images	integer	否	1	1 ~ 4	要生成的图像数量。
enable_base64_output	boolean	否	false	-	启用后，输出会编码为 BASE64 字符串，而不是 URL。
enable_safety_checker	boolean	否	true	-	设置为 true 时启用安全检查器。

参数

任务提交参数

参数	类型	必填	默认值	范围/示例	描述
prompt	string	是	-	-	用于生成图像的提示词。
image	string	否	-	-	用于生成图像的输入图像。
mask_image	string	否	-	-	mask 图像告诉模型哪些位置需要生成新像素（白色），哪些位置需要保留原图（黑色）；它相当于用于定向编辑的模板或引导。
strength	number	否	0.8	0.00 ~ 1.00	表示转换参考图像的程度。
size	string	否	1024*1024	每个维度 512 ~ 1536	生成图像的尺寸。
num_inference_steps	integer	否	28	1 ~ 50	执行的推理步数。
seed	integer	否	-1	-1 ~ 9999999999	对同一版本模型使用相同 seed 和相同提示词，每次都会输出相同图像。
guidance_scale	number	否	3.5	1.0 ~ 20.0	CFG（Classifier Free Guidance）比例，用于控制生成图像贴合提示词的程度。
num_images	integer	否	1	1 ~ 4	要生成的图像数量。
enable_base64_output	boolean	否	false	-	启用后，输出会编码为 BASE64 字符串，而不是 URL。
enable_safety_checker	boolean	否	true	-	设置为 true 时启用安全检查器。

响应参数

参数	类型	描述
code	integer	HTTP 状态码（例如成功时为 200）。
message	string	状态消息（例如“success”）。
data.id	string	预测任务的唯一标识符，即任务 ID。
data.model	string	用于预测的模型 ID。
data.outputs	array	生成内容的 URL 数组（任务未完成时为空）。
data.urls	object	相关 API 端点的对象。
data.urls.get	string	获取预测结果的 URL。
data.has_nsfw_contents	array	每个输出是否检测到 NSFW 内容的布尔值数组。
data.status	string	任务状态：created、processing、completed 或 failed。
data.created_at	string	请求创建时间的 ISO 时间戳（例如“2023-04-01T12:34:56.789Z”）。
data.error	string	错误消息；没有错误时为空。
data.timings	object	时间信息对象。
data.timings.inference	integer	推理时间（毫秒）。

结果查询参数

参数	类型	必填	默认值	描述
id	string	是	-	任务 ID。

结果响应参数

参数	类型	描述
code	integer	HTTP 状态码（例如成功时为 200）。
message	string	状态消息（例如“success”）。
data	object	包含全部详情的预测数据对象。
data.id	string	预测任务的唯一标识符。
data.model	string	用于预测的模型 ID。
data.outputs	array	生成内容的 URL 数组（任务未完成时为空）。
data.urls	object	相关 API 端点的对象。
data.urls.get	string	获取预测结果的 URL。
data.has_nsfw_contents	array	每个输出是否检测到 NSFW 内容的布尔值数组。
data.status	string	任务状态：created、processing、completed 或 failed。
data.created_at	string	请求创建时间的 ISO 时间戳。
data.error	string	错误消息；没有错误时为空。
data.timings	object	时间信息对象。
data.timings.inference	integer	推理时间（毫秒）。