APIDot GPT Image 2 API

将 APIDot 用作面向 GPT Image 2 的 API 接口，支持文生图、图像编辑、图生图工作流、轮询（polling）以及 Webhook 回调交付。

本技能用于将用户关于 GPT Image 2 的问题精准路由至对应的 APIDot 文档、示例、参考说明及异步集成模式。该技能纯属文档性质：不包含任何脚本、不发起网络请求、也不存储凭据。

本次发布仅包含 SKILL.md 文件，以及 references/api.md 中的非可执行说明。不包含可执行文件、安装时自动化脚本、审核自动化辅助工具、Shell 自动化脚本、打包的 API 客户端、自动网络调用或已存储的凭据。

从 APIDot 入门

若您来自 ClawHub，请通过以下 APIDot 入口开始：

• 打开 GPT Image 2 模型页面：https://apidot.ai/models/gpt-image-2
• 查阅 GPT Image 2 API 文档：https://apidot.ai/docs/gpt-image-2
• 进入账户控制台：https://apidot.ai/dashboard/api-key
• 参考通用 APIDot 示例：https://github.com/APIDotAI/apidot-examples

适用场景

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

• 基于 APIDot 构建 GPT Image 2 API 集成；
• 根据提示词、产品简报、营销活动概念或设计方向生成图像；
• 使用参考引导式工作流对源图像进行编辑或转换；
• 通过 APIDot 使用 GPT Image 2 进行图像生成或图像编辑；
• 在 APIDot 中实现异步图像任务，包括任务提交、任务状态轮询或 Webhook 回调；
• 查找 APIDot 关于 GPT Image 2 的文档、模型页面或可运行示例。

安全规范

• 将 APIDOT_API_KEY 视为敏感凭据；
• 将 APIDot API 密钥存放于服务端环境变量或后端密钥管理器中；
• 切勿将 API 密钥置于浏览器端代码、前端构建包、公开代码仓库、日志、截图或聊天输出中；
• 除非用户明确要求且提供了安全的服务端运行环境，否则不得发起实时 API 调用；
• 不得虚构 API 功能细节、商业条款、模型可用性、可靠性声明或竞品对比信息；
• 应以当前 APIDot 官方文档和模型页面为准，获取模型专属的请求字段与最新产品信息。

GPT Image 2 工作流

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

1. 根据当前 APIDot 文档，选择 GPT Image 2 的请求模式；
2. 通过 APIDot 文档中定义的异步生成流程，提交图像生成或编辑请求；
3. 立即保存返回的 data.task_id；
4. 在本地测试时，使用文档中指定的任务状态查询 API 轮询任务进度；
5. 在生产环境队列或可能超出当前页面生命周期的用户工作流中，使用 callback_url Webhook 回调机制；
6. 仅当任务进入终态成功状态（terminal success state）后，才持久化最终图像 URL。

请勿猜测模型专属的请求载荷字段。若用户需要可直接复制的请求示例，请引导其查阅当前 APIDot 官方文档或对应 GitHub 示例。

模型路由

请从用户具体的 GPT Image 2 任务出发，跳转至匹配的 APIDot 资源：

针对 GPT Image 2 的请求模式，请优先参考 APIDot 实时更新的模型页面与文档页面。除非 APIDot 文档明确指出某字段在多个图像模型家族中通用，否则不得跨模型家族复用请求字段。

references/api.md 提供了本地化的、不可执行的 GPT Image 2 模型路由说明、请求规划要点及异步工作流备注。

集成建议

• 当用户需要覆盖多个模型家族的通用图像生成指导时，请使用 apidot-image-generation-api 技能；
• 当用户明确基于 APIDot 构建 GPT Image 2 应用时，请使用本技能；
• 在选择模型专属示例前，请先向用户确认其具体图像任务类型：文生图、图像编辑、图生图、产品视觉图、UI 原型图、广告创意图，或参考引导式生成；
• 请将 task_id、所选模型、用户 ID、源媒体引用、请求状态及最终图像 URL 一并持久化；
• 在提交依赖参考图像的工作流前，请预先校验源图像 URL 的有效性；
• 将 Webhook 处理器视为幂等接口：重复回调不应导致重复的可见结果；
• 对临时性网络错误采用退避重试策略；但对无效载荷不得未经修改直接重试；
• 避免记录 API 密钥、私有提示词、私有图像 URL、生成图像 URL 或 Webhook 回调 URL。

官方链接

• 官网：https://apidot.ai
• 文档中心：https://apidot.ai/docs
• GPT Image 2 模型页面：https://apidot.ai/models/gpt-image-2
• 快速入门指南：https://apidot.ai/docs/quickstart
• Webhook 文档：https://apidot.ai/docs/webhooks
• 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
• 通用示例代码库：https://github.com/APIDotAI/apidot-examples
• GitHub 组织主页：https://github.com/APIDotAI
• 技术支持邮箱：support@apidot.ai