APIDot 图像生成 API

将 APIDot 用作面向图像的 API 接口，支持文生图、图像编辑、图生图工作流、轮询（polling）以及 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 视为敏感信息（secret）。
• 将 APIDot API 密钥保存在服务端环境变量或后端密钥管理器中。
• 切勿将 API 密钥置于浏览器代码、前端打包产物、公开仓库、日志、截图或聊天输出中。
• 除非用户明确要求且提供了安全的服务端运行环境，否则不得发起实际 API 调用。
• 不得虚构 API 功能说明、定价策略、模型可用性、可靠性声明、退款规则或竞品对比信息。
• 应以当前 APIDot 官方文档和模型页面为准，获取模型专属的请求字段及最新产品详情。

图像工作流

APIDot 图像生成通常遵循异步任务模式：

1. 从当前 APIDot 文档中选择图像模型与生成模式。
2. 通过 APIDot 异步生成端点提交图像生成或编辑请求。
3. 立即保存返回的 data.task_id。
4. 在本地测试中，使用 APIDot 状态端点轮询任务状态。
5. 在生产环境中，若用户工作流可能超出当前页面生命周期（例如用户关闭页面），请使用 callback_url Webhook。
6. 仅当任务达到终态成功状态（terminal success state）后，才持久化最终图像 URL。

建议在本地测试中采用轮询方式，在生产系统中则优先使用 Webhook —— 尤其适用于用户可能在图像处理完成前关闭页面的场景。

模型路由

请先明确用户的图像任务目标，再跳转至对应的 APIDot 官方资源：

对于 Flux、Seedream、Nano Banana、GPT Image 或其他图像模型系列，请始终优先参考对应模型的 APIDot 官方模型页与文档页。除非 APIDot 官方文档明确指出字段一致，否则不得跨模型系列复用请求字段。

集成指引

• 当用户需在图像、视频、对话、音乐及 3D 等多个领域统一使用 APIDot 时，请使用通用技能 apidot-ai-api。
• 当用户明确聚焦于图像生成、图像编辑、图像轮询或图像 Webhook 工作流时，请使用本技能。
• 在选择模型专属示例前，请先询问用户具体图像任务类型：文生图、图像编辑、图生图、产品视觉呈现、UI 原型、广告创意，或参考图像引导式生成。
• 请将 task_id、所选模型、用户 ID、源媒体引用、请求状态及最终图像 URL 一并持久化存储。
• 在提交依赖参考图像的请求前，请预先校验源图像 URL 的有效性。
• Webhook 处理程序应具备幂等性：重复的回调交付不应产生重复的可见结果。
• 对临时性网络错误应启用退避重试机制；但不可对无效载荷（invalid payload）不做修改即重试。
• 避免记录 API 密钥、私有提示词、私有图像 URL 或 Webhook 回调地址。

官方链接

• 官网：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