​

XAI (Grok) 简介

欢迎使用 XAI 服务文档！ 本服务集成了 xAI 的 Grok 模型，用于 AI 驱动的图像和视频生成。使用 grok-imagine-image 和 grok-imagine-video，您可以通过文本提示创建精美的视觉内容，或使用参考图片引导生成。

​

功能特性

XAI Grok 提供以下生成能力：

• 文生图：使用 grok-imagine-image 模型从文本提示生成高质量图像，支持自定义宽高比。
• 图生图：提供参考图片和提示词来编辑或变换图像 — 输出尺寸跟随参考图片。
• 文生视频：使用 grok-imagine-video 模型从文本提示生成视频，可控制时长（6秒/10秒/15秒）、宽高比和分辨率。
• 图生视频：使用参考图片引导视频生成 — 提供参考图片时，宽高比和分辨率将自动跟随参考图片。
• 异步任务系统：所有生成请求都会返回一个 taskId。轮询任务端点可获取状态和结果。

​

如何使用 XAI

1. 创建生成任务：调用图像或视频生成端点，传入提示词和参数。
2. 获取任务 ID：响应中返回用于跟踪的 taskId。
3. 轮询任务状态：使用任务结果端点（GET /xai/tasks）检查进度。
4. 下载结果：任务状态变为 completed 后，结果中包含您生成的内容。

​

可用端点

​

图像生成

​

视频生成

​

任务管理

---

​

浏览 API 文档

图像：

• 生成图像 — 使用 Grok 创建或编辑图像

视频：

• 生成视频 — 从文本或图片创建视频

任务：

• 获取任务结果 — 检查任务状态并下载结果

---

​

关键参数

​

图像生成

​

视频生成

​

任务状态值

​

最佳实践

1. 编写清晰的提示词：具体而详细的描述可获得更准确的结果。
2. 使用参考图片：如有可用的参考图片，可提供它以更精确地控制风格和构图。
3. 选择合适的设置：根据使用场景选择合适的宽高比、时长和分辨率。
4. 实现轮询机制：轮询任务状态时使用指数退避策略以避免频率限制。
5. 优雅地处理错误：检查 failed 和 timeout 状态，使用 errorMessage / errorCode 进行诊断。