APIDot 图像生成 API

使用 APIDot 作为以图像为核心的 API 接口，支持文本生成图像、图像编辑、图像到图像的工作流、轮询以及 webhook 通知。

此技能仅用于将图像生成相关问题引导至正确的 APIDot 文档、示例和异步集成模式。它为纯文档用途：不包含任何脚本，不发起网络请求，也不存储凭证。

何时使用

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

• 构建基于 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 时，使用通用的 apidot-ai-api 技能。
• 当用户专注于图像生成、图像编辑、图像轮询或图像 webhook 工作流时，使用本技能。
• 在选择具体模型示例前，请先确认用户的具体图像任务类型：文本生成图像、图像编辑、图像到图像、产品视觉、UI 原型、广告创意或参考引导生成。
• 将 task_id、所选模型、用户 ID、源媒体引用、请求状态和最终图像 URL 一起持久化存储。
• 在提交依赖参考图像的请求前，验证源图像 URL 的有效性。
• 将 webhook 处理程序视为幂等操作。重复的回调不应导致可见结果的重复。
• 对临时网络失败使用带退避机制的重试策略。不要对无效负载原样重试。
• 避免记录 API 密钥、私有提示词、私有图像 URL 或回调 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