YINGBOX / CONNECT

统一 AI，
简单接入。

为旗下 App 提供统一的对话、影视搜索计划、候选推荐和小学数学解题服务。

已有 App 后端

管理员添加模型供应商，在「App 接入」中创建 App ID，配置能力与额度。
将生成的服务凭证保存到 App 后端。后端校验用户身份与会员权限后，向官网申请 5 分钟令牌。
App 配置官网地址、App ID 和短期令牌，即可调用统一 API。令牌过期时通过自己的后端重新获取。

供应商、模型、提示词和额度都在官网维护。App 无需保存供应商密钥；服务凭证仅用于服务端。

App 端配置

baseURL: https://yingboxs.com/api/ai
appID: your-app-id
Authorization: Bearer <short-lived-token>
X-Yingbox-App: your-app-id

没有 App 后台也能接入

在「App 接入」选择「iOS 直接连接」，配置 Apple Team ID、Bundle ID、能力和设备额度。
App 只填写官网地址与 App ID。使用 Apple App Attest 登记设备密钥并验证后，由官网签发 5 分钟会话。
用会话调用对应能力，过期后通过设备验证续期。供应商、用量与每日备份均由官网统一维护。

LittleSprout 可使用专门的数学解题接口，只提交当前算式和年级。无需 App 自建后台或内置服务密钥。

一个接口，多款 App

POST /api/ai/chat
提交 message，返回 reply；也可提交 user / assistant 消息组成的 messages 进行多轮文本对话。

POST /api/ai/search-plan
提交 message，返回最多 3 个具体片名 keywords 和 reply。

POST /api/ai/recommendations
提交 message 和最多 60 条 candidates，返回来自候选的推荐 items 与理由。

POST /api/ai/v1/chat/completions
兼容 Chat Completions 文本请求，已有 App 后端可直接替换接口地址与 API Key。

POST /api/ai/math-explanation
提交 a、b、operation 和 grade，返回 title、steps 和 check，引导孩子理解小学口算题。

GET /api/ai/config
使用 App 凭证或短期令牌查询已开通能力与限额。

通用对话示例

POST /api/ai/chat
Content-Type: application/json
X-Yingbox-App: your-app-id
Authorization: Bearer <token>

{"message":"请帮我整理今天的计划"}

→ {"reply":"…","requestId":"…","usage":{…}}

按 App 管理

每个 App 有独立凭证、能力、供应商路由、系统提示词和额度。停用 App 后立即拒绝调用；轮换凭证会同时撤销旧令牌。

供应商维护或失败时，按优先级切换，每次最多尝试 3 个供应商，总耗时上限 120 秒。当前支持非流式文本，不支持工具、图片、音频与文件请求。

调用与数据

每用户小时额度、App 每日额度、官网每日额度共同生效，以 UTC 整点和日期结算。失败调用也计入额度。

官网保存配置和最近 30 天汇总用量，不保存对话正文。请求内容会发送给管理员配置的模型供应商；供应商的数据政策仍适用。App 应仅发送用户选择提供的必要信息。