Relyven API 快速开始

这份指南依次验证 Base URL、API Key、模型权限和一次真实请求。请按客户端使用的协议选择示例。

第一步：创建 API Key

登录控制台，打开 API 密钥 并创建 Key。请放进环境变量，不要提交到代码仓库。详细规则见 账户与 API Key。

第二步：选择协议

客户端	Base URL	主要端点
OpenAI 兼容 SDK、Codex、Cline	https://api.relyven.com/v1	/responses 或 /chat/completions
Claude Code、Anthropic SDK	https://api.relyven.com	/v1/messages

第三步：验证鉴权与模型

curl https://api.relyven.com/v1/models \
  -H "Authorization: Bearer $RELYVEN_API_KEY"

返回 200 代表 Base URL 和 Key 正确；401 代表 Key 或请求头错误。模型不在列表中，通常表示当前 Key 没有权限或模型暂不可用。

第四步：发起请求

OpenAI Responses

curl https://api.relyven.com/v1/responses \
  -H "Authorization: Bearer $RELYVEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":"只回复 OK。"}'

模型名必须从控制台复制，不要猜别名。

Anthropic Messages

curl https://api.relyven.com/v1/messages \
  -H "x-api-key: $RELYVEN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"YOUR_CLAUDE_MODEL_ID",
    "max_tokens":256,
    "messages":[{"role":"user","content":"只回复 OK。"}]
  }'

Messages 请求必须包含 max_tokens。模型名应来自当前 Key 的鉴权模型列表。

下一步

• 使用 CC Switch：CC Switch 接入
• 直连 Claude Code：第三方 API 配置
• 直连 Codex：自定义服务商配置
• 排查失败：错误处理