API 文档

快速入门

三分钟接入，无需修改现有代码。

认证

所有 API 请求通过 HTTP Header 中的 Bearer Token 进行认证。

Authorization: Bearer ***

API Key 可在控制台创建和管理，支持设置额度限制、IP 白名单与过期时间。

Chat Completions

与 OpenAI Chat Completions API 完全兼容。

Endpoint: POST /v1/chat/completions

from openai import OpenAI

client = OpenAI(
    base_url="https://api.kevoryn.com/v1",
    api_key="***"
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role":"user","content":"Hello"}]
)

print(response.choices[0].message.content)

Streaming

设置 stream=True 即可启用 SSE 流式输出，实时返回生成内容。

from openai import OpenAI

client = OpenAI(
    base_url="https://api.kevoryn.com/v1",
    api_key="***"
)

stream = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role":"user","content":"Hello"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

API 格式

除 OpenAI 格式外，Kevoryn 还原生支持 Anthropic 和 OpenAI Responses 格式，无需任何转换。使用 Claude Code、Claude 官方 SDK、沉浸式翻译等工具的用户可直接接入。

Anthropic 原生格式示例（Claude）：

curl https://api.kevoryn.com/v1/messages \
  -H "x-api-key: ***" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":1024,"messages":[{"role":"user","content":"Hello"}]}'

模型列表

通过 API 获取当前支持的模型列表。

Endpoint: GET /v1/models

协议支持矩阵

推荐默认优先使用 OpenAI Chat Completions；只有在客户端明确要求原生协议时，再切换到 Responses 或 Anthropic Messages。

常见坑 / 注意事项

客户端接入

Kevoryn 兼容所有支持 OpenAI 接口的客户端。通用配置：接口地址填 https://api.kevoryn.com/v1，密钥使用你在控制台创建的 key。以下是常用工具的配置方式。

错误码

API 使用标准 HTTP 状态码和 JSON 格式返回错误信息。

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "Insufficient balance",
    "type": "payment_required"
  }
}

{
  "error": {
    "message": "Model not found: gpt-5.5",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "Too many requests",
    "type": "rate_limit_error"
  }
}

错误响应示例（401 API Key 无效）：

{
  "code": "INVALID_API_KEY",
  "message": "Invalid API key"
}

速率限制

默认提供较宽松的调用频率；极端流量、异常请求或上游保护场景下，平台可能触发临时限流或风控策略。