StdAPIStdAPI 使用文档一个 Key 调全部模型配置 Codex返回主站 →

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 密钥

  1. 「控制台 → API 密钥 → 新建密钥」。
  2. 分组保持默认的「自动分组」;模型限制留空表示全部模型可用;IP 限制按需填写。
  3. 保存后复制密钥,形如 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。

一个 key 固定在一个分组;需要跨分组(例如既要 Claude 旗舰又要便宜模型)时选「自动分组」,或再建一个 key。密钥也支持「跨分组重试」,由控制台按需开启。

三、计费与额度

额度单位

账户余额以「额度」记账:¥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 分钟内。

付款成功但超过 10 分钟未到账:请在「钱包 → 充值记录」确认订单状态,并带上订单号联系客服人工补单。充值额度仅用于 API 调用,不支持提现。

五、API 调用

Base URL 与鉴权

项目值
Base URLhttps://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/responsesCodex / OpenAI Agents SDK
Claude 原生POST /v1/messagesAnthropic 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 / CLIwire_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)。

九、使用条款

十、联系与支持

反馈问题时请附上:调用时间 + 模型名 + 完整报错(含 request id),能大幅加快定位。渠道:主站右下角在线客服,或在用户群内 @ 管理员。

相关文档:一个 Key 调用全部模型 · 配置 Codex · Codex 一键配置脚本 · 价格页