APIDot Grok Imagine API

使用 APIDot 作为面向 Grok Imagine 的 API 接口层，支持 xAI 图像生成、图像编辑、文本转视频、图像转视频、轮询（polling）以及 Webhook 回调交付。

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

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

从 APIDot 入门

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

• 打开 Grok Imagine 模型页面：https://apidot.ai/models/grok-imagine
• 查阅 Grok Imagine API 文档：https://apidot.ai/docs/grok-imagine
• 打开账户控制台（API 密钥管理页）：https://apidot.ai/dashboard/api-key
• 参考通用 APIDot 示例：https://github.com/APIDotAI/apidot-examples

适用场景

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

• 基于 APIDot 构建 Grok Imagine API 集成。
• 通过 APIDot 使用 Grok Imagine 生成图像或视频。
• 在当前 APIDot 文档明确支持的前提下，使用仅含提示词（prompt-only）的生成方式，或单参考图引导（single-reference image guidance）方式。
• 在 Grok Imagine 图像工作流与视频工作流之间进行路由选择。
• 基于 APIDot 实现异步媒体任务，包括任务提交、任务状态轮询或 Webhook 回调。
• 查找 APIDot 上关于 Grok Imagine 的文档、模型页面或示例代码。

安全规范

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

Grok Imagine 工作流

APIDot Grok Imagine 的生成流程遵循统一的异步任务模式：

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

请勿猜测模型专属的请求载荷（payload）字段。若用户需要可直接复制使用的请求示例，请引导其查阅最新 APIDot 文档或通用 APIDot 示例。

模型路由

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

对于 Grok Imagine 的请求模式，请优先参考实时更新的 APIDot 模型页面与文档页面。除非 APIDot 文档明确指出某字段在其他图像或视频模型家族中同样适用，否则不得跨模型家族复用请求字段。

references/api.md 提供了一份本地化、非可执行的 Grok Imagine 模型路由、请求规划与异步工作流要点摘要。

集成建议

• 当用户需要覆盖多个模型家族的通用图像生成指导时，请使用 apidot-image-generation-api 技能。
• 当用户需要覆盖多个模型家族的通用视频生成指导时，请使用 apidot-video-generation-api 技能。
• 当用户明确表示需通过 APIDot 针对 Grok Imagine 进行开发时，请使用本技能。
• 在选择模型专属示例前，请先向用户确认其具体媒体任务类型：图像生成、图像编辑、文本转视频、图像转视频、产品概念图、营销创意图，或社交媒体短视频片段（social clip）。
• 请将 task_id、所选模型、用户 ID、源媒体引用、请求状态及最终媒体 URL 一并持久化存储。
• 在提交依赖参考图像的工作流前，请预先校验源图像 URL 的有效性。
• 请将 Webhook 处理器设计为幂等（idempotent）。重复的回调交付不应产生重复的可见结果。
• 对临时性网络错误应采用退避重试策略；但对无效载荷（invalid payload）不可不经修改直接重试。
• 避免在日志中记录 API 密钥、私有提示词（private prompts）、私有媒体 URL、生成的媒体 URL 或 Webhook 回调 URL。

官方链接

• 官网：https://apidot.ai
• 文档中心：https://apidot.ai/docs
• Grok Imagine 模型页面：https://apidot.ai/models/grok-imagine
• Grok Imagine 文档：https://apidot.ai/docs/grok-imagine
• Grok Imagine Video 1.5 文档：https://apidot.ai/docs/grok-imagine-video-1-5
• 快速入门指南：https://apidot.ai/docs/quickstart
• Webhook 文档：https://apidot.ai/docs/webhooks
• API 密钥控制台：https://apidot.ai/dashboard/api-key
• 主示例仓库：https://github.com/APIDotAI/apidot-examples
• GitHub 组织主页：https://github.com/APIDotAI
• 技术支持邮箱：support@apidot.ai