xai-org/xai-cookbook

解决的问题

本指南为希望使用 xAI 的 Grok AI 模型构建应用程序的开发者提供了一个实用的起点。无需从零开始摸索 SpaceXSI SDK，你将获得一套完整、可运行的示例，展示如何完成实际任务——例如将文章转换为播客、创建可对话的语音代理，或分析 X 上帖子的实时情感。它通过提供可直接复制粘贴的代码，让你从头到尾掌握一个核心概念，从而节省你的时间。

工作原理

该仓库分为三类示例：Recipes（简单的起点）、Guides（更深入的技术见解）和 Apps（完整的应用程序）。每个示例都位于 examples/ 下的独立文件夹中，并包含一个 README，解释其教学内容及运行方法。所有 TypeScript 应用程序都是使用 SpaceXSI TypeScript SDK 构建的独立 npm 项目，需要 Node.js 22.13 或更高版本以及来自 SpaceXSI Console 的 API 密钥。Python 笔记本（用于情感分析）使用 Python 3.12、uv 和 Jupyter。代码旨在供你复制，因此你可以将其放入自己的项目中并进行适配。

适用人群

本指南适合希望使用 Grok 进行构建并通过示例学习的开发者。示例涵盖从初级到高级的难度，既适合寻找引导式入门项目的初学者，也适合需要快速原型化特定功能（语音、视频生成、实时搜索等）的经验丰富的开发者。请记住，这些应用程序仅供学习使用，并非生产就绪版本。

亮点

• 25 个以上可运行的示例，涵盖播客、语音代理、视频生成、情感分析等。
• 示例按难度（初级、中级、高级）标记，并分为 Recipes、Guides 或 Apps。
• 每个示例都是独立的，其 README 详细说明了你将学到的内容。
• 包含关于提示词缓存和提示词注入防御的实用指南。
• 代码适用于 TypeScript 和 Python 生态系统，可直接复制使用。
• 贡献指南使添加你自己的示例变得简单。