API 文档 - 多模型网关

概述

本网关提供 OpenAI 兼容的 POST /v1/chat/completions 接口，聚合多模型（Kimi、Qwen、GLM、DeepSeek、GPT、Gemini、Llama、Claude、豆包等）。需先注册并申请 API 密钥，控制台与注册入口见登录/控制台。

鉴权

请求头携带：Authorization: Bearer <你的API密钥>

接口

POST /v1/chat/completions — 对话（OpenAI 格式），支持 model、messages、stream 等。
POST /v1/messages — 对话（Anthropic Messages 格式），供 Claude Code 等直接接入，使用网关内所有模型。
POST /v1/messages/count_tokens — 估算 token 数（Anthropic 兼容）。
GET /health — 健康检查与可用 provider 列表。
GET /api/models — 模型列表（供前端展示，返回 { models: [{ id, label }] }）。
GET /v1/models — 模型列表（OpenAI 兼容格式 { object: "list", data: [{ id, object: "model", ... }] }，与 /api/models 同一数据源）。

模型

请求时 model 可选：kimi-k2.5、qwen-max、qwen3-max、glm-4、deepseek-chat、gpt-oss:120b、gemini-3-flash-preview、llama-3.1-8b-instant、claude-opus-4-6、doubao-seed-1-6-251015 等。

示例

将 YOUR_API_KEY 替换为你的密钥，https://modelapi.violetteam.cloud 可改为当前域名。

curl -X POST "https://modelapi.violetteam.cloud/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"你好"}]}'

import requests
r = requests.post(
    "https://modelapi.violetteam.cloud/v1/chat/completions",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json={"model": "deepseek-chat", "messages": [{"role": "user", "content": "你好"}]}
)
print(r.json())