统一认证，接入所有提供方
一把 RunAPI key 解锁整个模型目录。无需为每家提供方单独建账户。
curl -X POST https://runapi.ai/api/v1/flux/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-dev",
"prompt": "生成一张 4K 的产品 hero 图：哑光黑色水瓶放在米色石面上，侧光柔和。"
}'import { FluxClient } from "@runapi.ai/flux";
const client = new FluxClient();
const result = await client.textToImage.run({
model: "flux-dev",
prompt: "生成一张 4K 的产品 hero 图：哑光黑色水瓶放在米色石面上，侧光柔和。",
});require "runapi/flux"
client = RunApi::Flux::Client.new
result = client.text_to_image.run(
model: "flux-dev",
prompt: "生成一张 4K 的产品 hero 图：哑光黑色水瓶放在米色石面上，侧光柔和。"
)npx skills add runapi-ai/flux -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor概览
关于 Flux
Flux 以三款模型覆盖高质量生产、高效迭代与低延迟生成，其中 Dev 和 Pro 还提供单图编辑能力。
提供方
Black Forest Labs
模态
图像
对比全部 API 变体
定价
Flux 定价
| Endpoint | 分辨率 | 时长 | 价格 | |
|---|---|---|---|---|
| text_to_image | — | — | $0.01 / 张图片 |
当前价格适用于 flux-2-klein。其他变体保留各自的 endpoint 定价。
Agent 集成
通过 Agent 运行 Flux
工作流程
开始使用 Flux
-
选择模型
根据输出类型、质量要求和延迟目标选择模型与变体。
-
配置
设置 RunAPI key，并在代码工作区安装对应 model skill。
-
调用
按 skill 里的说明，把模型能力接入到你的应用里。
-
接收
按 task ID 轮询、在支持时使用流式，或处理 webhook 回调。
为什么用 RunAPI 调用 Flux API
统一的定价与账单
USD 按次定价，按月结算。失败的生成不计费。
Schema 优先的 SDK
Typed schema 和接入说明已打包进 model skill，让实现从正确契约开始。
Flux 常见问题
应该选择哪款 Flux 模型？
高效迭代选择 Flux Dev，追求提示词遵循和视觉细节选择 Flux Pro，快速低延迟工作流选择 Flux 2 Klein。
Flux 可以编辑现有图像吗？
可以。使用 Flux Dev 或 Flux Pro 时，单图编辑端点接收恰好一张可公开访问的源图，按照文字指令修改，并返回与文生图一致的任务响应结构。
应该从哪个变体开始？
选满足质量要求的最便宜变体。多数团队从 fast 起步，生产时升级到 pro。
有免费额度吗？
创建账户和 API Key 免费。API 调用采用预付费按量计费，充值后即可使用。
支持流式吗？
模型支持流式时，RunAPI 端到端流式。
失败怎么计费？
失败的生成不计费。
相似模型
如果喜欢 Flux API，也可以试试这些
立即体验 Flux API。
同提供方
文档
- 快速开始
- API 参考
- SDK README
- 更新日志