API 指引

模型列表

返回你这把 API Key 当前可以调用的模型。写代码时用它动态获取模型名，不要凭记忆硬编码。

GET/v1/models

最重要的用途：别把模型名写死

模型会上下线、改名、出快照版本。写死在代码里的模型名迟早会失效，然后你会在某天收到一堆 model_not_found。

推荐做法：程序启动时拉一次，或第一次用到时拉一次。

client = OpenAI(api_key=..., base_url="https://api.wxiai.com/v1")

# 启动时拉一次，缓存在内存里
available = {m.id for m in client.models.list().data}

def ask(prompt: str, model: str = "grok-4.6"):
    if model not in available:
        raise ValueError(f"模型 {model} 当前不可用，可用：{sorted(available)}")
    ...

返回的是「你这把 Key 能用的模型」

不是全站模型清单。 列表会按下面的规则过滤：

规则	说明
所属分组	只返回你这把 Key 所属分组下开放的模型
Key 白名单	如果这把 Key 单独设置了可用模型，只返回白名单里的

所以：

你拿到的列表和别人不一样是正常的。 如果某个模型文档里写了但你没看到，多半是分组权限或 Key 白名单的问题——用接口返回的为准。

官方明确的几条能力边界

这些是 Grok 模型侧的硬限制，跟哪把 Key 无关，写代码前先知道能省很多调试时间：

边界	内容
实时信息	模型不联网就没有实时信息。要拿最新数据必须挂服务端搜索工具，见响应生成
角色顺序	没有顺序限制。system、user、assistant 可以按任意顺序混排
图片输入大小	单张最大 20 MiB
图片输入数量	没有数量上限
图片格式	只支持 jpg / jpeg / png
logprobs / top_logprobs	grok-4.20 及更新的模型不支持，传了会被静默忽略（不报错，但也没结果）

用哪个模型

文本类任务统一用 grok-4.6。 上下文长度、价格、以及当前开放的全部模型型号，看模型页：

→ https://api.wxiai.com/models

出图、出视频、语音各自有专用模型，见 图像生成 / 视频生成 / 实时会话。

为什么不返回价格和上下文长度

这个接口只回 模型的标识信息（id / object / created / owned_by 等），不含价格、上下文长度、是否支持推理等信息。

xAI 官方的 /v1/models 会带 context_length 和一组价格字段，我们这里没有——本网关的模型列表按上面的简化结构返回。

需要这些信息看 → https://api.wxiai.com/models

你要什么	从哪拿
模型名（填进 model 字段的值）	本接口
价格、上下文长度、能力说明	模型列表页
模型命名规律	模型列表（使用指南）

Authorizations

Authorizationstringheader default: Bearer YOUR_API_KEY必填

使用 Bearer Token 进行身份验证。

响应对象

objectstring服务端

固定为 list。

successboolean服务端

固定为 true。

dataarray<object>服务端

当前 Key 可调用的模型集合。可能为空数组——那说明这把 Key 没有任何可用模型，检查分组和 Key 白名单。

data[].idstring服务端

模型标识。这就是你要填进请求体 model 字段的值。

示例grok-4.6

data[].objectstring服务端

固定为 model。

data[].createdinteger服务端

条目创建时间（Unix 秒）。内置模型用固定占位时间，不要拿它判断模型新旧。

data[].owned_bystring服务端

来源标识。内置渠道的模型是渠道名（如 xai）；后台按分组自定义添加的模型是 custom。**不要用它判断模型能力**。

data[].rootstring服务端

该条目的原始模型名，通常与 id 相同。

data[].parentstring | null服务端

父模型名，一般为 null。

data[].permissionarray<object>服务端

OpenAI 旧版权限结构，为兼容保留。日常使用忽略即可。

排查：模型用不了怎么办

按这个顺序查：

1. 这个模型在接口返回里吗？

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

• 不在 → 这把 Key 没有该模型权限。检查 Key 的可用模型设置，或联系客服确认分组。
• 在 → 继续第 2 步。

2. 请求里的模型名和返回的完全一致吗？

模型名区分大小写，多一个空格、少一个字符都会报 model_not_found。直接复制粘贴，不要手打。

3. 看错误码

错误码	含义
model_not_found	模型名不对，或没有权限
permission_denied	模型不在你的分组范围内
insufficient_quota	模型是对的，但额度不够

详见 错误码。

相关页

• 模型列表（使用指南） —— Grok 命名规律与选型
• 对话补全 —— 拿到模型名之后怎么调
• 错误码