当 NanoBanana Pro 图像生成任务完成时,系统将通过 POST 请求将结果发送到您提供的回调 URL
当您向 NanoBanana Pro API 提交图像生成任务时,可以通过 callBackUrl 参数设置回调地址。任务完成后,系统会自动将结果推送到您指定的地址。回调机制概述#
回调机制避免了您需要轮询 API 查询任务状态,系统会主动推送任务完成结果到您的服务器。
回调时机#
NanoBanana Pro 图像生成任务成功完成
回调方式#
回调请求格式#
任务完成后,系统会向您的 callBackUrl 发送 POST 请求,格式如下:{
"msg": "Image generated successfully.",
"code": 200,
"data": {
"taskId": "9e4286b7b27960dfeb8e1d279b50b28d",
"info": {
"resultImageUrl": "https://tempfile.aiquickdraw.com/r/9e4286b7b27960dfeb8e1d279b50b28d_1756467493.jpg"
}
}
}
状态码说明#
code · integer · required| 状态码 | 说明 |
|---|
| 200 | 成功 - 图像生成成功 |
| 400 | 失败 - 您的提示词被网站标记为违反内容政策 |
| 500 | 失败 - 内部错误,请稍后重试 |
| 501 | 失败 - 图像生成任务失败 |
data.taskId · string · required任务 ID,与您提交任务时返回的 taskId 一致data.info.resultImageUrl · string生成图像在我们服务器上的 URL。仅在成功时存在。回调接收示例#
以下是用流行编程语言接收 NanoBanana Pro 回调的示例代码:最佳实践#
回调 URL 配置建议#
1.
使用 HTTPS: 确保回调 URL 使用 HTTPS 协议,保证数据传输安全
3.
幂等处理: 同一个 taskId 可能收到多次回调,确保处理逻辑是幂等的
4.
快速响应: 回调处理应尽快返回 200 状态码,避免超时
5.
异步处理: 复杂的业务逻辑应异步处理,避免阻塞回调响应
重要提醒#
请确保回调处理逻辑的稳定性,避免因异常导致回调失败
正确解析 data.info.resultImageUrl 字段以获取生成的图像 URL
需要处理多种错误状态码(400, 500, 501),实现完整的错误处理
故障排查#
替代方案#
轮询查询结果
使用获取任务详情接口定期查询任务状态,建议每 30 秒查询一次。