一个 Key 调用全部模型
一个地址 https://relvox.xyz/v1 · 一把密钥 · 覆盖 115 个模型(文本 57 / 图片 22 / 视频 33 / 语音 3)· 人民币计价 · 按量付费
https://relvox.xyz/v1;② 密钥在「控制台 → API 密钥」里创建;③ 新建密钥时分组选「自动分组」(这是默认值,不用改)。之后同一个 key 既能聊天,也能生图、生视频。分组不是「套餐」,而是「路由标签」。选「自动分组」后,系统按你请求的 model 自动找到对应渠道,价格与直接选具体分组完全一致(全站同一倍率)。
能力一览
| 能力 | 接口 | 说明 |
|---|---|---|
| 文本对话 | POST /v1/chat/completions | OpenAI 兼容协议,支持 stream: true 流式输出 |
| 响应式接口 | POST /v1/responses | Codex / OpenAI Agents SDK 使用,wire_api = "responses" |
| Claude 原生 | POST /v1/messages | Anthropic Messages 协议,Header 用 x-api-key |
| 图片生成 | POST /v1/images/generations | 返回图片直链 URL(非 base64) |
| 视频生成 | POST /v1/videos + GET /v1/videos/{id} | 异步任务:先提交,再轮询 |
| 语音合成 | POST /v1/audio/speech | 文本转语音,返回 mp3 / wav 音频流 |
| 模型列表 | GET /v1/models | 返回当前密钥可用的全部模型 |
第一步 · 创建密钥
- 登录 relvox.xyz,打开「控制台 → API 密钥」。
- 点「新建密钥」。分组保持默认的「自动分组」,其它选项不用动(模型限制留空 = 全部模型可用)。
- 保存后复制密钥,形如
sk-xxxxxxxx...。
第二步 · 验证密钥
把下面命令里的密钥替换成你自己的,执行后应当返回一个包含 115 个模型的 JSON:
curl -s https://relvox.xyz/v1/models -H "Authorization: Bearer $STDAPI_KEY"默认返回结构为 {"object":"list","data":[{"id":"gpt-6-sol","object":"model"}, ...]},id 字段就是调用时要填的 model。
文本对话
curl
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":"你好,介绍一下你自己"}]}'
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)
同理,langchain、llama-index、dify、new-api、one-api 这类支持「自定义 OpenAI 兼容地址」的客户端,填 https://relvox.xyz/v1 和密钥即可。
常用模型
| 场景 | 推荐模型 | 输入 ¥/百万 token | 输出 ¥/百万 token |
|---|---|---|---|
| 日常对话 / 批量处理 | gpt-6-sol | 0.47 | 2.35 |
| 中文长文 / 便宜大碗 | gemini-3-flash | 0.56 | 3.34 |
| 极速轻量 | qwen3.7-flash | 0.21 | 0.84 |
| 旗舰推理 | claude-opus-4-6 | 6.37 | 31.87 |
| 旗舰通用 / 长上下文 | gemini-3.1-pro | 13.63 | 81.80 |
| 编程 / Agent | gpt-5.3-codex | 13.01 | 104.09 |
完整价目见下文模型清单,或打开 relvox.xyz/pricing。
Responses(Codex / Agent)
Codex、OpenAI Agents SDK 走的是 Responses 协议,不是 chat/completions。地址同样是 https://relvox.xyz/v1,Codex 的 config.toml 里写 wire_api = "responses"。
curl https://relvox.xyz/v1/responses \
-H "Authorization: Bearer $STDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6.1-sol","input":"用一句话解释什么是向量数据库"}'
推荐模型:gpt-6.1-sol、gpt-5.6-sol、gpt-5.3-codex、codex-auto-review。Codex 的完整配置流程见 配置 Codex APP。
Claude 原生 Messages
支持 Anthropic 原生协议,密钥放在 x-api-key,并带上 anthropic-version。
curl https://relvox.xyz/v1/messages \
-H "x-api-key: $STDAPI_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-opus-4-6","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'
Anthropic 官方 Python / JS SDK 只需把 base_url 改成 https://relvox.xyz(SDK 会自己拼 /v1/messages),密钥照常传。
图片生成
curl https://relvox.xyz/v1/images/generations \
-H "Authorization: Bearer $STDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"一只戴墨镜的柴犬,赛博朋克霓虹背景","size":"1024x1024"}'
返回结构为 {"created":..., "data":[{"url":"https://.../xxx.png"}]},url 是可直接访问的图片地址(不是 base64)。如需原图,把 URL 下载下来即可。
常用图片模型:gpt-image-2(0.04 元/张)、gemini-3.1-flash-lite-image(0.05 元/张)、gpt-image-2.5-sunburst(0.04 元/张)、flux-3(0.44 元/张)。
Python 用 openai SDK 的 client.images.generate(model=..., prompt=...) 同样可用。
视频生成
视频是异步任务:先提交拿 task_id,再轮询结果。提交成功会按预估时长预扣额度,任务失败会自动退款。
1. 提交任务
curl https://relvox.xyz/v1/videos \
-H "Authorization: Bearer $STDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"grok-video-3","prompt":"海边日落,镜头缓慢推近","duration":6,"ratio":"16:9"}'
返回:{"task_id":"202610301234567890","status":"queued"}
2. 轮询结果
curl https://relvox.xyz/v1/videos/202610301234567890 -H "Authorization: Bearer $STDAPI_KEY"
返回 OpenAI 视频对象,关键字段:
{
"id": "202610301234567890",
"object": "video",
"model": "grok-video-3",
"status": "completed",
"progress": 100,
"metadata": { "url": "https://.../result.mp4" }
}
status 取值:queued → in_progress → completed(或 failed,此时 error.message 给出原因)。成片地址在 metadata.url;也可以直接用 GET /v1/videos/{task_id}/content 下载。
3. 提交参数
| 字段 | 说明 |
|---|---|
model | 必填,模型名见下文视频清单 |
prompt | 必填,画面描述 |
duration / seconds | 时长(秒)。填不支持的值会自动夹到最近的合法档位 |
ratio / size | 画面比例:16:9、9:16、1:1 等(按模型支持) |
resolution | 分辨率:720p、1080p(按模型支持) |
images | 参考图 / 首帧,公网可访问的 URL 数组(多为最多 7 张) |
mode | text-to-video(文生视频)、first-frame(首帧)、reference(参考图) |
generate_audio | 是否生成音轨(按模型支持) |
语音合成(TTS)
文本转语音走 OpenAI 兼容接口 POST /v1/audio/speech,直接返回音频二进制(mp3 / wav)。voice 必填,且各模型的音色名互不通用——换模型要同时换音色。
curl
curl https://relvox.xyz/v1/audio/speech \
-H "Authorization: Bearer $STDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-4o-mini-tts","input":"你好,欢迎使用 StdAPI 语音合成。","voice":"alloy","response_format":"mp3"}' \
--output hello.mp3
返回的是音频本体(Content-Type: audio/mpeg),所以用 --output 存成文件,不要当 JSON 解析。
Python(openai 官方 SDK)
from openai import OpenAI
client = OpenAI(api_key="sk-你的密钥", base_url="https://relvox.xyz/v1")
speech = client.audio.speech.create(
model="doubao-tts-2.0",
voice="zh_female_vv_uranus_bigtts", # 豆包音色 id
input="这段文字会被合成语音。",
response_format="mp3",
)
speech.stream_to_file("out.mp3")
可用模型与音色
| 模型 | 音色 voice | 特点 | 价格 |
|---|---|---|---|
gpt-4o-mini-tts | alloy echo fable onyx nova shimmer | 最快(1.5~10 秒),中英双语,短句极便宜 | 约 0.12 元/千字;14 字短句约 0.002 元 |
gemini-3.1-flash-tts | Kore Zephyr Puck Charon Fenrir Leda Orus Aoede 等 30 个 | 多语种自然,支持 instructions 控制语气 | 约 0.62 元/千字;短句约 0.01 元 |
doubao-tts-2.0 | 豆包 475 个预置音色 id,如 zh_female_vv_uranus_bigtts | 中文最自然,可带情感;延迟 6~32 秒 | 约 0.63 元/千字 |
参数
| 字段 | 说明 |
|---|---|
model | 必填,三选一(见上表) |
input | 必填,要合成的文本;gpt-4o-mini-tts 单次约 2100 字以内,长文请分段 |
voice | 必填,音色名,必须属于该模型(见上表) |
response_format | mp3 / wav 等;gpt-4o-mini-tts 支持 mp3/opus/aac/flac/wav/pcm;doubao 主要 mp3/wav;gemini 实际只出 wav |
speed | 语速倍率,可选(按模型支持) |
instructions | 语气风格描述,可选,仅 gpt-4o-mini-tts / gemini 系支持 |
400 preset_voice_unsupported 或 invalid voice,说明音色名和模型不匹配。gpt 用 alloy 这类英文名,gemini 用 Kore 这类首字母大写名,豆包必须用它自己的音色 id(zh_female_* / zh_male_*)。模型清单
共 57 文本 22 图片 33 视频 3 语音 个模型,全部可被「自动分组」的密钥调用。价格单位:文本为元/百万 token,图片为元/张,视频为元/秒(标注「按次」的为元/次),语音为元/千字(按生成音频时长折算)。
文本模型(57)
展开完整价目表
| 模型 | 输入 ¥/M | 输出 ¥/M | 所属分组 |
|---|---|---|---|
claude-fable-5 | 20.23 | 101.16 | Claude 尊享 / Claude 旗舰 |
claude-fable-5-1 | 3.72 | 18.58 | Claude 尊享 |
claude-haiku-4-5 | 0.71 | 3.54 | Claude 尊享 / Claude 标准 |
claude-opus-4-6 | 6.37 | 31.87 | Claude 尊享 / Claude 旗舰 / Claude 标准 |
claude-opus-4-7 | 1.81 | 9.06 | Claude 尊享 / Claude 旗舰 / Claude 标准 |
claude-opus-4-8 | 2.08 | 10.41 | Claude 尊享 / Claude 旗舰 / Claude 标准 |
claude-opus-5 | 1.81 | 7.23 | Claude 尊享 / Claude 旗舰 / Claude 标准 |
claude-opus-5-5 | 5.45 | 27.24 | Claude 尊享 / Claude 标准 |
claude-sonnet-4-6 | 15.41 | 77.04 | Claude 尊享 / Claude 旗舰 / Claude 标准 |
claude-sonnet-5 | 2.03 | 8.13 | Claude 尊享 / Claude 旗舰 / Claude 标准 |
claude-sonnet-5-5 | 0.47 | 2.34 | Claude 尊享 |
codex-auto-review | 0.55 | 3.55 | Codex 优选 / Codex 标准 |
deepseek-v4-flash | 1.32 | 5.28 | DeepSeek 尊享 / DeepSeek 旗舰 |
deepseek-v4-pro | 5.81 | 17.43 | DeepSeek 尊享 / DeepSeek 旗舰 |
deepseek-v4-pro-0813 | 7.19 | 21.58 | DeepSeek 尊享 / DeepSeek 旗舰 |
deepseek-v4.1-flash | 0.39 | 1.57 | DeepSeek 尊享 / DeepSeek 旗舰 |
deepseek-v4.1-flash-1017 | 1.60 | 6.40 | DeepSeek 尊享 / DeepSeek 旗舰 |
doubao-seed-2-0-pro | 4.16 | 20.82 | 标准 |
gemini-3-flash | 0.56 | 3.34 | Gemini 旗舰 / Gemini 标准 / 标准 / 识图 |
gemini-3-pro | 5.93 | 35.56 | Gemini 旗舰 / Gemini 标准 |
gemini-3.1-flash-lite | 0.24 | 1.41 | Gemini 旗舰 / Gemini 标准 / 识图 |
gemini-3.1-pro | 13.63 | 81.80 | Gemini 旗舰 / Gemini 标准 / 标准 / 识图 |
gemini-3.5-flash | 5.58 | 33.46 | Gemini 旗舰 / Gemini 标准 |
gemini-3.5-flash-lite | 0.28 | 2.34 | Gemini 旗舰 / Gemini 标准 |
gemini-3.6-flash | 4.03 | 20.17 | Gemini 旗舰 / Gemini 标准 |
gemini-3.7-flash | 1.29 | 6.43 | Gemini 旗舰 / Gemini 标准 |
gemini-3.8-flash | 3.05 | 15.25 | Gemini 旗舰 / Gemini 标准 |
gemini-4-argon | 6.69 | 33.44 | Gemini 旗舰 / Gemini 标准 |
glm-5.2 | 6.39 | 22.38 | 智谱 标准 |
glm-5.3 | 29.74 | 104.09 | 智谱 旗舰 / 智谱 标准 |
glm-5.3-flash | 0.45 | 1.51 | 智谱 旗舰 / 智谱 标准 |
gpt-5.3-codex | 13.01 | 104.09 | Codex 优选 / Codex 标准 / GPT 旗舰 |
gpt-5.4 | 13.94 | 83.64 | Codex 优选 / Codex 标准 / GPT 旗舰 |
gpt-5.4-mini | 5.58 | 33.48 | Codex 优选 / Codex 标准 / GPT 旗舰 |
gpt-5.4-nano | 1.49 | 9.31 | Codex 优选 / Codex 标准 / GPT 旗舰 |
gpt-5.5 | 0.88 | 5.30 | Codex 优选 / Codex 标准 / GPT 旗舰 |
gpt-5.6-luna | 2.39 | 14.36 | Codex 优选 / Codex 标准 / GPT 旗舰 |
gpt-5.6-sol | 3.99 | 23.94 | Codex 优选 / Codex 标准 / GPT 旗舰 |
gpt-5.6-terra | 0.58 | 3.49 | Codex 优选 / Codex 标准 / GPT 旗舰 |
gpt-6-astra | 18.58 | 92.92 | Codex 优选 / Codex 标准 / GPT 旗舰 |
gpt-6-sol | 0.47 | 2.35 | Codex 优选 / Codex 标准 / GPT 旗舰 |
gpt-6.1-sol | 1.12 | 5.58 | Codex 优选 / Codex 标准 / GPT 旗舰 |
grok-4-20-non-reasoning | 1.92 | 3.84 | Grok |
grok-4.5 | 1.01 | 3.03 | Grok |
grok-4.6 | 0.64 | 1.92 | Grok |
grok-4.7 | 1.08 | 3.23 | Grok |
kimi-k3 | 18.58 | 92.92 | kimi 旗舰 / kimi 标准 |
minimax-m3 | 2.22 | 8.88 | MiniMax |
minimax-m3.1-flash | 1.22 | 4.89 | MiniMax |
muse-spark-1.3 | 16.73 | 56.88 | Muse |
qwen3.5-omni-flash | 2.53 | 16.80 | 千问 |
qwen3.6-plus | 1.86 | 11.15 | 千问 |
qwen3.7-flash | 0.21 | 0.84 | 千问 |
qwen3.7-max | 11.15 | 33.45 | 千问 |
qwen3.7-plus | 1.86 | 7.43 | 千问 |
qwen3.8-flash | 0.56 | 1.68 | 千问 |
qwen3.8-max | 8.03 | 24.08 | 千问 |
图片模型(22)
展开完整价目表
| 模型 | 单价 ¥/张 | 所属分组 |
|---|---|---|
doubao-seedream-4-5 | 0.35 | 生图 |
doubao-seedream-5-0 | 0.19 | 生图 |
doubao-seedream-5-0-pro | 0.10 | 生图 |
flux-2 | 0.30 | 生图 |
flux-3 | 0.44 | 生图 |
gemini-3-pro-image | 0.11 | 生图 |
gemini-3.1-flash-image | 0.14 | 生图 |
gemini-3.1-flash-lite-image | 0.05 | 生图 |
gemini-nano-banana-2.1-image | 0.09 | 生图 |
gpt-image-1.5-all | 0.50 | 生图 |
gpt-image-2 | 0.04 | 生图 |
gpt-image-2-c | 0.10 | 生图 |
gpt-image-2-official | 0.52 | 生图 |
gpt-image-2.5-flare | 0.05 | 生图 |
gpt-image-2.5-sunburst | 0.04 | 生图 |
grok-imagine-image | 0.03 | Grok |
grok-imagine-image-2.0 | 0.07 | 生图 |
kling-image-o3 | 0.09 | 生图 |
mj_imagine | 0.09 | 生图 |
qwen-image-2.0 | 0.23 | 生图 |
qwen-image-3.0 | 0.25 | 生图 |
wan2.7-image | 0.33 | 生图 |
视频模型(33)
展开完整价目表
| 模型 | 单价 ¥ | 计价方式 | 所属分组 |
|---|---|---|---|
grok-imagine-1-5-7tu-special | 0.23 | 按秒 | Seedance |
grok-imagine-1.5 | 0.30 | 按秒 | Seedance |
grok-imagine-1.5-special | 2.85 | 按秒 | Seedance |
grok-imagine-video | 0.14 | 按秒 | Seedance |
grok-imagine-video-special | 0.91 | 按秒 | Seedance |
grok-video-3 | 0.15 | 按秒 | Seedance |
happyhorse-1-1 | 3.57 | 按秒 | Seedance |
kling-3.0-turbo | 3.19 | 按秒 | Seedance |
kling-v3 | 3.81 | 按秒 | Seedance |
kling-v4 | 3.79 | 按秒 | Seedance |
minimax-h3 | 0.34 | 按秒 | Seedance |
minimax-hailuo-2-3 | 0.46 | 按秒 | Seedance |
muse-video | 0.76 | 按秒 | Seedance |
omni-flash-1-1 | 0.97 | 按次 | Seedance |
pixverse-c1 | 1.95 | 按秒 | Seedance |
pixverse-v6 | 1.75 | 按秒 | Seedance |
seedance-2-0-9tu-special | 1.90 | 按次 | Seedance |
seedance-2-0-ecom-special | 0.38 | 按次 | Seedance |
seedance-2-0-manju-special | 1.90 | 按次 | Seedance |
seedance-2-0-official | 0.50 | 按秒 | Seedance |
seedance-2-0-promo | 0.62 | 按秒 | Seedance |
seedance-2-0-special | 1.90 | 按次 | Seedance |
seedance-2-5 | 4.74 | 按秒 | Seedance |
seedance-2-5-promo | 4.68 | 按秒 | Seedance |
seedance-2-5-special | 10.44 | 按次 | Seedance |
sora-2-official | 3.57 | 按秒 | Seedance |
veo-3-1-manju-special | 0.76 | 按次 | Seedance |
veo-3.1 | 0.57 | 按次 | Seedance |
veo-4-omni | 0.34 | 按秒 | Seedance |
viduq3 | 0.91 | 按秒 | Seedance |
wan-3-0 | 1.14 | 按秒 | Seedance |
wan-3-0-special | 9.68 | 按次 | Seedance |
wan2.7-video | 1.76 | 按秒 | Seedance |
音频模型(3)
展开完整价目表
| 模型 | 参考价 ¥/千字 | 最短单价 ¥ | 输出格式 | 所属分组 |
|---|---|---|---|---|
gpt-4o-mini-tts | 0.12 | 0.002 | mp3 / wav / opus / aac / flac / pcm | 音频 |
gemini-3.1-flash-tts | 0.62 | 0.010 | wav | 音频 |
doubao-tts-2.0 | 0.63 | 0.010 | mp3 / wav | 音频 |
GET /v1/models 为最终准;页面价目表为参考值,极端情况下以上游实际计费口径为准,最终以账单为准。计费与限额
- 人民币计价:文本按「输入 token + 输出 token」分别计费;图片按张;视频按秒或按次;语音按生成音频时长(每分钟折 1000 token)计费。
- 预扣 + 结算:请求开始时按预估额度预扣,结束后按实际用量结算,多退少补;余额不足会直接拒绝请求。
- 失败不计费:上游报错或任务失败,预扣额度自动退回。
- 无月费、无最低消费:充值到余额,按量扣减;余额与明细在「控制台 → 日志 / 钱包」查看。
- 限频:平台对单 IP / 单密钥有并发与频率保护,超限返回
429,降低并发或稍后重试即可。
常见问题
401 Invalid token
密钥写错、已被删除,或把完整的 sk-... 截断了。确认 Header 是 Authorization: Bearer sk-xxx(Anthropic 协议用 x-api-key),前后没有空格和换行。
404 model not found / This token has no access to model
模型名拼错,或密钥的分组 / 模型白名单把该模型排除了。最省事的做法:把密钥分组改成「自动分组」,模型限制留空(全部模型)。
503 当前分组上游负载已饱和
该模型当前没有可用渠道(上游限流或临时故障)。等几十秒重试;连续出现可以换个同族模型(例如 gpt-6-sol ↔ gemini-3-flash),或联系我们。
429 Too Many Requests
频率超限。降低并发、加大请求间隔;批量任务建议串行并 sleep 1~2 秒。
视频任务返回 failed
看 error.message:常见是 prompt 触发上游内容审核、参考图链接不可公网访问、或时长/比例超出该模型支持范围。修正后重新提交即可,失败任务不收费。
图片为什么返回链接而不是 base64
为节省带宽和响应时间,图片统一返回直链 URL,直接展示或下载均可。
能用同一个 key 同时跑对话、生图、生视频吗
能。自动分组会按 model 路由到对应渠道,三类能力共用一个密钥、一份余额。
语音合成报 400 / invalid voice
音色名和模型不匹配。gpt-4o-mini-tts 只能用 alloy / echo / fable / onyx / nova / shimmer;gemini-3.1-flash-tts 用 Kore / Puck / Charon 这类首字母大写的名字;doubao-tts-2.0 必须用豆包自己的音色 id(如 zh_female_vv_uranus_bigtts)。
语音合成返回的是乱码 / 不是 JSON
正常现象:/v1/audio/speech 直接返回音频二进制。用 curl --output a.mp3 或 SDK 的 stream_to_file 存盘,别按 JSON 解析。
一个 Key 调全部模型