SuperAPI AI 工具集

xai-grok

智能体与模型

查看项目

更新于 10-15 19:55

技能介绍

用途:该技能用于与 xAI Grok API 交互,这是一个兼容 OpenAI 的接口服务,面向快速 AI 推理任务,可调用 grok-3 与 grok-3-mini 等模型,用于文本生成、推理等场景。

主要能力:通过 api.x.ai/v1 提供聊天补全、嵌入与模型流式输出等端点;grok-3 适用于通用推理,grok-3-mini 适用于轻量高速任务;请求使用 JSON 负载,支持 temperature(0.0-2.0)、max tokens(最高 4096)与停止序列等参数;返回结构与 OpenAI 类似,含 choices 与用量统计。

使用方式:将密钥设为环境变量,如 export XAI_API_KEY=your_key,然后向 api.x.ai/v1 发起请求。聊天补全端点为 POST https://api.x.ai/v1/chat/completions,请求头需 Authorization: Bearer $XAI_API_KEY 与 Content-Type: application/json;模型信息端点为 GET https://api.x.ai/v1/models。示例命令:curl -X POST -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" -d '{"model":"grok-3","messages":[{"role":"user","content":"Summarize this text"}]}' https://api.x.ai/v1/chat/completions。

适用场景:需要快速推理的应用,如聊天机器人、代码生成、数据分析,以及已有 OpenAI 兼容工具链、希望复用现有集成的场景。集成时不要硬编码密钥,建议使用密钥管理工具;可检查响应头中的 X-RateLimit-Remaining。

限制与错误处理:密钥无效返回 401,需核对 $XAI_API_KEY;触发限流返回 429,建议指数退避重试,例如等待 5 秒后重试;如遇 context_length_exceeded 需截断输入。代码中应加入 try-except 与错误检查,发送前校验 messages 数组非空。

其他:所属集群为 ai-apis,标签为 ai-apis、xai。具体价格、可用区域等信息暂未提供。