使用指南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