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

开发者文档

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

认证格式

Adicione sua API Key ao header Authorization em cada requisição.

POST/v1/chat/completions

带认证的请求示例

Exemplo de solicitação

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

Exemplo de resposta

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	Sim	ID do modelo, por exemplo gpt-4o-mini
`messages`	array	Sim	Array de mensagens de chat
`temperature`	number	Não	Temperatura de amostragem de 0 a 2, padrão 1
`max_tokens`	integer	Não	Número máximo de tokens a gerar
`stream`	boolean	Não	Se ativa a saída em streaming
`top_p`	number	Não	Valor de amostragem de núcleo, padrão 1

响应字段

字段	类型	说明
`id`	string	Identificador único da resposta
`object`	string	Tipo de objeto, normalmente chat.completion
`created`	integer	Carimbo de data/hora de criação
`model`	string	ID do modelo usado na resposta
`choices`	array	Opções de resposta geradas
`usage`	object	Estatí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	O corpo da requisição está malformado ou os parâmetros são inválidos	Verifique o corpo da requisição e os parâmetros
`401`	UNAUTHORIZED	A API Key é inválida ou expirou	Verifique se a API Key está correta
`429`	RATE_LIMIT	Limite de frequência de requisições excedido	Tente novamente com retentativa exponencial
`500`	INTERNAL_ERROR	Erro interno do serviço	Tente novamente mais tarde
`503`	SERVICE_UNAVAILABLE	Serviço temporariamente indisponível	Tente novamente mais tarde

限流说明

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

限流规则

Cada API Key tem seus próprios limites de frequência de requisições
Ao receber uma resposta 429, tente novamente com retentativa exponencial
Requisições com e sem streaming compartilham a mesma cota de limite de frequência
O limite efetivo segue a configuração atual da chave