Flux Images Generation API 对接说明
内容提要
本文介绍Flux Images Generation API的对接方法。用户需在Ace Data Cloud控制台获取API Token，通过输入提示词、尺寸等参数生成或编辑图片。API支持同步和异步回调模式，异步时需提供callback_url接收结果。文章详细说明了请求参数、模型选择、错误处理及返回字段，帮助开发者快速集成图片生成功能。
延伸解读
模型与尺寸选择要点
不同模型对尺寸参数的要求不同：flux-dev和flux-pro支持宽高比例（如1024x1024）或图片比例（如1:1），而flux-2系列及flux-kontext系列仅支持图片比例（如16:9）。若使用新旗舰模型时误传像素尺寸，将返回400错误。开发者需根据所选模型正确设置size参数，避免调用失败。
异步回调机制解析
由于图片生成耗时约1-2分钟，API提供异步回调模式。设置callback_url后，请求立即返回task_id，任务完成时结果会通过POST JSON发送至该URL，其中包含相同的task_id用于关联。若未提供callback_url，可设置async为true，通过轮询任务查询接口获取结果。开发者可根据业务场景选择同步或异步方式。
错误码与排查建议
API错误响应包含错误码和消息，如401表示token无效，429表示请求超限，500表示服务器内部错误。遇到错误时，可结合trace_id向技术支持反馈。建议开发者提前处理常见错误，如检查token有效性、控制请求频率，并确保参数符合模型要求，以减少调用失败。
Q&A
如何获取Flux Images Generation API的API Token？
需要到Ace Data Cloud控制台获取API Token。如果尚未登录或注册，会自动跳转到登录页面，注册登录后会自动返回当前页面。一个API Token即可调用平台所有服务，首次申请会赠送免费额度。
Flux Images Generation API支持哪些模型？
支持的模型包括：flux-dev、flux-pro、flux-2-flex、flux-2-pro、flux-2-max、flux-kontext-pro、flux-kontext-max。其中flux-2-pro和flux-2-max是最新旗舰模型，画质更高。
Flux Images Generation API的size参数有哪些限制？
size参数分为宽高比例（如1024x1024）和图片比例（如1:1、16:9）两种类型。flux-dev和flux-pro支持宽高比例和图片比例，而flux-2-flex、flux-2-pro、flux-2-max、flux-kontext-pro、flux-kontext-max仅支持图片比例。参考的图片比例有：21:9、16:9、4:3、3:2、1:1、2:3、3:4、9:16、9:21。
如何异步调用Flux Images Generation API？
在请求中设置async为true，并可选提供callback_url。接口会立即返回task_id，任务完成后结果会通过POST JSON发送到callback_url。如果不提供callback_url，可以通过任务查询接口轮询获取结果。
Flux Images Generation API返回结果包含哪些字段？
返回结果包含success（任务状态）、task_id（任务ID）、trace_id（跟踪ID）、data（结果列表），其中data中包含image_url（图片链接）和prompt（提示词）等字段。
Flux Images Generation API的错误码有哪些？
常见错误码包括：400 token_mismatched（参数缺失或无效）、400 api_not_implemented（参数缺失或无效）、401 invalid_token（无效或缺失授权token）、429 too_many_requests（请求过多）、500 api_error（服务器内部错误）。
如何编辑图片？
编辑图片时，需要将action设置为edit，并传入image_url参数指定要编辑的图片链接。支持的模型包括flux-dev、flux-pro、flux-kontext-pro、flux-kontext-max、flux-2-flex、flux-2-pro、flux-2-max。
