你将构建什么
你将使用POST /flux/v1/flux-dev 创建一个 Flux 图像生成任务,轮询 GET /flux/v1/get_result,并在任务就绪后下载生成图像的 URL。
前提条件
- 存储在
COMETAPI_KEY中的 CometAPI API 密钥 - 安装了
requests的 Python 3.10+,或 Node.js 18+ - 来自 Flux API 参考文档或 Models 的 Flux 模型路径
API 密钥、基础 URL、身份验证
Flux 生成会在 URL 路径中使用模型名称:代码示例
使用下方的标签页查看可复制的 cURL、Python 和 Node.js 示例。流程说明
Flux 生成是异步的。创建端点会返回一个任务id。轮询 /flux/v1/get_result?id=<task_id>,直到 status 为 Ready,然后下载 result.sample。
Flux 结果 URL 具有时效限制。当你的应用需要持久访问时,请将已完成的图片复制到你自己的存储中。
常见参数
故障排查 / 常见问题
任务一直处于 pending 状态
任务一直处于 pending 状态
使用带有重试次数上限和超时设置的轮询循环持续查询。保存任务 ID,以便后续检查该任务。
图片 URL 已过期
图片 URL 已过期
在任务变为
Ready 后尽快下载 result.sample,然后将图片存储到你自己的存储系统中。某个 Flux 参数调用失败
某个 Flux 参数调用失败
Flux 参数支持会因模型变体而异。先从
prompt、width 和 height 开始,然后在添加可选字段之前查看 Flux API 参考。后续步骤
- 阅读 Flux 生成图片 API 参考。
- 使用 获取 Flux 图片结果 轮询结果。
- 在 Models 中查找 Flux 模型。
- 使用 在调用模型前估算请求成本。