快速开始
准备一把 Key，选好模型，拿到第一条回复。
如果你使用客户端，可以直接打开 Claude Code、Codex CLI 或 Cursor 教程。下面使用终端完成一次 API 调用。
第 1 步 · 创建 API Key
打开 控制台 → API Keys，创建一把用于测试的 Key。保存完整密钥，接下来的 YOUR_API_KEY 都替换为它。
第 2 步 · 配置终端环境
选择你当前使用的终端。这些变量只作用于当前终端窗口。
export UOUO_API_KEY="YOUR_API_KEY"
export UOUO_BASE_URL="https://uouo.cloud/v1"第 3 步 · 选择可用模型
先查看 Models 中模型的交付等级与接口说明，再使用当前 Key 查询模型 ID。
curl "$UOUO_BASE_URL/models" -H "Authorization: Bearer $UOUO_API_KEY"从返回的 data 中复制一个支持 Chat Completions 的模型 id，替换下一步的 YOUR_MODEL_ID。列表中的展示名称不能代替请求 ID。
第 4 步 · 发送第一条消息
这次测试会按所选模型与档位计费。发送一条简短消息即可。
curl "$UOUO_BASE_URL/chat/completions" \
-H "Authorization: Bearer $UOUO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Hello"}]}'第 5 步 · 确认调用成功
成功的 Chat Completions 响应包含 choices，回复位于 choices[0].message.content。下面是结构示意，实际回复文字会不同。
{
"choices": [{ "message": { "role": "assistant", "content": "Hello!" } }]
}没有成功时，先看这里
| 现象 | 下一步 |
|---|---|
| 401 / Invalid API key | 检查密钥是否完整、有效，当前终端变量是否已设置。 |
| 403 / 模型不可用 | 核对 Key 的模型权限与所选 Tier，再查看错误信息。 |
| 404 / Model not found | 区分接口路径不存在与模型不存在，检查 Base URL 和精确模型 ID。 |
| 429 | 阅读错误体，区分速率、额度或上游容量问题，避免连续重试。 |
详细处理方式见 排错指南。
下一步
- 使用 OpenAI Python 或 Node.js 接入应用。
- Claude 原生消息格式请使用 Messages API 或 Anthropic Python。
- 为生产环境设置 预算与限额。