开发者文档

从这些内容开始

搜索标题与正文↑ ↓ 选择 · Enter 打开 · Esc 关闭

认证与 Base URL

确认客户端需要的地址格式,并使用 UOUO API Key 完成认证。

选择正确的地址

使用方式填写的地址最终请求路径
OpenAI SDK / OpenAI-compatible Base URLhttps://uouo.cloud/v1/v1/chat/completions/v1/responses
Claude Code / Anthropic SDK Base URLhttps://uouo.cloud/v1/messages
直接 REST 请求完整接口 URL例如 https://uouo.cloud/v1/messages
text
https://uouo.cloud/v1

创建并保存密钥

前往 API Keys 创建 Key,保存在服务端环境变量或密钥管理器中。客户端使用 UOUO Key,不使用控制台登录 Cookie。

发送认证头

直接请求时使用 Bearer 认证:

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Claude Code 使用 ANTHROPIC_AUTH_TOKEN;Anthropic SDK 示例通过 auth_token / authToken 发送同样的 Bearer 认证。

验证认证

快速开始 设置环境变量并请求 /v1/models。收到模型列表表示认证请求已通过;具体模型能否调用,还取决于模型权限、协议和档位可用性。

常见问题

  • 401:检查密钥前后空格、有效期和停用状态。
  • 404:检查是否遗漏或重复了 /v1
  • 列表正常但调用失败:核对精确模型 ID、接口格式及 Models & Tiers
  • 切换终端后失效:临时环境变量不会自动传到新的窗口,需要重新设置。
认证与 Base URL · uouo cloud