标准兼容 · 鉴权 · 流式输出

开发者文档

集中说明 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 进行身份认证。

认证格式

เพิ่ม API Key ของคุณในเฮดเดอร์ Authorization ในทุกคำขอ

POST/v1/chat/completions

带认证的请求示例

ตัวอย่างคำขอ

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!"}]
  }'

ตัวอย่างการตอบกลับ

json

{
  "id": "chatcmpl_123",
  "object": "chat.completion",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you today?"
    }
  }]
}

聊天补全 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	ใช่	ID ของโมเดล เช่น gpt-4o-mini
`messages`	array	ใช่	อาเรย์ของข้อความแชท
`temperature`	number	ไม่	อุณหภูมิการสุ่มตั้งแต่ 0 ถึง 2 ค่าเริ่มต้น 1
`max_tokens`	integer	ไม่	จำนวน token สูงสุดที่จะสร้าง
`stream`	boolean	ไม่	เปิดใช้งานการสตรีมเอาต์พุตหรือไม่
`top_p`	number	ไม่	ค่าการสุ่มแบบ nucleus ค่าเริ่มต้น 1

响应字段

字段	类型	说明
`id`	string	ตัวระบุเฉพาะของการตอบกลับ
`object`	string	ประเภทออบเจ็กต์ โดยทั่วไปคือ chat.completion
`created`	integer	ประทับเวลาที่สร้าง
`model`	string	ID ของโมเดลที่ใช้ตอบกลับ
`choices`	array	ตัวเลือกการตอบกลับที่สร้างขึ้น
`usage`	object	สถิติการใช้ 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	รูปแบบคำขอผิดหรือพารามิเตอร์ไม่ถูกต้อง	ตรวจสอบรูปแบบและพารามิเตอร์ของเนื้อหาคำขอ
`401`	UNAUTHORIZED	API Key ไม่ถูกต้องหรือหมดอายุ	ตรวจสอบว่า API Key ถูกต้องหรือไม่
`429`	RATE_LIMIT	เกินขีดจำกัดอัตราคำขอ	ลองใหม่ด้วยกลยุทธ์หน่วงเวลาแบบเอ็กซ์โพเนนเชียล
`500`	INTERNAL_ERROR	ข้อผิดพลาดภายในของบริการ	ลองใหม่ภายหลัง
`503`	SERVICE_UNAVAILABLE	บริการไม่พร้อมใช้งานชั่วคราว	ลองใหม่ภายหลัง

限流说明

为了保证服务稳定性，我们对 API 请求进行频率限制。

限流规则

API Key แต่ละตัวมีการจำกัดอัตราคำขอแยกกัน
เมื่อได้รับการตอบกลับ 429 โปรดลองใหม่ด้วยกลยุทธ์หน่วงเวลาแบบเอ็กซ์โพเนนเชียล
คำขอแบบสตรีมและไม่สตรีมใช้โควตาการจำกัดอัตราเดียวกัน
ขีดจำกัดจริงขึ้นอยู่กับการตั้งค่าปัจจุบันของ Key