快速开始

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

1. 注册并完成对应级别的实名认证
2. 在控制台创建 API Key
3. 查询账户当前可用模型
4. 运行示例并核对响应与用量

鉴权

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

在请求头中携带密钥：

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

接口支持范围

兼容范围以具体接口为单位，不同模型和上游渠道可能支持不同能力。生产接入前，请先查询账户的可用模型，并用目标接口完成一次测试。

发起第一个请求

本文使用当前已配置的 qwen3.8-flash 演示 Chat Completions；运行前请确认它出现在当前 Key 的 GET /v1/models 返回中。

# cURL
curl https://api.relayai.com.cn/v1/chat/completions \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.8-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="qwen3.8-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: "qwen3.8-flash",
  messages: [{ role: "user", content: "你好，RelayAI" }],
});
console.log(resp.choices[0].message.content);

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "qwen3.8-flash",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "RelayAI 提供统一的大模型 API 接入服务。"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 18, "completion_tokens": 20, "total_tokens": 38}
}

请求参数

查询账户可用模型

模型和权限会随账户、认证级别及上游状态变化。使用同一个 API Key 查询当前账户可调用的模型，不要在应用中长期写死公开示例目录。

curl https://api.relayai.com.cn/v1/models \
  -H "Authorization: Bearer $RELAY_API_KEY"

模型示例目录

目录核对日期：2026-10-16。 以下为本次核对时已有启用渠道的模型 ID，按厂商和模态分组；这是静态示例，不会自动同步后台。

请先用同一个 API Key 调用 GET /v1/models，再选择返回的精确 ID；渠道启用不等于当前账户已获授权。

Claude / Gemini 最新型号速查

以下为厂商官方最新型号，单独标注本平台接入状态；官方发布不代表本平台已开通，调用仍须企业认证及专项授权。

Claude 官方模型目录 · Gemini 官方模型目录 · Gemini 更新与弃用说明

gemini-3.5-flash 和 gemini-3.1-flash-image 已被原厂列为弃用；下方保留平台现有 ID，迁移前请先确认新版渠道和专项授权。

厂商新版与平台接入

MiMo V2.6 系列、MAI-Thinking-1（预览版）已由厂商发布，本次核对尚未出现在平台启用渠道中；请勿直接将厂商名称作为本平台调用 ID。

小米官方新版 · 微软官方预览版

流式输出

设置 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="")

Seedance 视频生成

当前使用统一接口 /v1/videos，不能只替换火山域名。使用 RelayAI API Key；以下示例会创建计费任务。

curl 'https://api.relayai.com.cn/v1/videos' \
  -H "Authorization: Bearer $RELAYAI_API_KEY" \
  --form-string 'model=doubao-seedance-2-0-mini-260615' \
  --form-string 'prompt=A paper boat on a quiet lake' \
  --form-string 'seconds=5' \
  --form-string 'size=720p' \
  --form-string 'metadata={"resolution":"720p","ratio":"16:9"}'

提交后保存响应 id，使用同一个 Key 查询；完成状态为 completed，读取 /content 获取视频。超时后继续查原任务，不要重复提交。

curl "https://api.relayai.com.cn/v1/videos/${TASK_ID}" \
  -H "Authorization: Bearer $RELAYAI_API_KEY"

# After status is completed
curl --fail "https://api.relayai.com.cn/v1/videos/${TASK_ID}/content" \
  -H "Authorization: Bearer $RELAYAI_API_KEY" \
  --output result.mp4

图片、视频和音频参考放入 metadata.content，保留 type、URL 和 role。首尾帧使用 first_frame / last_frame；公开素材链接须可被上游访问。

{"resolution":"720p","ratio":"16:9","content":[{"type":"image_url","image_url":{"url":"https://example.com/first-frame.png"},"role":"first_frame"}]}

素材查询与视频生成独立：仅支持已分配素材组的只读查询，不是上传或视频生成接口。

POST /v1/seedance/assets/list · POST /v1/seedance/asset-groups/list · POST /v1/seedance/assets/get

# Install: python -m pip install --upgrade arkruntime
# Creating a task is billable
import os
from arkruntime import Ark
client = Ark(
    base_url="https://api.relayai.com.cn/api/v3",
    api_key=os.environ["RELAYAI_API_KEY"],
    max_retries=0,
)
task = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-mini-260615",
    content=[{"type": "text", "text": "Ocean waves at sunrise"}],
    duration=5, resolution="720p", ratio="16:9",
)
print(task.id)
# Retrieve later with the same RelayAI Key; no automatic retry of creation.
result = client.content_generation.tasks.get(task_id=task.id)
print(result.status)
if result.status == "succeeded":
    print(result.content.video_url)

Seedance 官方视频文档

在编程工具中使用

支持自定义兼容端点的编程工具与 Agent 可以接入 RelayAI。请先确认工具所需协议、RelayAI 账户权限和模型渠道均已开通，再将 base_url 指向对应端点并填入 API Key。下面给出常见配置示例。

Claude Code

Anthropic 协议 · 接入前确认

一键复制

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

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.3"

OpenClaw

OpenAI 兼容 · 配置文件

一键复制

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

查看更多工具配置（5）

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

Agent 接入与治理

企业可以把 OpenClaw、WorkBuddy、Claude Code、Python SDK 或自研 Harness 的模型流量归属到受管 Agent，并统一应用模型白名单、预算和工具策略。客户端只使用 Agent 绑定的企业 API Key，不需要额外提交 Agent ID。

快速接入

1. 创建 Agent设置归属部门、项目、风险等级与模型白名单。
2. 绑定独立 Key每个业务实例使用独立的企业 API Key。
3. 配置客户端选择对应协议并填写 RelayAI API 地址和模型。
4. 验证模型调用发起真实请求，确认 Console 已观测到模型用量。
5. 接入工具治理登记 Tool、配置策略并在执行前完成授权核销。

治理范围

预算与权限

工具授权与人工审批

工具凭证只允许核销一次。服务端执行器必须在真正调用业务工具之前完成授权和核销。

1. 固定工具映射把 tool_key 映射到受信任函数和动作类型。
2. 请求授权提交 request_id、参数摘要和预估成本。
3. 策略决策返回允许、待人工审批或拒绝。
4. 核销凭证用相同请求和参数核销一次性 ticket。
5. 执行业务工具核销成功后才调用目标系统。

发起策略判断；返回 approval 时使用相同 request_id 轮询，返回 allow 且包含能力凭证后停止轮询。

执行前核销一次性能力凭证。授权与核销必须使用相同的 request_id、tool_key、action_type 与 parameters_hash。

常见问题

错误与排查

请求失败时先记录 HTTP 状态码和响应中的 request_id。响应通常包含 error.type 与 error.message；具体字段可能因模型渠道而不同。

{
  "error": {
    "type": "invalid_request_error",
    "message": "model is required"
  },
  "request_id": "req_01..."
}

限流与计费

限流按账户、API Key、模型和渠道配置执行，实际额度以控制台、响应头或合同约定为准。文本模型通常按实际输入与输出 token 计费，其他模态按对应计费单位结算。

• 每次请求的用量可在响应 usage 字段及控制台账单中核对；
• 遇到 429 时不要立即循环重试，应按响应头或指数退避策略等待；
• 模型单价和可用计费方式以定价页及控制台展示为准。