文档

几分钟把工具接上

把下面的 API 主机填到原来写厂商地址的地方。网站和 API 不在同一个主机上，客户端请一律连接 API 主机。

客户端要连的地址https://api.relayvano.com/v1

用你熟悉的语言调用接口

PythonNode.jsGocURL

安装官方 SDK，把本站 API 主机填为 base URL。

pip install openai

Python

import openai as gateway

voyage = gateway.OpenAI(api_key="rlv_your_key", base_url="https://api.relayvano.com/v1")
leg = voyage.chat.completions.create(model="gpt-6.1-sol", messages=[
    {"role": "user", "content": "Plan a three-stop refactor for my parser"},
])
print(leg.choices[0].message.content.strip())

JavaScript / TypeScript 用同一系列 SDK；密钥放在环境变量里。

npm install openai

Node.js

import { OpenAI } from "openai";

const relay = new OpenAI({ apiKey: process.env.RELAYVANO_KEY, baseURL: "https://api.relayvano.com/v1" });
const reply = await relay.chat.completions.create({
  model: "gpt-6.1-sol",
  messages: [{ role: "user", content: "Suggest a name for a packing-list app" }],
});
console.log(reply.choices[0].message.content);

不需要 SDK：一个带 Bearer 头的普通 HTTP 请求就行。

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	payload := []byte(`{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"Name a city on the Danube"}]}`)
	req, _ := http.NewRequest("POST", "https://api.relayvano.com/v1/chat/completions", bytes.NewReader(payload))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("RELAYVANO_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	answer, _ := io.ReadAll(res.Body)
	fmt.Println(string(answer))
}

API 密钥以 Bearer 令牌发送。示例让 GPT-6.1 Sol 用三种语言打个招呼。

cURL · chat

curl https://api.relayvano.com/v1/chat/completions \
  --oauth2-bearer rlv_your_key \
  --json '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Say hello in Hindi, Spanish and French"}]}'

Gemini 模型走原生路径，并用 x-goog-api-key 头：

cURL · Gemini generateContent

curl "https://api.relayvano.com/v1beta/models/gemini-3.8-flash:generateContent" \
  --header "x-goog-api-key: rlv_your_key" \
  --json '{"contents": [{"role": "user", "parts": [{"text": "Name three night trains in Europe"}]}]}'

推荐先试这几个 GPT ID：

gpt-5.6-sol
gpt-6-astra
gpt-6.1-sol

配置编码客户端

Claude Code · Claude Desktop

把 Anthropic 基址设为 API 主机（不要带 /v1），令牌填你的 API 密钥，然后运行 claude。

bash or zsh on macOS and Linux

export ANTHROPIC_BASE_URL=https://api.relayvano.com
export ANTHROPIC_AUTH_TOKEN=rlv_your_key
claude

Windows with setx

setx ANTHROPIC_BASE_URL "https://api.relayvano.com"
setx ANTHROPIC_AUTH_TOKEN "rlv_your_key"

Claude 系列模型只对官方 Claude Code 和 Claude Desktop 客户端开放，且上游要求 Claude Code 版本不低于 2.1.285；GPT、Gemini 等其他模型可以用任何 OpenAI 兼容客户端或 SDK。

Codex

Base URL 填 https://api.relayvano.com/v1，API Key 填你的 API 密钥。对话请求走 /v1/chat/completions，Responses API 在 /v1/responses。

Codex

export OPENAI_BASE_URL=https://api.relayvano.com/v1
export OPENAI_API_KEY=rlv_your_key
codex

Gemini CLI

Gemini 基址填纯 API 主机，Gemini Key 填你的 API 密钥，然后运行 gemini。

Gemini CLI

export GOOGLE_GEMINI_BASE_URL=https://api.relayvano.com
export GEMINI_API_KEY=rlv_your_key
gemini

只填主机本身，不要自己再加 /v1beta。
Gemini 只走原生协议；需要流式时调用 :streamGenerateContent?alt=sse。
别把 Gemini 模型发到 /v1/chat/completions，那里不接 Gemini。

目前上架的 Gemini ID：

gemini-3.1-pro
gemini-3.8-flash
gemini-4-argon

请求怎么计费

每次请求按模型真实处理的 token 计价，存入缓存与命中缓存单独定价；每一笔都能在控制台查到。

收到 HTTP 402，说明余额用完了。到控制台充值后重新发送即可。