VALORXO 开发者文档
DEVELOPER GUIDE / QUICKSTART

开始调用 VALORXO API

一个 API 入口。使用你自己的密钥，连接模型与开发工具。

使用 Claude Code、桌面版或 Codex? 一键导入 CC Switch
01

确认地址与密钥

API 根地址模型请求使用此地址；用量查询位于 key.valorxo.com，文档位于 doc.valorxo.com。
https://api.valorxo.com
OpenAI 兼容 Base URLSDK 使用此地址，避免重复拼接 /v1。
https://api.valorxo.com/v1
API Key在管理控制台的“API 密钥”中创建，或由管理员提供。
sk-...
Key 是访问凭证，不是账户密码。请勿写入网页前端、公开仓库或分享截图。 https://api.valorxo.com https://api.valorxo.com/v1
02

当前支持的模型

平台模型目录，更新于 2026-10-06。具体可用模型由你的 API Key 权限决定，请使用 GET /v1/models 确认。

12 个模型
价格参考 · USD / 100 万 Tokens · 基础倍率 1×
模型 ID输入输出缓存写入缓存读取
claude-fable-5-1 max ×3$10.00$50.00写入 $12.50 · 1h $20.00$0.25
claude-fable-5 max ×3$10.00$50.00写入 $12.50 · 1h $20.00$1.00
claude-opus-5 $5.00$25.00写入 $6.25 · 1h $10.00$0.50
claude-opus-4-8 $5.00$25.00写入 $6.25 · 1h $10.00$0.50
claude-opus-4-7 $5.00$25.00写入 $6.25 · 1h $10.00$0.50
claude-opus-4-6 $5.00$25.00写入 $6.25 · 1h $10.00$0.50
claude-opus-4-5-20251101 $5.00$25.00写入 $6.25 · 1h $10.00$0.50
claude-opus-5-5 $4.00$20.00写入 $5.00 · 1h $8.00$0.20
claude-sonnet-4-6 $3.00$15.00写入 $3.75 · 1h $6.00$0.30
claude-sonnet-4-5-20250929 ≤200K $3.00
>200K $6.00		≤200K $15.00
>200K $22.50		≤200K 写入 $3.75 · 1h $6.00
>200K 写入 $7.50 · 1h $12.00		≤200K $0.30
>200K $0.60
claude-sonnet-5 $2.00$10.00写入 $2.50 · 1h $4.00$0.20
claude-haiku-4-5-20251001 $1.00$5.00写入 $1.25 · 1h $2.00$0.10

价格按当前平台配置列示，不代表所有 Key 的最终结算价。Max ×3 为特定模式标记，未乘入上表基础单价；长上下文分档、Key 所在分组倍率与最终扣费以管理控制台为准。

03

发起第一次请求

先获取此 Key 可访问的模型，再选用对应协议调用。本页仅预览，不读取 Key，也不会自动发送请求。

cURL · Bash
# 在本机终端输入 Key；不要把真实 Key 粘贴进文档
read -rsp "API Key: " VALORXO_API_KEY; echo
export VALORXO_API_KEY

curl https://api.valorxo.com/v1/models \
  -H "Authorization: Bearer $VALORXO_API_KEY"
04

发送模型请求

示例模型 · 权限以接口返回为准
POST /v1/messages

流程：先选协议 → 再选此 Key 可用模型 → 复制请求示例。当前目录均为 Claude 系列，默认使用 Anthropic Messages。Codex 可使用 OpenAI Responses 协议，由服务端进行协议转换；这不代表提供 GPT 系列模型，具体能力以 Key 权限为准。

05

接口与错误速查

用途请求路径鉴权
可用模型GET /v1/modelsBearer Key
用量与可用额度GET /v1/usageBearer Key
OpenAI ResponsesPOST /v1/responsesBearer Key
Anthropic MessagesPOST /v1/messagesx-api-key + anthropic-version

接口可用性以 Key 权限为准。/v1/usage 按 Key 配额、账户额度或订阅额度返回，不等同于逐笔调用日志。

401 / 403检查 Key 是否正确、是否过期，以及模型访问权限。
429触发限流或额度限制。检查额度后，按返回提示稍后重试。
5xx服务暂时异常。保留 Request ID 后重试或联系支持。