API 接口总览

Cloud AI 提供 OpenAI 和 Anthropic 兼容接口。所有请求均通过 HTTPS 发送。

基础地址https://cloud.examplea.xyz

接口列表

方法	路径	说明
GET	/v1/models	查询当前密钥可用模型
POST	/v1/chat/completions	OpenAI Chat Completions
POST	/v1/responses	OpenAI Responses API
POST	/v1/messages	Anthropic Messages API

OpenAI 鉴权

Authorization: Bearer sk-your-key
Content-Type: application/json

Anthropic 鉴权

x-api-key: sk-your-key
anthropic-version: 2023-06-01
Content-Type: application/json

模型与分组

请求体中的 model 必须是当前密钥所属分组支持的模型。不同密钥调用 /v1/models 可能得到不同列表，这是正常行为。

流式响应

支持流式的接口可设置：

{
  "stream": true
}

服务会通过 Server-Sent Events 持续返回数据。客户端应逐行读取事件，直到结束标记， 不要等待整个响应一次性完成。

超时和重试

• 普通对话建议客户端总超时不低于 120 秒。
• 长推理请求应使用更长的读取超时。
• 只对 429、502、503、504 和连接中断进行有限重试。
• 使用指数退避，不要立即高频重复提交。
• 非幂等业务应避免无条件重试，以免产生重复请求和费用。

请求大小

过大的上下文、图片或附件可能返回 413 Payload Too Large。应缩短历史消息、压缩附件， 并避免在单次请求中携带不必要的数据。