平台与模型

你们提供哪些模型？

目前只提供 xAI Grok 官方系列，包括对话、图像、视频、语音和实时语音能力。

完整清单和实时价格看 https://api.wxiai.com/models。

有 embedding（文本向量）模型吗？

没有。 Grok 官方不提供 embedding 能力，所以我们也没有。做 RAG 或向量检索的话需要另找向量模型。

是 OpenAI 兼容的吗？

文本接口是，而且完全兼容——OpenAI 官方 SDK 改一个 base_url 就能用。

但图像、视频、音频不完全一样：它们除了 OpenAI 兼容写法，还支持 Grok 原生写法。区别见 调用方式。

我能用 Claude Code / Cursor 这些工具吗？

能，各自配置方式不同，见 使用场景。

⚠️ 但每个工具的 Base URL 填法不一样，有的要带 /v1 有的不要。填之前先看 Base URL 怎么填。

接入与排错

我该填哪个地址？

看 Base URL 怎么填 —— 这页就是为了解决这个问题写的，里面各工具对照表。

一句话：只有域名和 /v1 的组合问题，填错了会报 404。

模型名写什么？

以 GET /v1/models 的返回为准，不要凭记忆写。

curl https://api.wxiai.com/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

模型会上下线和改名，写死的名字迟早会失效。

为什么报 401？

按顺序查三个地方：

1. Authorization: Bearer sk-xxx 格式对不对（Bearer 后一个空格）
2. Key 是不是复制时漏了字符，或者已经被删了
3. 如果经过自己的 Nginx / 网关，确认没有丢掉 Authorization 头

详见 认证方式。

为什么报 404？

九成是 Base URL 拼错了，比如多填了 /v1 变成 /v1/v1/...。

对照 Base URL 怎么填 里的报错表改。

图像和视频为什么不一样？

因为图像是同步的（发完等结果），视频是异步的（要先拿 task_id 再轮询）。

写视频代码时最容易犯的错就是按同步接口的写法去调，结果永远拿不到结果。见 视频生成。

任务失败了，额度退吗？

退。 视频任务失败或超时（600 秒）会自动退还本次额度，不需要手动申请。

一直转圈没有输出？

先看是不是流式被中断了：

• 检查网络或公司代理是否在做缓冲
• 换非流式（stream: false）试一次，能通就是流式链路的问题

报 429 怎么办？

两种可能：

• 请求太频繁 → 加指数退避重试
• 并发超限 → 见下面「并发不够用」

账号与计费

有免费额度吗？

有。注册即送 0.01 测试额度，不充值就能跑通第一次调用。

怎么充值？支持哪些方式？

微信 / 支付宝 / Stripe 国际信用卡 / USDT。

能开发票吗？能对公吗？

能，但单笔满 500 元起开。

充错了能退款吗？

充值后 5 天内可申请退款。

并发不够用怎么办？

默认并发有限制。需要提升请联系客服，或在 API 站的工单系统提交申请。

怎么知道花了多少钱？

每次响应的 usage 字段里有 token 用量，可以自己核算。消费记录在 https://api.wxiai.com 查看。

安全

可以把 Key 放在网页前端吗？

不行。 浏览器里的代码用户能直接看到，也能在网络面板看到请求头。任何写在前端 JS 里的 Key 都等于公开。

正确做法：前端调你自己的后端，你的后端拿 Key 调我们。

Key 泄露了怎么办？

1. 立刻到 https://api.wxiai.com/token 把那一把删除（不是改名）
2. 新建一把替换
3. 检查账单有没有异常调用

你们会记录我的对话内容吗？

涉及数据处理方式的问题，请以 隐私政策 和服务条款为准。如果是敏感业务，建议先走内部合规评审。

还是没解决？

• 报错排查：错误码
• 接口用法：API 文档
• 工具配置：使用场景
• 都不行：带上响应的 request_id 联系客服或提交工单，有这个 ID 才能定位到具体那一次调用