SuperAPI AI 工具集

pinme-api

编程与开发

查看项目

更新于 10-16 05:49

技能介绍

用途:该技能用于在 PinMe 项目的 Worker(TypeScript)中集成平台能力,主要覆盖邮件发送与 LLM 对话补全两类 API 调用,供 AI 生成对应的调用代码。

环境变量:Worker 创建时会自动注入以下变量,无需手动配置。Env 接口含 DB(D1Database)、API_KEY(项目 API Key,用于 send_email 与 chat/completions 鉴权)以及可选的 BASE_URL(PinMe API 基地址覆盖,默认 https://pinme.cloud)。API_KEY 是 Worker 调用平台 API 的唯一凭据。

API 1 发邮件:POST {BASE_URL}/api/v4/send_email,使用 X-API-Key 头鉴权,发件人自动设为 {project_name}@pinme.cloud。请求体需 to、subject、html 三个必填字符串字段;成功返回 { code: 200, msg: "ok", data: { ok: true } }。错误包括 401(API Key 缺失或无效)、400(参数校验失败)、500(邮件服务错误)。

API 2 LLM 对话:POST {BASE_URL}/api/v1/chat/completions?project_name={project_name},使用 X-API-Key 头鉴权,请求体为 OpenAI 兼容格式并原样转发,支持 stream: true 的 SSE 流式输出。project_name 从 Worker 子域名解析(如 my-app-1a2b.pinme.pro 取首段);可用模型参见 PinMe LLM 支持模型列表。非流式返回标准 chat completion(含 choices、usage);流式返回 SSE,以 data: 行输出增量内容,结束时为 data: [DONE]。错误包括 401(密钥或项目名无效)、400(project_name 缺失或项目未配置 LLM)、413(请求体超过 1MB)、502(LLM 服务不可用)。

使用方式:资料给出 sendEmail、callLLM、流式透传及统一 callPinmeAPI 错误处理的 TypeScript 示例,并包含前端消费 SSE 流的 streamChat 示例;可据此在路由中调用。

限制:请求体上限 1MB;LLM 需项目已配置否则返回 400;发送邮件有 401/400/500 错误分支,需自行处理。模型清单、配额与计费资料未提供。