标准兼容 · 鉴权 · 流式输出
开发者文档
集中说明 Base URL、鉴权、聊天补全、流式输出、错误码和限流。已有 API Key 时可以直接按示例接入。
快速开始
确认端点、配置密钥、接入客户端，然后发起首个请求。
选择接入端点
根据你的客户端类型选择合适的 API 端点。支持 Chat Completions、Responses 和 Messages 等标准兼容接口。
Base URL: https://new.weeanno.shop/v1准备 API Key
使用已经开通的 API Key，并只放在服务端环境变量中，避免暴露到浏览器代码。
Authorization: Bearer sk-your-api-key集成客户端
使用兼容客户端或直接调用 REST API，配置 base_url 后即可快速接入。
base_url = 'https://new.weeanno.shop/v1'开始调用
发送请求获取 AI 响应，支持流式输出以获得更好的用户体验。
POST /v1/chat/completions身份认证
所有 API 请求都需要在 HTTP Header 中携带 API Key 进行身份认证。
认证格式
Thêm API Key của bạn vào header Authorization trong mỗi yêu cầu.
POST
/v1/chat/completions带认证的请求示例
Ví dụ yêu cầu
json
curl https://new.weeanno.shop/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key" \
-d '{
"model": "deepseek-r1",
"messages": [{"role": "user", "content": "Hello!"}]
}'Ví dụ phản hồi
json
{
"id": "chatcmpl_123",
"object": "chat.completion",
"choices": [{
"message": {
"role": "assistant",
"content": "Hello! How can I help you today?"
}
}]
}推荐 Base URL
https://new.weeanno.shop/v1大部分客户端使用此地址备用 Base URL
https://new.weeanno.shop客户端验证失败时使用Chat Completions 兼容接口
/v1/chat/completions标准聊天补全协议Responses 兼容接口
/v1/responses支持 Responses 格式的客户端优先使用Messages 兼容接口
/v1/messagesMessages-compatible 客户端优先使用聊天补全 API
Chat Completions 兼容接口，支持多种模型能力。
curl
curl https://new.weeanno.shop/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key" \
-d '{
"model": "deepseek-r1",
"messages": [
{ "role": "system", "content": "你是一个简洁的助手。" },
{ "role": "user", "content": "用一句话介绍你自己。" }
]
}'请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | Có | ID mô hình, ví dụ gpt-4o-mini |
messages | array | Có | Mảng tin nhắn trò chuyện |
temperature | number | Không | Nhiệt độ lấy mẫu từ 0 đến 2, mặc định 1 |
max_tokens | integer | Không | Số token tối đa được tạo |
stream | boolean | Không | Có bật truyền phát hay không |
top_p | number | Không | Giá trị lấy mẫu nucleus, mặc định 1 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | Định danh duy nhất của phản hồi |
object | string | Loại đối tượng, thường là chat.completion |
created | integer | Dấu thời gian tạo |
model | string | ID mô hình dùng cho phản hồi |
choices | array | Các lựa chọn phản hồi được tạo |
usage | object | Thống kê sử dụng token |
流式输出
启用流式输出可以实时接收生成的 token，显著降低用户感知延迟。
流式输出的优势
- 降低感知延迟 - 用户无需等待完整响应，可以立即看到内容
- 更好的长文本体验 - 内容像人类打字一样逐步显示
- 成本相同 - 与同步输出成本完全一致，只是传输方式不同
curl
curl https://new.weeanno.shop/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key" \
-d '{
"model": "deepseek-r1",
"messages": [
{ "role": "system", "content": "你是一个简洁的助手。" },
{ "role": "user", "content": "用一句话介绍你自己。" }
],
"stream": true
}'
# 响应将是 SSE (Server-Sent Events) 流式数据错误码
API 可能返回的错误码及其处理建议。
| HTTP 状态码 | 错误名称 | 说明 | 处理建议 |
|---|---|---|---|
400 | INVALID_REQUEST | Định dạng yêu cầu sai hoặc tham số không hợp lệ | Kiểm tra định dạng và tham số của thân yêu cầu |
401 | UNAUTHORIZED | API Key không hợp lệ hoặc đã hết hạn | Kiểm tra xem API Key có đúng không |
429 | RATE_LIMIT | Vượt quá giới hạn tần suất yêu cầu | Thử lại với chiến lược lùi theo cấp số nhân |
500 | INTERNAL_ERROR | Lỗi nội bộ của dịch vụ | Thử lại sau |
503 | SERVICE_UNAVAILABLE | Dịch vụ tạm thời không khả dụng | Thử lại sau |
限流说明
为了保证服务稳定性，我们对 API 请求进行频率限制。
限流规则
- Mỗi API Key có giới hạn tần suất yêu cầu riêng
- Khi nhận phản hồi 429, hãy thử lại với chiến lược lùi theo cấp số nhân
- Yêu cầu truyền phát và không truyền phát dùng chung hạn ngạch giới hạn tần suất
- Giới hạn thực tế theo cấu hình hiện tại của Key