StdAPI一个 Key 调全部模型使用文档返回主站 →

一个 Key 调用全部模型

一个地址 https://relvox.xyz/v1 · 一把密钥 · 覆盖 115 个模型(文本 57 / 图片 22 / 视频 33 / 语音 3)· 人民币计价 · 按量付费

只需要记住三件事:① 地址是 https://relvox.xyz/v1;② 密钥在「控制台 → API 密钥」里创建;③ 新建密钥时分组选「自动分组」(这是默认值,不用改)。之后同一个 key 既能聊天,也能生图、生视频。

分组不是「套餐」,而是「路由标签」。选「自动分组」后,系统按你请求的 model 自动找到对应渠道,价格与直接选具体分组完全一致(全站同一倍率)。

能力一览

能力接口说明
文本对话POST /v1/chat/completionsOpenAI 兼容协议,支持 stream: true 流式输出
响应式接口POST /v1/responsesCodex / OpenAI Agents SDK 使用,wire_api = "responses"
Claude 原生POST /v1/messagesAnthropic 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返回当前密钥可用的全部模型

第一步 · 创建密钥

  1. 登录 relvox.xyz,打开「控制台 → API 密钥」。
  2. 点「新建密钥」。分组保持默认的「自动分组」,其它选项不用动(模型限制留空 = 全部模型可用)。
  3. 保存后复制密钥,形如 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-sol0.472.35
中文长文 / 便宜大碗gemini-3-flash0.563.34
极速轻量qwen3.7-flash0.210.84
旗舰推理claude-opus-4-66.3731.87
旗舰通用 / 长上下文gemini-3.1-pro13.6381.80
编程 / Agentgpt-5.3-codex13.01104.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 张)
modetext-to-video(文生视频)、first-frame(首帧)、reference(参考图)
generate_audio是否生成音轨(按模型支持)
轮询建议:间隔 5~10 秒,最多等 10 分钟。视频生成耗时通常 30 秒 ~ 5 分钟,取决于模型。

语音合成(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-ttsalloy echo fable onyx nova shimmer最快(1.5~10 秒),中英双语,短句极便宜约 0.12 元/千字;14 字短句约 0.002 元
gemini-3.1-flash-ttsKore 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_formatmp3 / wav 等;gpt-4o-mini-tts 支持 mp3/opus/aac/flac/wav/pcm;doubao 主要 mp3/wav;gemini 实际只出 wav
speed语速倍率,可选(按模型支持)
instructions语气风格描述,可选,仅 gpt-4o-mini-tts / gemini 系支持
计费口径:语音按「生成的音频时长」计费(每分钟音频折算 1000 token),换算下来与文字长度近似线性——中文约 0.12 ~ 0.63 元/千字,具体取决于模型。合成失败不扣费。
音色报错怎么办:返回 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-520.23101.16Claude 尊享 / Claude 旗舰
claude-fable-5-13.7218.58Claude 尊享
claude-haiku-4-50.713.54Claude 尊享 / Claude 标准
claude-opus-4-66.3731.87Claude 尊享 / Claude 旗舰 / Claude 标准
claude-opus-4-71.819.06Claude 尊享 / Claude 旗舰 / Claude 标准
claude-opus-4-82.0810.41Claude 尊享 / Claude 旗舰 / Claude 标准
claude-opus-51.817.23Claude 尊享 / Claude 旗舰 / Claude 标准
claude-opus-5-55.4527.24Claude 尊享 / Claude 标准
claude-sonnet-4-615.4177.04Claude 尊享 / Claude 旗舰 / Claude 标准
claude-sonnet-52.038.13Claude 尊享 / Claude 旗舰 / Claude 标准
claude-sonnet-5-50.472.34Claude 尊享
codex-auto-review0.553.55Codex 优选 / Codex 标准
deepseek-v4-flash1.325.28DeepSeek 尊享 / DeepSeek 旗舰
deepseek-v4-pro5.8117.43DeepSeek 尊享 / DeepSeek 旗舰
deepseek-v4-pro-08137.1921.58DeepSeek 尊享 / DeepSeek 旗舰
deepseek-v4.1-flash0.391.57DeepSeek 尊享 / DeepSeek 旗舰
deepseek-v4.1-flash-10171.606.40DeepSeek 尊享 / DeepSeek 旗舰
doubao-seed-2-0-pro4.1620.82标准
gemini-3-flash0.563.34Gemini 旗舰 / Gemini 标准 / 标准 / 识图
gemini-3-pro5.9335.56Gemini 旗舰 / Gemini 标准
gemini-3.1-flash-lite0.241.41Gemini 旗舰 / Gemini 标准 / 识图
gemini-3.1-pro13.6381.80Gemini 旗舰 / Gemini 标准 / 标准 / 识图
gemini-3.5-flash5.5833.46Gemini 旗舰 / Gemini 标准
gemini-3.5-flash-lite0.282.34Gemini 旗舰 / Gemini 标准
gemini-3.6-flash4.0320.17Gemini 旗舰 / Gemini 标准
gemini-3.7-flash1.296.43Gemini 旗舰 / Gemini 标准
gemini-3.8-flash3.0515.25Gemini 旗舰 / Gemini 标准
gemini-4-argon6.6933.44Gemini 旗舰 / Gemini 标准
glm-5.26.3922.38智谱 标准
glm-5.329.74104.09智谱 旗舰 / 智谱 标准
glm-5.3-flash0.451.51智谱 旗舰 / 智谱 标准
gpt-5.3-codex13.01104.09Codex 优选 / Codex 标准 / GPT 旗舰
gpt-5.413.9483.64Codex 优选 / Codex 标准 / GPT 旗舰
gpt-5.4-mini5.5833.48Codex 优选 / Codex 标准 / GPT 旗舰
gpt-5.4-nano1.499.31Codex 优选 / Codex 标准 / GPT 旗舰
gpt-5.50.885.30Codex 优选 / Codex 标准 / GPT 旗舰
gpt-5.6-luna2.3914.36Codex 优选 / Codex 标准 / GPT 旗舰
gpt-5.6-sol3.9923.94Codex 优选 / Codex 标准 / GPT 旗舰
gpt-5.6-terra0.583.49Codex 优选 / Codex 标准 / GPT 旗舰
gpt-6-astra18.5892.92Codex 优选 / Codex 标准 / GPT 旗舰
gpt-6-sol0.472.35Codex 优选 / Codex 标准 / GPT 旗舰
gpt-6.1-sol1.125.58Codex 优选 / Codex 标准 / GPT 旗舰
grok-4-20-non-reasoning1.923.84Grok
grok-4.51.013.03Grok
grok-4.60.641.92Grok
grok-4.71.083.23Grok
kimi-k318.5892.92kimi 旗舰 / kimi 标准
minimax-m32.228.88MiniMax
minimax-m3.1-flash1.224.89MiniMax
muse-spark-1.316.7356.88Muse
qwen3.5-omni-flash2.5316.80千问
qwen3.6-plus1.8611.15千问
qwen3.7-flash0.210.84千问
qwen3.7-max11.1533.45千问
qwen3.7-plus1.867.43千问
qwen3.8-flash0.561.68千问
qwen3.8-max8.0324.08千问

图片模型(22)

展开完整价目表
模型单价 ¥/张所属分组
doubao-seedream-4-50.35生图
doubao-seedream-5-00.19生图
doubao-seedream-5-0-pro0.10生图
flux-20.30生图
flux-30.44生图
gemini-3-pro-image0.11生图
gemini-3.1-flash-image0.14生图
gemini-3.1-flash-lite-image0.05生图
gemini-nano-banana-2.1-image0.09生图
gpt-image-1.5-all0.50生图
gpt-image-20.04生图
gpt-image-2-c0.10生图
gpt-image-2-official0.52生图
gpt-image-2.5-flare0.05生图
gpt-image-2.5-sunburst0.04生图
grok-imagine-image0.03Grok
grok-imagine-image-2.00.07生图
kling-image-o30.09生图
mj_imagine0.09生图
qwen-image-2.00.23生图
qwen-image-3.00.25生图
wan2.7-image0.33生图

视频模型(33)

展开完整价目表
模型单价 ¥计价方式所属分组
grok-imagine-1-5-7tu-special0.23按秒Seedance
grok-imagine-1.50.30按秒Seedance
grok-imagine-1.5-special2.85按秒Seedance
grok-imagine-video0.14按秒Seedance
grok-imagine-video-special0.91按秒Seedance
grok-video-30.15按秒Seedance
happyhorse-1-13.57按秒Seedance
kling-3.0-turbo3.19按秒Seedance
kling-v33.81按秒Seedance
kling-v43.79按秒Seedance
minimax-h30.34按秒Seedance
minimax-hailuo-2-30.46按秒Seedance
muse-video0.76按秒Seedance
omni-flash-1-10.97按次Seedance
pixverse-c11.95按秒Seedance
pixverse-v61.75按秒Seedance
seedance-2-0-9tu-special1.90按次Seedance
seedance-2-0-ecom-special0.38按次Seedance
seedance-2-0-manju-special1.90按次Seedance
seedance-2-0-official0.50按秒Seedance
seedance-2-0-promo0.62按秒Seedance
seedance-2-0-special1.90按次Seedance
seedance-2-54.74按秒Seedance
seedance-2-5-promo4.68按秒Seedance
seedance-2-5-special10.44按次Seedance
sora-2-official3.57按秒Seedance
veo-3-1-manju-special0.76按次Seedance
veo-3.10.57按次Seedance
veo-4-omni0.34按秒Seedance
viduq30.91按秒Seedance
wan-3-01.14按秒Seedance
wan-3-0-special9.68按次Seedance
wan2.7-video1.76按秒Seedance

音频模型(3)

展开完整价目表
模型参考价 ¥/千字最短单价 ¥输出格式所属分组
gpt-4o-mini-tts0.120.002mp3 / wav / opus / aac / flac / pcm音频
gemini-3.1-flash-tts0.620.010wav音频
doubao-tts-2.00.630.010mp3 / wav音频
模型会随上游更新增减。以接口返回的 GET /v1/models 为最终准;页面价目表为参考值,极端情况下以上游实际计费口径为准,最终以账单为准。

计费与限额

常见问题

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 解析。