接入文档

快速开始

RelayAI 提供与 OpenAI 完全兼容的 API。个人实名认证用户与企业认证用户均使用同一个 base_url，通过 model 参数选择模型，平台按 API Key 的认证权限自动校验。

个人用户完成实名认证后，可在控制台 → API 密钥创建 Key 并调用国内模型；企业认证审核通过后，企业成员可直接新建绑定企业的 Key，调用国内及已授权海外模型。两类 Key 的接口地址均为 https://api.relayai.com.cn/v1。

鉴权

所有请求通过 HTTP 请求头中的 Bearer Token 鉴权。Base URL 如下：

BASEhttps://api.relayai.com.cn/v1

在请求头中携带密钥：

Authorization: Bearer sk-relay-xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

发起第一个请求

调用 /chat/completions 接口发起一次对话补全。下面的示例以国产模型 deepseek-v4-flash 为例：

POST/v1/chat/completions

# cURL
curl https://api.relayai.com.cn/v1/chat/completions \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "用一句话介绍 RelayAI"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.relayai.com.cn/v1",
    api_key="sk-relay-...",
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "你好，RelayAI"}
    ],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.relayai.com.cn/v1",
  apiKey: process.env.RELAY_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "你好，RelayAI" }],
});
console.log(resp.choices[0].message.content);

请求参数

参数	类型	说明
model 必填	string	模型标识，见模型列表。
messages 必填	array	对话消息列表，每条包含 `role` 与 `content`。
stream	boolean	是否流式返回，默认 `false`。
temperature	number	采样温度，0–2，默认 `1`。
max_tokens	integer	生成内容的最大 token 数。

模型列表

通过统一模型标识调用已获授权的模型，无需切换接口地址。智能路由会按可用性与时延自动选路。下表为当前模型目录（44 个），模型标识区分大小写。

模型标识	归属	模态	合规状态
`deepseek-v4-flash` `deepseek-v4-pro`	深度求索	文本	国产 · 已备案
`MiniMax-M2.7` `MiniMax-M2.7-highspeed` `MiniMax-M3`	MiniMax	文本	国产 · 已备案
`MiniMax-H3`	MiniMax	视频	国产 · 已备案
`doubao-seed-2-1-pro-260628` `doubao-seed-2-1-turbo-260628` `doubao-seed-evolving-latest-version`	字节跳动	文本	国产 · 已备案
`doubao-seedance-2-0-260128` `doubao-seedance-2-0-mini-260615` `doubao-seedance-2-5-260628`	字节跳动	视频	国产 · 已备案
`doubao-seedream-5-0-260128` `doubao-seedream-5-0-pro-260628`	字节跳动	图像	国产 · 已备案
`doubao-seed3d-2-0-260328`	字节跳动	3D	国产 · 已备案
`glm-5` `glm-5.2`	智谱	文本	国产 · 已备案
`hy3` `hy3-preview`	腾讯混元	文本	国产 · 已备案
`k3` `k3-256` `kimi-k2.7-code` `kimi-k2.7-code-highspeed`	月之暗面	文本	国产 · 已备案
`mimo-v2.5` `mimo-v2.5-pro`	小米	文本	国产 · 已备案
`qwen3.7-flash` `qwen3.7-plus` `qwen3.8-max`	阿里巴巴	文本	国产 · 已备案
`qwen-image-3.0-pro` `wan2.7-image-pro`	阿里巴巴	图像	国产 · 已备案
`gemini-3.1-pro-preview` `gemini-3.5-flash` `gemini-3.5-flash-lite` `gemini-3.6-flash`	Google	文本	海外 · 企业授权
`gemini-3.1-flash-image`	Google	图像	海外 · 企业授权
`gemini-embedding-2`	Google	嵌入	海外 · 企业授权
`imagen-4.0-fast-generate-001` `imagen-4.0-generate-001` `imagen-4.0-ultra-generate-001`	Google	图像	海外 · 企业授权
`veo-3.1-generate-preview`	Google	视频	海外 · 企业授权
`gpt-5.6-luna` `gpt-5.6-sol` `gpt-5.6-terra`	OpenAI	文本	海外 · 企业授权

个人实名认证但未完成企业认证的用户仅可调用国内模型。海外模型仅向通过审核的企业客户开放，仍使用上方同一个 API 地址，限用于合法授权的研发、测试及内部业务场景，企业须自行确保业务合规。

流式输出

设置 stream: true，服务端以 SSE（Server-Sent Events）逐块返回，适合打字机式实时渲染。

stream = client.chat.completions.create(
    model="qwen3.8-max",
    messages=[{"role": "user", "content": "写一首诗"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

在编程工具中使用

由于接口与 OpenAI / Anthropic 完全兼容，主流 AI 编程工具与 Agent 均可直接接入 RelayAI——只需把工具的 base_url 指向 RelayAI，并填入企业密钥即可。下面给出常见工具的配置方式。

这些为第三方工具，配置项可能随版本变化，请以其官方文档为准。当工具调用 gpt-*、gemini-*、veo-* 等海外模型时，须遵守海外模型「企业授权场景」的合规要求。

Claude Code

Anthropic 兼容 · 环境变量

# 写入 shell 配置或当前会话
export ANTHROPIC_BASE_URL="https://api.relayai.com.cn"
export ANTHROPIC_AUTH_TOKEN="sk-relay-..."
export ANTHROPIC_MODEL="gpt-5.6-terra"

Cursor

OpenAI 兼容 · 设置项

# Settings → Models → Override OpenAI Base URL
Base URL   https://api.relayai.com.cn/v1
API Key    sk-relay-...
Model      deepseek-v4-flash  # 添加为自定义模型

Hermes Agent

OpenAI 兼容 · 环境变量

export OPENAI_BASE_URL="https://api.relayai.com.cn/v1"
export OPENAI_API_KEY="sk-relay-..."
export OPENAI_MODEL="glm-5.2"

OpenClaw

OpenAI 兼容 · 配置文件

provider:  openai-compatible
base_url:  https://api.relayai.com.cn/v1
api_key:   sk-relay-...
model:     kimi-k2.7-code

opencode

OpenAI 兼容 · ~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "relayai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "RelayAI",
      "options": {
        "baseURL": "https://api.relayai.com.cn/v1",
        "apiKey": "sk-relay-..."
      },
      "models": {
        "deepseek-v4-flash": { "name": "DeepSeek V4 Flash" },
        "qwen3.8-max": { "name": "Qwen 3.8 Max" }
      }
    }
  }
}

Codex（OpenAI CLI / 桌面版）

OpenAI 兼容 · ~/.codex/config.toml

# ~/.codex/config.toml（用户级配置）
model = "deepseek-v4-flash"
model_provider = "relayai"

[model_providers.relayai]
name = "RelayAI"
base_url = "https://api.relayai.com.cn/v1"
env_key = "RELAY_API_KEY"

使用条件：Codex 自定义 Provider 使用 Responses API。首次接入前，请确认当前 RelayAI 账户、所选模型与渠道已支持 /v1/responses；仅支持 /v1/chat/completions 的渠道无法直接用于 Codex。

Z Code（智谱 AI IDE）

OpenAI 兼容 · 设置面板

# 设置 → Model Settings → Add provider
Name       RelayAI
Base URL   https://api.relayai.com.cn/v1
API Key    sk-relay-...
模型        deepseek-v4-flash  # 可添加多个已授权模型

Qoder（阿里 AI 编程工具）

OpenAI 兼容 · Custom Endpoint

# Settings → Qoder → Model Backend → Custom Endpoint
Base URL    https://api.relayai.com.cn/v1
API Key     sk-relay-...
Model Name  deepseek-v4-flash   # 大小写敏感

WorkBuddy（腾讯 AI 工作台）

OpenAI 兼容 · 设置面板

# 设置 → 模型 → 添加模型 → 自定义（OpenAI 兼容）
接口地址    https://api.relayai.com.cn/v1/chat/completions
API Key     sk-relay-...
模型名称    deepseek-v4-flash

WorkBuddy 技能包：安装 RelayAI Skill 后可一句话调用模型切换、成本查询、多模型对比。前往下载 Skill →

错误码

错误以标准 HTTP 状态码返回，响应体包含 error.type 与 error.message。

状态码	含义	处理建议
401	密钥无效或缺失	检查 Authorization 请求头。
403	无该模型权限	海外模型需企业授权，联系商务开通。
429	触发限流	按 `Retry-After` 退避重试。
402	余额不足	前往控制台充值或核对套餐额度。
500 / 503	上游异常	智能路由自动重试，可稍后再请求。

限流与计费

按实际消耗的 token 计费，控制台实时可查。默认限流为 3,500 RPM，企业客户可按需提升。

计费粒度精确到每次请求的输入 / 输出 token；
支持订阅套餐与按量付费两种模式，可在控制台切换；
支持支付宝、微信企业付款，并开具增值税普通 / 专用发票。

进入控制台提交企业入驻

快速开始

鉴权

发起第一个请求

请求参数

模型列表

流式输出

在编程工具中使用

错误码

限流与计费

我是您的专属顾问