图像生成或编辑回调
当您向 Flux Kontext API 提交图像生成或编辑任务时，可以通过 callBackUrl参数设置回调地址。任务完成后，系统会自动将结果推送到您指定的地址。
回调机制概述
回调时机
回调方式
回调请求格式
callBackUrl 发送 POST 请求，格式如下：成功回调
内容违规失败回调
生成失败回调
内部错误回调
{
"code": 200,
"msg": "图像生成成功。",
"data": {
"taskId": "task12345",
"info": {
"originImageUrl": "https://example.com/original.jpg",
"resultImageUrl": "https://example.com/result.jpg"
}
}
}状态码说明
参数说明
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
code | integer | 是 | 回调状态码，表示任务处理结果 |
msg | string | 是 | 状态消息，提供详细的状态描述 |
data.taskId | string | 是 | 任务 ID，与您提交任务时返回的 taskId 一致 |
data.info.originImageUrl | string | 否 | 原始图像 URL，有效期为 10 分钟。仅在成功时存在 |
data.info.resultImageUrl | string | 否 | 生成图像在我们服务器上的 URL。仅在成功时存在 |
状态码详情
| 状态码 | 说明 |
|---|---|
| 200 | 成功 - 图像生成成功 |
| 400 | 失败 - 您的提示词被网站标记为违反内容政策 |
| 500 | 失败 - 内部错误，请稍后重试 |
| 501 | 失败 - 图像生成任务失败 |
回调接收示例
Node.js
Python
PHP
最佳实践
回调 URL 配置建议
1.
2.
3.
4.
5.
6.
重要提醒