详细分析 ▾
运行时依赖
版本
首次发布 flux-image,通过 AceDataCloud API 使用 Flux 生成与编辑图像。 - 支持多种 Flux 模型(dev、pro、ultra、kontext)进行图像生成与编辑。 - 提供文生图及基于文本指令的图像编辑功能。 - 需要 ACEDATACLOUD_API_TOKEN 进行身份验证。 - 包含使用示例、支持的尺寸/比例选项及模型选择指南。 - 兼容 mcp-flux,支持扩展工具与自动化。
安装命令
点击复制技能文档
# Flux 图像生成 通过 AceDataCloud 的 Flux API 生成和编辑图像。 ## 认证 ``bash export ACEDATACLOUD_API_TOKEN="your-token-here" ` ## 快速开始 `bash curl -X POST https://api.acedata.cloud/flux/images \ -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"prompt": "a cat wearing a space helmet, photorealistic", "model": "flux-dev", "wait": true}' ` ## 模型 | 模型 | 质量 | 速度 | 尺寸 | 适用场景 | |-------|---------|-------|-------|----------| | flux-dev | 良好 | 快 | 256–1440px | 快速生成(默认) | | flux-pro | 高 | 中 | 256–1440px | 生产级任务 | | flux-pro-1.1 | 更高 | 中 | 256–1440px | 更好的 prompt 遵循 | | flux-pro-1.1-ultra | 最高 | 慢 | 长宽比 | 极致质量 | | flux-kontext-pro | 高 | 中 | 长宽比 | 图像编辑 | | flux-kontext-max | 最高 | 慢 | 长宽比 | 复杂编辑 | ## 生成图像 `json POST /flux/images { "prompt": "a minimalist logo of a mountain", "action": "generate", "model": "flux-pro-1.1", "size": "1024x1024", "count": 1 } ` ### 尺寸选项 dev/pro/pro-1.1(像素尺寸): - "1024x1024"、"1344x768"、"768x1344"、"1024x576"、"576x1024" ultra/kontext(长宽比): - "1:1"、"16:9"、"9:16"、"4:3"、"3:4"、"3:2"、"2:3"、"21:9"、"9:21" ## 编辑图像 使用 kontext 模型进行文本引导的图像编辑: `json POST /flux/images { "prompt": "change the background to a beach sunset", "action": "edit", "image_url": "https://example.com/photo.jpg", "model": "flux-kontext-pro" } ` ## 任务轮询 `json POST /flux/tasks {"task_id": "your-task-id"} ` ## MCP 服务器 `bash pip install mcp-flux ` 或托管地址:https://flux.mcp.acedata.cloud/mcp 关键工具:flux_generate_image、flux_edit_image ## 注意事项 - dev/pro 模型使用像素尺寸(如 "1024x1024"),ultra/kontext 模型使用长宽比(如 "16:9") - 编辑功能必须使用 kontext 模型(flux-kontext-pro 或 flux-kontext-max)——其他模型仅支持生成 - count 参数可一次请求生成多张图像(费用按比例增加) - ultra 模型质量最高但速度最慢——迭代阶段用 dev,最终输出用 ultra - 所有生成均为异步——使用 "wait": true 或轮询 /flux/tasks`