在本篇文章中我们将为您介绍 Flux 图像生成 API 的集成步骤。通过该 API您可以输入自定义参数以生成官方的 Flux 图像。Flux 图像生成 API 是一个强大的工具适用于需要图像生成的应用场景如内容创作、游戏开发和广告设计等。环境准备/前置条件在开始之前您需要满足以下前置条件注册并登录 Ace Data Cloud 账户。申请 Flux 图像生成 API 服务具体步骤见下文。详细步骤1. 申请 API要使用该 API您首先需要在 Flux 图像生成 API 页面申请相应的服务。进入页面后点击“获取”按钮如下图所示如果您尚未登录或注册系统会自动引导您进行相应操作。注册或登录后您将会返回到当前页面。首次申请时您将获得免费的使用配额可以免费使用该 API。2. 基本用法了解基本的使用方法后您需要输入prompt提示、action操作和size图像大小以获取处理结果。您需要设置action字段为generate并输入提示信息在请求头中我们需要设置以下字段accept: 响应结果的格式填写application/json表示返回 JSON 格式。authorization: 调用 API 的密钥申请后可直接获取。请求体中包含action: 图像生成任务的操作类型。size: 生成图像的大小。count: 生成图像的数量默认值为 1该参数仅对图像生成任务有效编辑任务无效。prompt: 提示内容。model: 生成模型默认值为flux-dev。callback_url: 接收回调结果的 URL。参数size存在一些特殊限制主要分为两类width x height纵横比和x:y图像比例。具体如下表模型范围flux-2-flex支持纵横比 x 64 且必须为 32 的倍数flux-2-pro支持纵横比 x 64 且必须为 32 的倍数flux-2-max支持纵横比 x 64 且必须为 32 的倍数flux-pro-1.1支持纵横比 256 x 1440 且必须为 32 的倍数flux-dev支持纵横比 256 x 1440 且必须为 32 的倍数flux-pro-1.1-ultra不支持纵横比flux-kontext-pro不支持纵横比flux-kontext-max不支持纵横比选择完毕后您可以看到右侧生成的代码示例如下图所示点击“尝试”按钮进行测试您将获得如下 JSON 结果{ success: true, task_id: 226eb763-9eab-4d06-ad57-d59753a03307, trace_id: 089f8b46-0167-4f25-88ee-3c3f88d80e84, data: [ { prompt: a white siamese cat, image_url: https://fal.media/files/lion/NVhtlwwGYQD6HrGaEfrzu_341484fad6d84b21b73f4f8824a3f98a.png, timings: 1752743801 } ] }返回结果包含多个字段说明如下success: 图像生成任务的状态。task_id: 当前图像生成任务的 ID。trace_id: 当前图像生成的追踪 ID。data: 当前图像生成任务的结果列表其中包含image_url: 图像生成任务的链接。prompt: 提示内容。3. 编辑图像任务若要编辑特定图像需传入image_url参数链接指向需编辑的图像此时action仅支持edit并可指定以下内容model: 用于此图像编辑任务的模型支持flux-kontext-max和flux-kontext-pro。示例输入如下填写完后系统将自动生成如下代码对应的代码如下import requests url https://api.acedata.cloud/flux/images headers { accept: application/json, authorization: Bearer {token}, content-type: application/json } payload { action: edit, prompt: a white siamese cat, model: flux-kontext-pro, image_url: https://cdn.acedata.cloud/ytj2qy.png } response requests.post(url, jsonpayload, headersheaders) print(response.text)运行后您将立即获得如下结果{ success: true, task_id: 2a7979ff-1f77-4380-92c6-a2dc37c3b4c8, trace_id: 732b65c0-48d9-49f7-b568-64e5acffe4c0, data: [ { prompt: a white siamese cat, image_url: https://fal.media/files/monkey/aEUXJZ6Faj9YXUCQVs01Q_af0cea56c558441c9ba8df67b200812d.png, timings: 1752744073 } ] }生成效果为原始图像的编辑结果。4. 异步回调由于 Flux 图像生成 API 的生成时间相对较长约需 1-2 分钟若 API 长时间未响应HTTP 请求将保持连接导致额外的系统资源消耗。因此此 API 还支持异步回调。具体流程如下客户端发起请求时需额外指定callback_url字段。请求后API 会立即返回一个结果包含task_id字段表示当前任务 ID。任务完成后生成结果将以 POST JSON 形式发送至客户端指定的callback_url也包含task_id字段便于通过 ID 关联任务结果。具体操作如下首先您需要一个能够接收 HTTP 请求的 Webhook 回调服务开发者应将其替换为自己 HTTP 服务器的 URL。为演示目的我们使用公共的 Webhook 示例网站 https://webhook.site/您可以获取一个 Webhook URL如下图所示复制该 URL可以作为 Webhook 使用示例为https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab。接下来设置callback_url字段为上面的 Webhook URL并填写相应参数如下图所示点击运行您将立即获得如下结果{ task_id: 6a97bf49-df50-4129-9e46-119aa9fca73c }稍后您可以在https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab上查看生成的图像结果内容如下json { success: true, task_id: 6a97bf49-df50-4129-9e46-119aa9fca73c