API Server 是 ProxyCast 的核心组件，提供 OpenAI/Claude 兼容的 API 端点。
| 选项 | 默认值 | 说明 |
|---|---|---|
| 主机地址 | 127.0.0.1 | 监听地址 |
| 端口 | 9090 | 监听端口 |
| API Key | 自动生成 | 访问密钥 |
| 地址 | 说明 |
|---|---|
127.0.0.1 | 仅本机访问 |
0.0.0.0 | 允许局域网访问 |
0.0.0.0 时请确保配置了 API Key 认证。| 端点 | 方法 | 说明 |
|---|---|---|
/v1/chat/completions | POST | 聊天补全 |
/v1/models | GET | 模型列表 |
/v1/embeddings | POST | 文本嵌入 |
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/messages | POST | 消息 API |
/v1/messages/count_tokens | POST | Token 计数 |
每条日志包含：
支持按以下条件过滤：
启用 API Key 认证：
请求时需要携带 API Key：
OpenAI 格式:
curl http://127.0.0.1:9090/v1/chat/completions \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4", "messages": [...]}'
Claude 格式:
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 '{"model": "claude-3-sonnet", "messages": [...]}'
支持配置多个 API Key：
auth:
keys:
- name: "开发环境"
key: "dev-key-xxx"
- name: "生产环境"
key: "prod-key-xxx"
| 选项 | 默认值 | 说明 |
|---|---|---|
| 允许来源 | * | 允许的请求来源 |
| 允许方法 | GET,POST,OPTIONS | 允许的 HTTP 方法 |
| 允许头部 | * | 允许的请求头 |
cors:
origins:
- "http://localhost:3000"
- "https://myapp.com"
methods:
- GET
- POST
headers:
- Authorization
- Content-Type