快速开始

创建 WOX API Key，并通过兼容接口完成第一个模型请求

1. 创建 API Key

登录 WOX 后，前往 API Key 页面 创建密钥。密钥通常只在创建或主动查看时完整显示，请妥善保存。

建议通过环境变量使用密钥：

export WOX_API_KEY="YOUR_API_KEY"

2. 选择模型

前往 模型与价格页面，复制当前可用模型的模型 ID。文档中的 YOUR_MODEL_ID 只是占位符，不代表真实模型。

3. 发送请求

curl https://api.wox.lol/v1/chat/completions \
  -H "Authorization: Bearer $WOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "请用一句话介绍你自己。"
      }
    ]
  }'

请求成功后会返回 JSON 响应。流式响应、工具调用、图片、音频及其他能力是否可用，取决于具体模型和接口。

4. 常见检查

请求失败时，依次确认：

• Base URL 为可用 WOX 线路，并包含正确的 /v1 路径
• Authorization 使用 Bearer 加实际 API Key
• 模型 ID 来自当前模型列表
• API Key 未过期，且模型、分组、IP 和额度限制允许本次请求
• 账户具有可用的钱包余额或订阅额度

接口返回 429 时，应限制重试次数；响应包含 Retry-After 时按其等待，否则采用指数退避。

5. 下一步

• 查看 API Reference
• 了解 Token Plan 与计费偏好
• 根据左侧导航配置常用客户端
• 在 使用日志 中核对请求和消耗