StdAPI 使用文档
统一入口 https://relvox.xyz/v1 · 115 个模型(文本 57 / 图片 22 / 视频 33 / 语音 3)· 人民币计价 · 按量付费
https://relvox.xyz/v1;② 密钥在「控制台 → API 密钥」创建,分组保持默认的「自动分组」;③ 用 model 参数选模型,一个 key 同时能对话、生图、生视频、合成语音。逐条可复制的调用示例(curl / Python / Node、每个模型的参数与价格)见 《一个 Key 调用全部模型》;Codex APP / CLI 的配置步骤见 《配置 Codex》。
一、快速开始
1. 注册账号
打开 relvox.xyz,用邮箱或用户名注册。注册后进入控制台。
2. 充值
「控制台 → 钱包 / 充值」,最低 ¥1。四种支付方式见第四章。付款成功后额度自动到账(实测 20 秒左右)。
3. 创建 API 密钥
- 「控制台 → API 密钥 → 新建密钥」。
- 分组保持默认的「自动分组」;模型限制留空表示全部模型可用;IP 限制按需填写。
- 保存后复制密钥,形如
sk-xxxxxxxxxxxxxxxx。
4. 第一次调用
curl -s https://relvox.xyz/v1/models -H "Authorization: Bearer $STDAPI_KEY"返回 {"object":"list","data":[{"id":"gpt-6-sol","object":"model"}, ...]},其中 id 就是调用时要填的 model。接着试一次对话:
curl https://relvox.xyz/v1/chat/completions \
-H "Authorization: Bearer $STDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"你好,介绍一下你自己"}]}'
二、分组与路由
分组不是「套餐」,而是「路由标签 + 权限范围」:它决定这个 key 能调到哪些模型、请求被路由到哪条上游渠道。全站价格只跟模型有关,与选哪个分组无关——所有分组的倍率都是同一个值,走「自动分组」和直选某个分组,单价完全一致。
推荐:自动分组
选「自动分组」后,系统按你请求里的 model 自动找到对应分组与渠道。对接多种模型的工具(Cline / Dify / LangChain / 自研应用)只需要一个 key,不用为「文本用哪个 key、生图用哪个 key」发愁。
分组类型
| 类型 | 分组 | 用途 |
|---|---|---|
| 通用 | 自动分组、标准 | 一个 key 调全品类;「标准」为通用主力分组 |
| 品类专用 | 生图、识图、Seedance、音频 | 图片生成、图片理解、视频生成、语音合成 |
| 厂商 / 档位 | Claude 标准/尊享/旗舰、Codex 标准/优选、GPT 旗舰、Gemini 标准/旗舰、DeepSeek 尊享/旗舰、Grok、kimi 标准/旗舰、MiniMax、Muse、千问、小米、智谱 标准/旗舰、混元 | 按厂商或价位段划分的路由标签,共 23 个可用分组 |
分组名单与说明以「新建密钥 → 分组」下拉为准;每个分组当前有哪些模型,看 relvox.xyz/pricing。
三、计费与额度
额度单位
账户余额以「额度」记账:¥1 = 500,000 额度。控制台里的金额全部按人民币显示,与充值金额一一对应(不涉及汇率换算)。
计价方式
| 能力 | 计费方式 | 举例 |
|---|---|---|
| 文本 / 多模态对话 | 按 token:输入、输出分别计价;命中上游缓存时输入按缓存折扣(通常 0.1~0.2 倍) | gpt-6-sol:输入 ¥0.47 / 百万 token,输出 ¥2.35 / 百万 token |
| 图片生成 | 按张,与尺寸/质量由模型自身决定 | gpt-image-2 约 ¥0.04 / 张;flux-3 约 ¥0.44 / 张 |
| 视频生成 | 按秒或按次,提交时按预估时长预扣,失败自动退款 | grok-video-3:6 秒约 ¥0.91,10 秒约 ¥1.52 |
| 语音合成 | 按音频时长折算 token(每秒约折 17 token,每分钟约折 1000) | 中文约 ¥0.12~0.63 / 千字,视模型而定 |
全部模型的单价见 模型清单 与 relvox.xyz/pricing。
查看消耗
「控制台 → 日志」可按时间、模型、密钥筛选每一次调用的 token 数与扣费;「控制台 → 钱包」看余额与充值记录。密钥可以设置额度上限,避免单个 key 被刷爆。
四、充值与到账
| 支付方式 | 通道 | 说明 |
|---|---|---|
| 支付宝 | 嘟噜支付 | 无额外服务费,推荐 |
| 微信 | 嘟噜支付 | 无额外服务费,推荐 |
| 支付宝(含 8% 服务费) | 易支付 | 通道手续费 8%,已计入支付金额 |
| 微信(含 8% 服务费) | 易支付 | 同上 |
步骤:「控制台 → 钱包 → 充值」→ 选金额(最低 ¥1)与支付方式 → 跳转支付页付款 → 额度自动到账,通常 1 分钟内。
五、API 调用
Base URL 与鉴权
| 项目 | 值 |
|---|---|
| Base URL | https://relvox.xyz/v1 |
| 鉴权 | Authorization: Bearer sk-xxxx(Anthropic 原生协议用 x-api-key: sk-xxxx) |
| 协议 | OpenAI 兼容(chat/completions、responses、images、videos、audio);另支持 Anthropic 原生 Messages |
支持的接口
| 能力 | 接口 | 说明 |
|---|---|---|
| 文本对话 | POST /v1/chat/completions | 支持 stream: true 流式输出 |
| 响应式接口 | POST /v1/responses | Codex / OpenAI Agents SDK |
| Claude 原生 | POST /v1/messages | Anthropic Messages 协议 |
| 图片生成 | POST /v1/images/generations | 返回图片直链 URL |
| 视频生成 | POST /v1/videos + GET /v1/videos/{id} | 异步任务,先提交再轮询 |
| 语音合成 | POST /v1/audio/speech | 返回 mp3 / wav 音频流 |
| 模型列表 | GET /v1/models | 返回当前密钥可用模型 |
Python(openai 官方 SDK)
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://relvox.xyz/v1",
)
resp = client.chat.completions.create(
model="gpt-6-sol",
messages=[{"role": "user", "content": "你好,介绍一下你自己"}],
)
print(resp.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的密钥",
baseURL: "https://relvox.xyz/v1",
});
const r = await client.chat.completions.create({
model: "gpt-6-sol",
messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);
第三方客户端
| 客户端 | 填法 |
|---|---|
| Cursor / Windsurf / Cline / Continue / Cherry Studio / ChatBox | 选「OpenAI 兼容」自定义地址,Base URL 填 https://relvox.xyz/v1,密钥填 sk- 开头的值 |
| Dify / FastGPT / LangChain / LlamaIndex / n8n | 同上,作为 OpenAI 兼容模型供应商接入 |
| Claude Code | 环境变量 ANTHROPIC_BASE_URL=https://relvox.xyz + ANTHROPIC_AUTH_TOKEN=sk-...(走原生 /v1/messages) |
| Codex APP / CLI | wire_api = "responses",配置步骤见 配置 Codex;也可用 一键脚本 |
| new-api / one-api 站点 | 作为「OpenAI 类型」渠道对接,填 Base URL 与本密钥 |
六、能力入口
七、视频与异步任务
视频是异步任务:POST /v1/videos 提交后拿到 task_id,再 GET /v1/videos/{task_id} 轮询(建议间隔 5~10 秒,最多等 10 分钟)。提交时按预估时长预扣额度,任务失败自动退款;成片地址在 metadata.url,通常 24 小时内有效,请及时转存。
提交参数(model、prompt、duration、ratio、resolution、images、mode、generate_audio)与各模型支持范围见 视频生成。
八、常见错误速查
| 现象 | 原因与处理 |
|---|---|
401 Invalid token / 未提供令牌 | 密钥错误、被删除或已过期。重新复制密钥,注意别带空格与引号。 |
403 无权限 | 该 key 的分组里没有这个模型,或模型白名单把它排除了。改用「自动分组」并把模型限制留空。 |
404 model not found / This token has no access to model | 模型名拼错(要用 /v1/models 里的 id),或 key 无权访问该模型。 |
429 Too Many Requests | 触发频率限制。降低并发、加大间隔;批量任务串行并在请求间 sleep 1~2 秒。 |
500 上游报错 / convert_request_failed | 上游瞬时故障或协议转换失败。稍等重试;换同族模型可临时绕开。 |
502 / 504 | 上游超时。缩短 prompt、降低 max_tokens,或换更快的模型。 |
503 当前分组上游负载已饱和 / No available channel | 该模型当前没有可用渠道。等几十秒重试;持续出现请反馈我们补渠道。 |
视频任务 failed | 看 error.message:多为 prompt 触发内容审核、参考图链接不可公网访问、时长/比例/分辨率超出该模型支持范围。失败不扣费。 |
语音合成 400 invalid voice | 音色名与模型不匹配,各模型音色互不通用(gpt 用 alloy 等,gemini 用 Kore 等,豆包用它自己的 id)。 |
九、使用条款
- 本服务仅提供 AI 模型 API 的转发与计费,模型输出由上游提供,请自行评估内容准确性并承担使用后果。
- 禁止用于违法违规用途:包括但不限于生成违法信息、侵犯他人权益、批量注册/爬取、绕过上游风控、攻击或压测本服务。
- 密钥安全由账户持有人负责。因密钥泄露、共享、写进前端代码导致的损失不予补偿;发现异常请立即删除密钥并联系我们。
- 充值额度仅用于 API 调用,不支持提现或转赠。任务失败、上游报错等未产生实际消耗的请求会自动退还额度。
- 服务按「尽力而为」提供,我们会持续扩容与排障,但不对特定可用性(SLA)作出承诺;因上游政策调整导致个别模型下线属正常情况,会尽量提前公告。
- 调用日志会保留用于计费核对与故障排查;我们不会将你的请求内容用于训练或对外提供。
十、联系与支持
反馈问题时请附上:调用时间 + 模型名 + 完整报错(含 request id),能大幅加快定位。渠道:主站右下角在线客服,或在用户群内 @ 管理员。
相关文档:一个 Key 调用全部模型 · 配置 Codex · Codex 一键配置脚本 · 价格页
StdAPI 使用文档