PetiLoop AI 控制台

使用与 PetMeet App 相同的账号。点击「发送验证码」会先弹出腾讯云验证码（与 captcha.html 同源逻辑：先请求 POST /auth/get-encrypted-appid，再加载 TJCaptcha.js）。若服务端未配置 TENCENT_CAPTCHA_* 导致无法拉取加密 AppId，将退回无 ticket 请求（production 可能返回「缺少验证码信息」，可临时设 ALLOW_SEND_CODE_WITHOUT_CAPTCHA=true 仅限可信网络）。

手机号

短信验证码

邮箱

密码

本月概览

当前套餐

—

本月已用

—

Token

月度额度

—

Token

调用次数

—

次

剩余 Token

—

本月按模型

优先按客户端请求的模型 id 聚合；默认/占位请求则按落库的真实模型 id（llm_token_usage.model，与 requestedModel 顶层字段配合）。占位名会归入「unknown」。

模型	调用次数	Token

套餐

Standard / Pro / Ultra 三档由数据库 petiloop_ai_plans 配置；卡片与下表文案来自接口字段 tagline、comparison。月额度为 0 表示不限制；开启超额拦截请设 PETILOOP_QUOTA_ENFORCED=true。

套餐对比

从用量、调度优先级、模型接入与能力四个维度快速对照（具体以当前套餐文档为准）。

模型偏好

服务端会自动合并后台 AI_Model 集合中所有已启用的文本模型，所以你在这里能直接看到并选用数据库里配置的所有模型（ID 格式为 ai_ + 文档 _id）。点击卡片选择你想要使用的模型。若模型支持 Function Calling，对话和工具调用会自动复用同一个模型。

默认（跟随服务端配置） → 使用服务端环境变量配置的方舟模型（ARK_CODE_MODEL / ARK_TOOLS_MODEL）。

当前选中

默认（跟随服务端配置）

添加新模型到 AI_Model

字段与后台 /api/admin/ai-models 创建接口一致；PetiLoop 带 tools 时若主 URL 为 coding，需填 tools 接入。

AI_Model 字段说明（与数据库/管理后台对齐）

必填：name、type、provider、model、baseURL
常用：description、endpoint（默认同 baseURL）、apiKey（可空，走 provider 环境变量）、isActive / status、version
config：默认含 max_tokens、temperature、supportsStreaming、supportsThinking（佩博士等用）
测试状态：testStatus、testResult、lastTestTime、lastTestError（创建时自动为未测试）
PetiLoop 扩展：toolsBaseURL、toolsModel（coding 端点 + function calling 时用）

模型名称 (name)

模型 ID (model)

提供商 (provider)

类型 (type)

Base URL (baseURL)

Endpoint（可选，默认同 baseURL）

API Key（可选，不填则用 provider 对应环境变量）

版本 (version)

状态 (status)

config · temperature

config · max_tokens

描述 (description)

启用模型 (isActive) 流式 (supportsStreaming) 思维链 (supportsThinking)

PetiLoop · toolsBaseURL（coding + tools 时填标准 v3 地址）

PetiLoop · toolsModel（带 tools 时的接入点模型 ID，如 ep-xxx）

config 高级 JSON（可选，会覆盖上方 temperature 等）

调用历史

来自集合 llm_token_usage（endpoint 为 petiloop / petiloop-stream）。仅展示摘要与 Token，不含完整对话内容。

时间	端点	请求模型	上游模型	Tokens	摘要

API Key 管理

你可以创建多个 API Key，用于不同客户端接入 PetiLoopAI。每个 Key 都绑定你的账号、套餐和用量统计。API Key 拥有完整调用权限，请妥善保管。

新 Key 名称

名称	前缀	创建时间	操作
加载中...

当前默认 API Key

Base URL

curl 示例

接入说明

1) Base URL（OpenAI 兼容）

自动获取当前域名，直接复制使用

2) 认证（二选一）

Header: Authorization: Bearer <pl_ 开头的 API Key>
或 Header: x-api-key: <同上>

API Key 在「API Key」标签页获取

3) 对话

POST /chat/completions
Body: OpenAI 格式 JSON，model 可以是：
- PetiLoopAI：用你在「模型偏好」选的对话模型
- 任意可见模型的 id（含 ai_<AI_Model._id>）

4) 模型列表

GET /v1/models

5) 控制台 API（需 JWT，与 App 登录相同）

GET  /api/petiloop-ai/console/overview
GET  /api/petiloop-ai/console/plans
POST /api/petiloop-ai/console/subscription/select  { "planCode": "standard" }
GET  /api/petiloop-ai/console/usage/summary
GET  /api/petiloop-ai/console/usage/history?page=1&pageSize=20
GET  /api/petiloop-ai/console/models/catalog
GET/PUT /api/petiloop-ai/console/model-settings
GET  /api/petiloop-ai/console/ai-model/:modelId   （modelId 为 ai_<_id> 或 _id，不含已存 apiKey）
PUT  /api/petiloop-ai/console/ai-model/:modelId   （body 同创建；apiKey 留空不改；clearApiKey:true 清空）

6) 数据库集合（请在 CloudBase 手动创建）

- petiloop_ai_plans：套餐定义
- petiloop_user_subscription：用户当前套餐
- petiloop_user_model_settings：用户模型覆盖
- petiloop_ai_models：（可选）模型目录，用于控制台展示与权限
已有：petiloop_user_api_keys、llm_token_usage

7) 索引建议

llm_token_usage: userId + endpoint + createdAt（列表与统计）

8) 月 Token 配额

默认不拦截超额；若要按套餐 monthlyTokenLimit 返回 429，请设置：
PETILOOP_QUOTA_ENFORCED=true

9) 本页地址

/petiloop-console/index.html

不能通过「本地文件」双击打开本页