使用指南API 參考AI 應用

🎮 線上演練與遊樂場 (Playground)

在控制台免配置線上體驗測試主流大模型,即時調節生成引數並驗證 API 連通性。

遊樂場

遊樂場(Playground)提供輕量級線上除錯與體驗環境,無需編寫任何程式碼即可直接與模型多輪對話並驗證效果。

  1. 選擇分組與模型:在輸入框右下方選擇渠道分組與待測試的具體模型。
  2. 設定生成引數:點選引數按鈕,可按需調節 Temperature、Top P、頻率懲罰(Frequency Penalty)及最大 Token 數(Max Tokens)。
  3. 輸入對話提示詞:在底部輸入框鍵入測試問題或 System Prompt。
  4. 傳送與除錯:點選「傳送」提交請求,即時檢視流式回覆、Token 消耗及響應耗時。

API 地址與認證

平臺的標準相容 Base URL 為:

https://api.openrely.ai/v1

在 HTTP 請求頭中傳入 API 金鑰作為 Bearer Token:

Authorization: Bearer sk-your-api-key

以聊天補全(Chat Completions)為例:

curl 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":"你好"}]}'

SDK 程式碼示例

Python(OpenAI SDK)

from openai import OpenAI

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

response = client.chat.completions.create(
    model="gpt",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

Claude 原生 Messages 協議

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

Gemini 原生格式

curl "https://api.openrely.ai/v1beta/models/gemini:generateContent?key=sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "Hello"}]}]}'

支援的介面端點全覽

平臺全面相容主流大模型協議規範,主要端點支援如下:

介面分類路徑協議與功能說明
聊天補全POST /v1/chat/completionsOpenAI Chat Completions 相容介面,支援全功能流式輸出(SSE)、Function Calling 及多模態輸入。
遊樂場聊天POST /pg/chat/completions控制台網頁遊樂場專用介面,複用統一的分流、協議轉換、計費和重試鏈路。
Claude MessagesPOST /v1/messagesAnthropic Claude 原生相容介面,支援 Claude 官方 SDK 及原生客戶端無縫直連。
Gemini 原生呼叫POST /v1beta/models/{model}:{action}Google Gemini 原生格式介面,支援 generateContent、streamGenerateContent 等操作。
Gemini 相容呼叫POST /v1/models/{model}:{action}以 /v1 字首承接 Gemini 風格的模型操作請求,自動完成協議解析與轉換。
向量嵌入POST /v1/embeddings將文本批次向量化,自動適配上游 Embeddings 渠道。
重排序POST /v1/rerank根據 query 對候選 documents 進行相關性重排序,適用於 RAG 增強檢索。
影像生成POST /v1/images/generations文生圖介面,支援 DALL·E、FLUX、Midjourney 等生成模型。
影像編輯POST /v1/images/edits影像編輯與重繪,支援 JSON 及 multipart/form-data 上傳請求。
語音轉文字POST /v1/audio/transcriptionsWhisper 語音識別,將音訊轉錄為文本。
文字轉語音POST /v1/audio/speechTTS 語音合成,將文本渲染為高品質音訊流。
內容稽核POST /v1/moderations敏感內容過濾與合規檢測。
Responses APIPOST /v1/responsesOpenAI Responses 格式介面,支援上下文壓縮與高階事件處理。
即時對話GET /v1/realtime (WebSocket)OpenAI Realtime 風格全雙工即時低延遲語音/文本流介面。
模型列表GET /v1/models查詢當前可用模型列表,支援 OpenAI、Anthropic 及 Gemini 請求頭自適應響應格式。
模型詳情GET /v1/models/{model}查詢特定模型的配置與能力詳情。

這篇文件對您有幫助嗎?

🎮 線上演練與遊樂場 (Playground) | OpenRely Docs