Api Reference

API 概述

ProxyCast API 端点和认证

API 概述

ProxyCast 提供 OpenAI 和 Claude 兼容的 API 端点。

支持的端点

OpenAI 兼容

端点方法说明
/v1/chat/completionsPOST聊天补全
/v1/modelsGET模型列表
/v1/embeddingsPOST文本嵌入

Claude 兼容

端点方法说明
/v1/messagesPOST消息 API
/v1/messages/count_tokensPOSTToken 计数

Amp CLI 路由

端点方法说明
/api/provider/{provider}/v1/chat/completionsPOSTAmp 聊天补全
/api/provider/{provider}/v1/messagesPOSTAmp 消息 API
/api/auth/*ANYAmp 认证代理
/api/user/*ANYAmp 用户代理

管理 API

端点方法说明
/v0/management/statusGET服务器状态
/v0/management/credentialsGET/POST/DELETE凭证管理
/v0/management/configGET/PUT配置管理

认证方式

OpenAI 格式

使用 Authorization 头:

curl http://127.0.0.1:9090/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '...'

Claude 格式

使用 x-api-key 头:

curl http://127.0.0.1:9090/v1/messages \
  -H "x-api-key: your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '...'

基础 URL

默认地址:http://127.0.0.1:9090

可在设置中修改主机和端口。

错误响应

错误格式

{
  "error": {
    "message": "错误描述",
    "type": "error_type",
    "code": "error_code"
  }
}

常见错误码

状态码说明
400请求格式错误
401认证失败
404端点不存在
429速率限制
500服务器错误
503服务不可用

下一步