API REFERENCE · V1

PandaLove API 接入文档

通过 OpenAI Chat Completions 或 Anthropic Messages 协议访问平台已启用的模型。支持 REST、SSE 流式输出、余额计费、配额与请求审计。

HTTPS · REST / SSE

快速开始

  1. 登录用户控制台并创建以 sk-pl- 开头的 API Key。
  2. 从模型页面或 GET /v1/models 获取当前可用模型 ID。
  3. 向下列端点发送请求，API Key 放在 Bearer Authorization 请求头中。
Base URLhttps://pandaloveapi.xyz/v1
Chat endpointPOST https://pandaloveapi.xyz/v1/chat/completions
Anthropic endpointPOST https://pandaloveapi.xyz/v1/messages

Anthropic SDK 配置

模型目录中协议为 Anthropic Messages 的模型可以直接使用 Anthropic SDK。Base URL 不要附加 /v1，SDK 会自动请求 /v1/messages。

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["PANDALOVE_API_KEY"],
    base_url="https://pandaloveapi.xyz",
)

message = client.messages.create(
    model="YOUR_CLAUDE_MODEL_ID",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(message.content[0].text)

curl

curl https://pandaloveapi.xyz/v1/messages \
  -H "x-api-key: $PANDALOVE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"YOUR_CLAUDE_MODEL_ID","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'
仅使用模型目录显示的公开模型 ID。平台会在内部选择 Claude Provider 和上游模型，不会向客户端暴露供应商密钥或内部模型 ID。

Windows 配置（PowerShell）

在 PowerShell 中使用环境变量保存 Key。环境变量仅对当前终端会话有效，关闭窗口后自动失效。

$env:PANDALOVE_API_KEY = "sk-pl-YOUR_KEY"

$headers = @{
  Authorization = "Bearer $env:PANDALOVE_API_KEY"
  "Content-Type" = "application/json"
}

$body = @{
  model = "gpt-5.6-sol"
  messages = @(@{ role = "user"; content = "你好" })
  stream = $false
} | ConvertTo-Json -Depth 8

Invoke-RestMethod `
  -Uri "https://pandaloveapi.xyz/v1/chat/completions" `
  -Method Post `
  -Headers $headers `
  -Body $body

Windows CMD 与 PowerShell 的引号、换行符不同；建议直接使用 PowerShell。不要把 Key 写入共享的 .bat 文件。

macOS / Linux 配置（Terminal）

在 zsh、bash 等 Shell 中使用 export 设置当前会话环境变量：

export PANDALOVE_API_KEY="sk-pl-YOUR_KEY"

curl https://pandaloveapi.xyz/v1/chat/completions \
  -H "Authorization: Bearer $PANDALOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role":"user","content":"你好"}],
    "stream": false
  }'

如需长期保存环境变量，可加入仅本人可读的 Shell 配置或密钥管理工具；不要将真实 Key 提交到 Git。

OpenAI SDK 配置

将 SDK 的 base_url 指向 PandaLove。SDK 会自动拼接 /chat/completions。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["PANDALOVE_API_KEY"],
    base_url="https://pandaloveapi.xyz/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

Chatbox 等 OpenAI 兼容客户端

API Hosthttps://pandaloveapi.xyz/v1
API Keysk-pl-你的用户密钥
模型从模型列表中选择准确 ID
平台内部可以将 Chat Completions 请求转换为上游 Responses 协议，但用户侧调用方式保持不变。除文档另行公布外，请勿直接调用 PandaLove 的 /v1/responses。

SSE 流式输出

设置 stream: true 后，响应类型为 text/event-stream。每个事件以 data: 开头，最后一个事件为 [DONE]。

curl -N https://pandaloveapi.xyz/v1/chat/completions \
  -H "Authorization: Bearer $PANDALOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"解释流式输出"}],"stream":true}'

流式请求中途断开时可能无法获得完整用量；客户端应处理网络中断、超时、重复请求和最终 [DONE] 事件。

错误与重试

400请求格式、模型参数或消息内容无效；修正请求后再试。
401API Key 缺失、错误或已失效；不要盲目重试。
402 / 403余额不足、账户停用或权限不足。
429触发 RPM、TPM、消费或并发限制；遵循 Retry-After 并指数退避。
5xx平台或上游暂时不可用；使用带抖动的指数退避，限制最大重试次数。

安全建议

  • API Key 只能保存在服务端环境变量或密钥管理系统中。
  • 为不同项目创建不同 Key，并配置模型权限和每日/月度消费上限。
  • 禁止在网页 JavaScript、桌面安装包、移动应用或公开代码仓库中硬编码 Key。
  • 发现泄露后立即停用旧 Key、创建新 Key，并检查调用日志和余额。
  • 生产请求应设置合理超时、并发限制、幂等策略和日志脱敏。