通用協議總覽

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 等），無需為每個模型重複建立介面，結構極簡輕盈。

通用協議總覽

目錄