通用协议总览

OpenRely API 网关原生支持 OpenAI、Anthropic Claude 与 Google Gemini 三大行业主流协议，一站式赋能任意 AI 客户端与开发工作流。

概述

为了让开发者无需改造代码即可无缝接入全球顶尖大模型，OpenRely API 网关在底层深度兼容了当今 AI 生态的三大核心协议规范：

OpenAI 兼容协议（支持 /v1/chat/completions 与 /v1/responses）
Anthropic Claude 兼容协议（支持 /v1/messages）
Google Gemini 兼容协议（支持 /v1beta/models/...:generateContent）

无论您手头的工具是仅支持填入 OpenAI Base URL，还是严格依赖 Anthropic / Gemini 原生 SDK，均可直接对接。

💡 免配置在线体验：如果您只想快速测试模型效果，无需在本地编写代码或配置客户端，可直接登录控制台进入 在线聊天沙盒 (Playground) 体验多模型实时交互。

📌 三大协议直达与选型矩阵

请根据您的客户端类型或底层 SDK，选择对应的协议接入指南：

OpenAI 兼容协议

最通用的行业标准，支持跨模型调度与 Responses API

Claude 兼容协议

Anthropic 原生 Messages 消息格式与鉴权规范

Gemini 兼容协议

Google Gemini 原生 REST 接口与 GenAI SDK 接入

⚡ 核心协议规范与极速联调

为了方便开发者快速自测与联调，以下直接列出三大主流协议的核心连接规范与快速验证命令。默认均以 cURL 命令展示，支持按需切换 Python 与 Node.js SDK 示例：

推荐选用原则：

如果您的软件有 “OpenAI / 自定义服务商” 选项，优先推荐使用 OpenAI 兼容协议。在该协议下，您可以用同一套配置调用 GPT、Claude 以及 Gemini 等全部模型。
只有当客户端是某大厂专属工具（如专为 Claude 设计的插件，或专为 Google Gemini 开发的系统），才需要使用对应的原生协议。

1. OpenAI 兼容协议（最通用推荐）

服务地址 (Base URL)：https://api.openrely.ai/v1
鉴权标头 (Header)：Authorization: Bearer sk-••••
核心端点 (Endpoint)：POST /v1/chat/completions ｜ 📖 浏览 OpenAI 完整专篇指南 ➔

curl -X POST "https://api.openrely.ai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt",
    "messages": [
      { "role": "user", "content": "Hello OpenRely!" }
    ]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.openrely.ai/v1",
    api_key="sk-your-api-key",
)

response = client.chat.completions.create(
    model="gpt",
    messages=[{"role": "user", "content": "Hello OpenRely!"}],
)

print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.openrely.ai/v1',
  apiKey: 'sk-your-api-key',
});

const response = await client.chat.completions.create({
  model: 'gpt',
  messages: [{ role: 'user', content: 'Hello OpenRely!' }],
});

console.log(response.choices[0].message.content);

2. Anthropic Claude 兼容协议

服务地址 (Base URL)：https://api.openrely.ai
鉴权标头 (Header)：x-api-key: sk-••••，anthropic-version: 2023-06-01
核心端点 (Endpoint)：POST /v1/messages ｜ 📖 浏览 Claude 完整专篇指南 ➔

curl -X POST "https://api.openrely.ai/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello Claude!" }
    ]
  }'

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.openrely.ai",
    api_key="sk-your-api-key",
)

response = client.messages.create(
    model="claude",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello Claude!"}],
)

print(response.content[0].text)

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  baseURL: 'https://api.openrely.ai',
  apiKey: 'sk-your-api-key',
});

const response = await client.messages.create({
  model: 'claude',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Hello Claude!' }],
});

console.log(response.content[0].text);

3. Google Gemini 兼容协议

服务地址 (Base URL)：https://api.openrely.ai
鉴权标头 (Header)：x-goog-api-key: sk-••••（或 URL query ?key=sk-...）
核心端点 (Endpoint)：POST /v1beta/models/{model}:generateContent ｜ 📖 浏览 Gemini 完整专篇指南 ➔

curl -X POST "https://api.openrely.ai/v1beta/models/gemini:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: sk-your-api-key" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{ "text": "Hello Gemini!" }]
      }
    ]
  }'

from google import genai
from google.genai import types

client = genai.Client(
    api_key="sk-your-api-key",
    http_options=types.HttpOptions(base_url="https://api.openrely.ai"),
)

response = client.models.generate_content(
    model="gemini",
    contents="Hello Gemini!",
)

print(response.text)

import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({
  apiKey: 'sk-your-api-key',
  endpoint: 'https://api.openrely.ai',
});

const response = await ai.models.generateContent({
  model: 'gemini',
  contents: 'Hello Gemini!',
});

console.log(response.text);

常见问题与排障

常见报错 / 现象	产生原因	解决建议
401 Unauthorized	密钥错误或 Header 格式不匹配	检查 API Key 是否完整粘贴（`sk-...`）；核对是否按照协议要求使用了正确的 Header（OpenAI 为 `Authorization: Bearer`，Claude 为 `x-api-key`，Gemini 为 `x-goog-api-key`）。
404 Not Found	Base URL 路径层级错误	部分客户端会自动拼接子路径。若填入 `https://api.openrely.ai/v1` 报 404，尝试去掉 `/v1` 改填 `https://api.openrely.ai`。
429 Rate Limit	账户余额不足或超出单密钥限额	登录 OpenRely 控制台检查钱包余额及对应 API Key 的独立限额设置。

🛠️ 常用模型能力与端点速查

OpenRely 聚合了全球主流大模型的全模态能力，以下为常用接口的路径、支持协议与规范对照表：

业务能力	请求路径 (Endpoint)	请求方法	遵循协议	适用模型示例 / 场景说明
文本与多模态对话	`/v1/chat/completions`	`POST`	OpenAI	全模型通用（GPT-4o、Claude 3.7、Gemini 2.5、DeepSeek 等），支持流式与 Tool Calling
新一代 Responses	`/v1/responses`	`POST`	OpenAI	OpenAI 原生 Responses API，适用于现代自主 Agent 工作流
Claude 原生消息	`/v1/messages`	`POST`	Claude	Anthropic 原生消息格式，支持 Thinking 思考深度与 Prompt Caching 提示词缓存
Gemini 原生生成	`/v1beta/models/{model}:generateContent`	`POST`	Gemini	Google GenAI 原生格式，支持多轮对话与多模态音视频推理
向量嵌入 (Embeddings)	`/v1/embeddings`	`POST`	OpenAI	`text-embedding-3-small` / `text-embedding-3-large` 知识库检索与 RAG 向量化
图像生成 (Images)	`/v1/images/generations`	`POST`	OpenAI	DALL-E 3、Midjourney、FLUX 等文生图模型
语音转录 (Audio)	`/v1/audio/transcriptions`	`POST`	OpenAI	Whisper 语音识别与文本听写
文本转语音 (TTS)	`/v1/audio/speech`	`POST`	OpenAI	文本合成为自然流畅的语音流
可用模型列表	`/v1/models`	`GET`	OpenAI	获取当前账户有权调用的全部可用模型 ID 列表

提示：所有模型的最实时价格与计费倍率，请随时访问 🏆 模型广场与价格中心进行精确核对。

📥 本地自动化联调与 API 规范兼容

OpenRely API 规范完全兼容国际通用的 OpenAPI 3.0 标准，支持与各类主流测试与调试工具深度协同：

Apifox / Postman 调试流：您可以在本地 Apifox 或 Postman 中新建环境，配置 Base URL 为 https://api.openrely.ai 并设置全局 Header Authorization: Bearer {{token}}，即可快速发起请求与编写自动化断言；
端点通用性原则：平台采用统一中继路由机制，同一端点（如 /v1/chat/completions）通过请求体中的 model 字段即可直接调度跨厂商模型（GPT、Claude、Gemini、DeepSeek 等），无需为每个模型重复创建接口，结构极简轻盈。

通用协议总览

目录