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

开发者文档

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

认证格式

Añade tu API Key al header Authorization en cada solicitud.

POST/v1/chat/completions

带认证的请求示例

Ejemplo de solicitud

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

Ejemplo de respuesta

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	Sí	ID del modelo, por ejemplo gpt-4o-mini
`messages`	array	Sí	Array de mensajes de chat
`temperature`	number	No	Temperatura de muestreo de 0 a 2, predeterminado 1
`max_tokens`	integer	No	Número máximo de tokens a generar
`stream`	boolean	No	Si se habilita la salida en streaming
`top_p`	number	No	Valor de muestreo de núcleo, predeterminado 1

响应字段

字段	类型	说明
`id`	string	Identificador único de la respuesta
`object`	string	Tipo de objeto, normalmente chat.completion
`created`	integer	Marca de tiempo de creación
`model`	string	ID del modelo usado para la respuesta
`choices`	array	Opciones de respuesta generadas
`usage`	object	Estadísticas de uso de 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	El cuerpo de la solicitud tiene un formato incorrecto o los parámetros no son válidos	Revisa el cuerpo de la solicitud y los parámetros
`401`	UNAUTHORIZED	La API Key no es válida o ha caducado	Verifica que la API Key sea correcta
`429`	RATE_LIMIT	Se superó el límite de frecuencia de solicitudes	Reintenta con retroceso exponencial
`500`	INTERNAL_ERROR	Error interno del servicio	Inténtalo de nuevo más tarde
`503`	SERVICE_UNAVAILABLE	Servicio temporalmente no disponible	Inténtalo de nuevo más tarde

限流说明

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

限流规则

Cada API Key tiene sus propios límites de frecuencia de solicitudes
Cuando recibas una respuesta 429, reintenta con retroceso exponencial
Las solicitudes con y sin streaming comparten la misma cuota de límite de frecuencia
El límite efectivo depende de la configuración actual de la clave