快速开始

这一页帮你跑通第一条请求。全程大约 3 分钟，不需要写代码也能验证成功。

三步走

① 拿一个 API Key   →   ② 查一下能用哪些模型   →   ③ 发一条请求

第 1 步：拿到 API Key

打开 https://api.wxiai.com/token 并登录。
点击「新建令牌」，其他都不用改，保存。
复制生成的 Key，它长这样：sk-xxxxxxxxxxxxxxxx。

这个 Key 等于你的账号密码，不要发到群里、不要提交到 GitHub、不要贴在截图里。泄露了就去上面那个页面把它删掉，重新建一个。

新注册的账号自带 0.01 测试额度，不用充值就能跑通下面的例子。

第 2 步：查一下你能用哪些模型

模型名字写错是新手最常见的报错来源。先查，再写。

bash

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

返回里 data 数组的每一项都有一个 id，那就是你可以直接用在 model 字段里的模型名：

json

{
  "object": "list",
  "data": [
    { "id": "grok-4.6", "object": "model", "owned_by": "xai" }
  ]
}

也可以直接在网页上看完整清单和价格：https://api.wxiai.com/models

第 3 步：发出第一条请求

把下面命令里的 你的API Key 换成第 1 步复制的 Key，整段粘贴到终端里回车：

bash

curl https://api.wxiai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的API Key" \
  -d '{
    "model": "grok-4.6",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

看到类似下面这样的返回，就说明通了：

json

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "grok-4.6",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "你好！我是 Grok……" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 12, "completion_tokens": 28, "total_tokens": 40 }
}

换成 Python

python

from openai import OpenAI

client = OpenAI(
    api_key="你的API Key",
    base_url="https://api.wxiai.com/v1",   # 只改这一行
)

resp = client.chat.completions.create(
    model="grok-4.6",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)

print(resp.choices[0].message.content)

只改 base_url，其余代码不用动。 这是 OpenAI 兼容接口最大的好处——你现有的代码、SDK、客户端，只要能把地址指向 https://api.wxiai.com/v1，就能直接用。

打开流式输出

想要打字机效果（一个字一个字往外蹦），加一个参数：

python

stream = client.chat.completions.create(
    model="grok-4.6",
    messages=[{"role": "user", "content": "写一首短诗"}],
    stream=True,
)

for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

报错了看这里

现象	原因	怎么办
`401` / `invalid_api_key`	Key 写错、复制漏字符、或 Key 已被删除	重新复制一遍；确认 `Bearer` 和 Key 之间有一个空格
`404`	地址写错	检查有没有漏掉 `/v1`，`/chat/completions` 是否拼对
`model_not_found`	模型名不存在或未对你开放	回到第 2 步，用 `GET /v1/models` 返回的名字，不要凭记忆写
`insufficient_quota`	额度用完	去 https://api.wxiai.com 充值
`429` / `too_many_requests`	触发限流或并发上限	降低频率重试；需要更高并发请联系客服或提交工单

更多错误码含义见错误码。

接下来

想知道 Key 怎么放才安全 → 认证方式
想接到 Cherry Studio、Chatbox 这类软件里 → 使用场景
想调图像、视频、语音 → API 文档

三步走 ​

第 1 步：拿到 API Key ​

第 2 步：查一下你能用哪些模型 ​

第 3 步：发出第一条请求 ​

换成 Python ​

打开流式输出 ​

报错了看这里 ​

接下来 ​

三步走