API 接口概述

Kouri Ai 提供完全兼容 OpenAI API 格式的接口服务，同时支持 Anthropic、Gemini 等多种协议，让您可以轻松调用 GPT、Claude、Gemini、DeepSeek 等数十种旗舰级大模型。

接口端点

OpenAI 端点

端点类型	地址	说明
Chat Completions	`https://api.kourichat.com/v1/chat/completions`	聊天补全接口，适用于大多数模型
Responses	`https://api.kourichat.com/v1/responses`	Response 接口，推理模型必须使用
标准端点	`https://api.kourichat.com/v1`	SDK 推荐使用
基础端点	`https://api.kourichat.com`	部分应用使用

重要：gpt-5.2-pro、o3-pro 等部分模型仅支持 Response 接口，不支持 Chat Completions 接口。请根据模型要求选择正确的接口。

其他协议端点

协议类型	端点地址	说明
Anthropic 协议	`https://api.kourichat.com/v1/messages`	Claude 原生协议
Gemini 协议	`https://api.kourichat.com/v1beta`	Gemini 原生协议

模型兼容性说明：Anthropic 协议和 Gemini 协议接口支持调用所有模型（不限于 Claude 或 Gemini），而 OpenAI 协议的 Responses 接口仅支持特定推理模型。

认证方式

所有 API 请求都需要通过 API 令牌进行身份验证。您可以在控制台创建和管理令牌。

HTTP 请求头认证

在请求头中添加 Authorization 字段：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

完整请求示例

curl https://api.kourichat.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

安全提醒：请妥善保管您的 API 令牌，不要在客户端代码、公开仓库或日志中暴露令牌。

请求格式

所有 API 请求使用 JSON 格式：

Content-Type: application/json
请求方法: POST（聊天接口）、GET（查询接口）

基础请求结构

{
  "model": "模型名称",
  "messages": [
    {"role": "system", "content": "系统提示词"},
    {"role": "user", "content": "用户消息"}
  ],
  "temperature": 0.7,
  "max_tokens": 2048,
  "stream": false
}

常用参数说明

参数	类型	必填	说明
`model`	string	✅	模型名称，如 `gpt-4o`、`claude-sonnet-4-20250514`
`messages`	array	✅	消息列表，包含角色和内容
`temperature`	number	❌	随机性，0-2 之间，默认 1
`max_tokens`	integer	❌	最大输出 token 数
`stream`	boolean	❌	是否启用流式输出，默认 false
`top_p`	number	❌	核采样参数，0-1 之间

响应格式

标准响应

{
  "id": "chatcmpl-xxxxxxxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！有什么可以帮助您的吗？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

流式响应

启用 stream: true 后，响应将以 Server-Sent Events (SSE) 格式返回：

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"你"},"index":0}]}

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"好"},"index":0}]}

data: [DONE]

错误码

HTTP 状态码	错误类型	说明
400	Bad Request	请求参数错误
401	Unauthorized	令牌无效或未提供
403	Forbidden	无权访问该资源
404	Not Found	接口或模型不存在
429	Too Many Requests	请求频率超限
500	Internal Server Error	服务器内部错误
503	Service Unavailable	服务暂时不可用

错误响应示例

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

全模型聚合接口

Kouri Ai 提供全模型聚合访问能力，您可以通过标准的 ChatCompletion 接口访问所有聊天模型，包括：

OpenAI 系列：GPT-4o、GPT-4、o1、o3 等
Anthropic 系列：Claude Sonnet、Claude Opus 等
Google 系列：Gemini 2.5 Flash、Gemini 2.5 Pro 等
其他模型：DeepSeek、Qwen 等

Kouri Ai 针对不同协议做了兼容转换，您可以统一使用 /v1/chat/completions 接口调用所有模型，无需关心底层协议差异。

接口限制

请求频率：根据令牌类型和账户等级有所不同
单次请求超时：普通请求 5 分钟，复杂推理请求可能更长
最大消息长度：取决于所选模型的上下文窗口

如需更高的请求配额，请联系客服了解企业方案。

API 接口概述

On this page