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

开发者文档

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

认证格式

Tambahkan API Key anda ke header Authorization dalam setiap permintaan.

POST/v1/chat/completions

带认证的请求示例

Contoh permintaan

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

Contoh respons

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	Ya	ID model, contohnya gpt-4o-mini
`messages`	array	Ya	Tatasusunan mesej sembang
`temperature`	number	Tidak	Suhu pensampelan dari 0 hingga 2, lalai 1
`max_tokens`	integer	Tidak	Bilangan maksimum token untuk dijana
`stream`	boolean	Tidak	Sama ada untuk mengaktifkan output penstriman
`top_p`	number	Tidak	Nilai pensampelan nucleus, lalai 1

响应字段

字段	类型	说明
`id`	string	Pengecam unik respons
`object`	string	Jenis objek, biasanya chat.completion
`created`	integer	Cap masa penciptaan
`model`	string	ID model yang digunakan untuk respons
`choices`	array	Pilihan respons yang dijana
`usage`	object	Statistik penggunaan 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	Format permintaan salah atau parameter tidak sah	Semak format dan parameter badan permintaan
`401`	UNAUTHORIZED	API Key tidak sah atau telah tamat tempoh	Sahkan bahawa API Key betul
`429`	RATE_LIMIT	Had kadar permintaan melebihi	Cuba semula dengan strategi backoff eksponen
`500`	INTERNAL_ERROR	Ralat dalaman perkhidmatan	Cuba lagi kemudian
`503`	SERVICE_UNAVAILABLE	Perkhidmatan tidak tersedia buat sementara	Cuba lagi kemudian

限流说明

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

限流规则

Setiap API Key mempunyai had kadar permintaan tersendiri
Apabila menerima respons 429, cuba semula dengan strategi backoff eksponen
Permintaan penstriman dan bukan penstriman berkongsi kuota had kadar yang sama
Had berkesan mengikut konfigurasi semasa Key