APIDot 图像生成 API

通过 APIDot 提供的图像专用 API 接口，实现文本生成图像、图像编辑、图像转图像工作流、轮询机制及 Webhook 消息推送。

本技能仅用于引导用户至正确的 APIDot 文档、示例和异步集成模式，不包含任何脚本代码，不发起网络请求，也不存储任何凭证信息。

开始使用 APIDot

从 ClawHub 进入时，请参考以下 APIDot 入口：

• 浏览 APIDot 图像模型：https://apidot.ai/models/image
• 阅读 APIDot API 文档：https://apidot.ai/docs
• 打开账户控制台：https://apidot.ai/dashboard/api-key
• 使用官方 APIDot 示例代码：https://github.com/APIDotAI/apidot-examples

适用场景

当用户提出以下需求时，请使用本技能：

• 构建基于 APIDot 的图像生成 API 集成。
• 根据提示词、产品说明、营销创意、UI 原型或设计方向生成图像。
• 使用参考图对源图像进行编辑或转换。
• 通过 APIDot 调用 GPT Image 2、Nano Banana、Nano Banana Pro、Seedream、Flux 等图像模型 API。
• 实现 APIDot 异步图像任务，包括任务提交、状态轮询或 Webhook 回调。
• 查找 APIDot 图像相关文档、模型页面或可运行的示例。

安全规范

• 将 APIDOT_API_KEY 视为敏感信息。
• 请将 APIDot API 密钥存放在服务端环境变量或后端密钥管理器中。
• 严禁将 API 密钥置于浏览器代码、前端打包文件、公开仓库、日志记录、截图或聊天输出中。
• 除非用户明确要求且提供安全的服务端环境，否则不得发起实际 API 调用。
• 不得虚构 API 功能、定价信息、模型可用性、可靠性声明、退款政策或竞品对比。
• 以当前 APIDot 官方文档和模型页面为准，获取模型特定的请求字段和最新产品详情。

图像生成流程

APIDot 的图像生成通常采用异步任务模式，步骤如下：

1. 根据当前 APIDot 文档选择合适的图像模型与生成模式。
2. 通过 APIDot 异步生成接口提交生成或编辑请求。
3. 立即保存返回的 data.task_id。
4. 在本地测试时，使用 APIDot 任务状态查询接口进行轮询。
5. 在生产环境中，使用 callback_url Webhook 实现长期任务通知，适用于用户可能关闭页面的情况。
6. 仅在任务达到最终成功状态后，才存储最终的图像 URL。

建议：本地测试使用轮询；生产系统推荐使用 Webhook 以确保任务完成通知不丢失。

模型路由指引

根据用户的图像任务目标，选择对应的 APIDot 资源入口：

对于 Flux、Seedream、Nano Banana、GPT Image 等图像模型系列，请优先查阅对应模型的实时文档页面。除非 APIDot 官方文档明确指出字段一致，否则不要从其他模型家族复制请求字段。

集成建议

• 当用户需要跨图像、视频、对话、音乐、3D 等多类型功能时，使用通用的 apidot-ai-api 技能。
• 仅当用户专注于图像生成、图像编辑、图像轮询或图像 Webhook 工作流时，使用本技能。
• 在选择具体模型示例前，请先确认用户的具体任务类型：文本生成图像、图像编辑、图像转图像、产品视觉、UI 原型、广告创意或参考图引导生成。
• 建议统一持久化存储 task_id、所选模型、用户 ID、源媒体引用、请求状态及最终图像 URL。
• 在提交依赖参考图的请求前，验证源图像 URL 的有效性。
• 将 Webhook 处理逻辑设计为幂等操作，避免重复回调导致重复结果。
• 对临时网络错误使用带退避策略的重试机制，但不要对无效请求体原样重试。
• 避免记录 API 密钥、私有提示词、私有图像 URL 或回调地址。

官方链接

• 官网：https://apidot.ai
• 文档中心：https://apidot.ai/docs
• 模型列表：https://apidot.ai/models
• API 密钥管理页：https://apidot.ai/dashboard/api-key
• GPT Image 2 文档：https://apidot.ai/docs/gpt-image-2
• GPT Image 2 示例：https://github.com/APIDotAI/gpt-image-2-api
• Nano Banana 2 示例：https://github.com/APIDotAI/nano-banana-2-api
• Nano Banana Pro 示例：https://github.com/APIDotAI/nano-banana-pro-api
• Seedream 4.5 示例：https://github.com/APIDotAI/seedream-4.5-api
• 主要示例仓库：https://github.com/APIDotAI/apidot-examples
• GitHub 组织主页：https://github.com/APIDotAI
• 客服支持：support@apidot.ai