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

开发者文档

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

认证格式

Ajoutez votre API Key à l'en-tête Authorization dans chaque requête.

POST/v1/chat/completions

带认证的请求示例

Exemple de requête

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

Exemple de réponse

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	Oui	ID du modèle, par exemple gpt-4o-mini
`messages`	array	Oui	Tableau de messages de chat
`temperature`	number	Non	Température d'échantillonnage de 0 à 2, par défaut 1
`max_tokens`	integer	Non	Nombre maximal de tokens à générer
`stream`	boolean	Non	Active ou non la sortie en streaming
`top_p`	number	Non	Valeur d'échantillonnage nucleus, par défaut 1

响应字段

字段	类型	说明
`id`	string	Identifiant unique de la réponse
`object`	string	Type d'objet, généralement chat.completion
`created`	integer	Horodatage de création
`model`	string	ID du modèle utilisé pour la réponse
`choices`	array	Choix de réponse générés
`usage`	object	Statistiques d'utilisation des tokens

流式输出

启用流式输出可以实时接收生成的 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	Le corps de la requête est mal formé ou les paramètres sont invalides	Vérifiez le corps de la requête et les paramètres
`401`	UNAUTHORIZED	L'API Key est invalide ou expirée	Vérifiez que l'API Key est correcte
`429`	RATE_LIMIT	Limite de fréquence des requêtes dépassée	Réessayez avec un backoff exponentiel
`500`	INTERNAL_ERROR	Erreur interne du service	Réessayez plus tard
`503`	SERVICE_UNAVAILABLE	Service temporairement indisponible	Réessayez plus tard

限流说明

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

限流规则

Chaque API Key dispose de ses propres limites de fréquence de requêtes
Utilisez un backoff exponentiel lorsque vous recevez une réponse 429
Les requêtes en streaming et hors streaming partagent le même quota de limite de fréquence
La limite effective suit la configuration actuelle de la clé