跳转到主要内容
OpenPAI 同时暴露三套协议端点,你可以按现有代码或上游模型自由选择。

​
端点速查

协议Base URL鉴权头适合
OpenAI 兼容https://openp.ai/v1Authorization: Bearer sk-...已有 OpenAI SDK 代码 / 大部分模型
Claude Messageshttps://openp.ai/v1/messagesx-api-key: sk-... + anthropic-versionClaude thinking / cache_control 高级特性
Gemini 原生https://openp.ai/v1beta/models/{model}:...x-goog-api-key: sk-...Gemini 多模态、function_declarations
同一把 sk- 密钥可同时使用三套端点,共享账户额度。

​
接口分类

OpenAI 兼容

/v1/chat/completions、/v1/embeddings、/v1/images/*、/v1/audio/*、/v1/responses、/v1/realtime

Claude Messages

/v1/messages、/v1/messages/count_tokens

Gemini 原生

:generateContent、:streamGenerateContent、:embedContent

Rerank

/v1/rerank —— Cohere / Jina 兼容

Midjourney

/mj/submit/*、/mj/task/{id}/fetch

Suno

/suno/submit/music、/suno/fetch/{id}

​
通用约定

  • 协议:HTTPS,推荐 HTTP/2(curl --http2)。
  • 编码:Content-Type: application/json; charset=utf-8。
  • 超时:服务端默认 600 秒。流式响应可保持长连接,空闲心跳每 15 秒。
  • 请求体大小:默认上限 32 MB(压缩后)。
  • 响应头:
    • X-OpenPAI-Request-Id:本次请求 ID,工单沟通时附上可加速排查。
    • X-OpenPAI-Group:本次走的用户分组。
    • X-OpenPAI-Quota-Consumed:本次扣费金额。
    • X-OpenPAI-Remaining-Quota:扣费后账户剩余额度。

​
下一步

鉴权

三套协议的鉴权头格式与示例。

错误码

HTTP 状态、错误结构与排查建议。

限流

RPM / TPM 限制与 429 处理。