静觅
·
Nano Banana Images API 对接说明
内容提要
本文介绍了Nano Banana Images API的对接与使用，包括图像生成和编辑功能。用户需申请API Token，通过HTTP请求调用接口，支持异步回调。示例代码展示了如何生成和编辑图片，返回结果包含任务ID和生成的图片链接。注意事项包括必填参数和图片可访问性要求。
关键要点
-
Nano Banana Images API 支持图像生成和编辑功能。
-
用户需申请 API Token，通过 HTTP 请求调用接口。
-
接口的基本 URL 为 https://api.acedata.cloud，使用 POST 方法。
-
生成图片时，必填参数为 action 和 prompt，返回结果包含任务 ID 和生成的图片链接。
-
编辑图片时，需提供待编辑图片的 URL 列表和描述编辑目标的 prompt。
-
支持异步回调，通过 callback_url 接收任务完成通知。
-
请求失败时会返回标准错误格式，常见错误包括 token_mismatched 和 invalid_token。
-
必填参数包括 action 和 prompt，编辑专用参数为 image_urls，其他参数为可选。
延伸解读
API Token 申请与使用
使用 Nano Banana Images API 前，用户需申请 API Token。该 Token 是访问所有服务的凭证，首次申请时可获得免费额度，适合新用户体验。注意，Token 的管理和安全性至关重要，避免泄露以防止未授权访问。
图像生成与编辑的灵活性
该 API 提供图像生成和编辑两种功能，用户可以根据需求选择。生成时只需提供提示词，而编辑则需提供待编辑图片的 URL 列表和描述。这种灵活性使得用户能够创造多样化的图像内容，适用于不同场景。
错误处理与调试
在使用 API 时，可能会遇到各种错误，如 token_mismatched 或 invalid_token。了解这些错误代码有助于快速定位问题并进行调试。建议用户在开发过程中保留 task_id 和 trace_id，以便于后续的故障排查。
延伸问答
如何申请Nano Banana Images API的Token？
用户需到Ace Data Cloud控制台申请API Token，完成注册或登录后即可获取。
Nano Banana Images API支持哪些功能？
该API支持图像生成和图像编辑功能。
调用Nano Banana Images API时需要哪些必填参数？
必填参数包括action和prompt，编辑时还需提供image_urls。
如何使用Nano Banana Images API生成图片？
设置action为generate，并提供清晰的prompt，然后通过HTTP POST请求调用API。
如果调用Nano Banana Images API失败，如何处理？
调用失败时会返回标准错误格式，常见错误包括token_mismatched和invalid_token。
如何实现异步回调功能？
在请求体中添加callback_url，API会在任务完成后通过POST方式将结果发送到该地址。
