线上地址、鉴权和路由

这里作为字段、页面逻辑和路由备查。完整调用示例集中在调用指南；账号绑定、Key 生成和用量查询在账号页完成。

线上调用地址

https://api.linggantext.com

业务系统只调用这个地址。

文本调用鉴权

使用 `Authorization: Bearer ppai_xxx` 提交文本和查询任务。

账号管理鉴权

`ppacct_xxx` 只在账号页使用，用来查看额度、生成调用 Key 和查看用量。

请求字段速查

日常调用只需要 `input` 和 `target.platform`。省略 `capability` 时默认执行降 AI。

字段	是否必填	说明
input	必填	需要处理的论文文本
capability	可选	默认 `deai`；可选 `rewrite`、`rewrite_deai`
target.platform	必填	平台名称，见支持平台表
target.language	可选	默认 `zh`
mode	可选	默认 `sync`；未完成时返回任务查询地址
metadata	可选	业务侧任务 ID、订单 ID 或排查备注

响应状态

状态	含义	下一步
200	已处理完成	直接读取返回结果
202	任务还在处理	按返回的任务地址查询结果
401	Key 无效或缺失	检查 `ppai_` 或重新申请
429	额度不足	联系客服增加字符额度

支持平台字段

调用方只传 `target.platform`。服务端会按账号权限和平台策略选择实际处理档位。

platform	名称	语言	说明
cnki	知网 · 标准版	zh	适合知网送检场景，平衡降 AI、降重和表达自然度。
cnki-plus	知网 · 强化版	zh	适合标准版仍偏高的段落，处理强度更高。
vip	维普 · 标准版	zh	适合维普送检场景，默认优先使用的稳定策略。
vip-plus	维普 · 强化版	zh	适合维普高风险段落，整体处理更主动。
zhuque-ai-paper	朱雀AI · 论文版	zh	适合论文、期刊和毕业论文等正式学术文本。
zhuque-ai-daily	朱雀AI · 普通版	zh	适合课程作业、公众号、小说和非论文表达。
daya	大雅	zh	适合常见中文论文检测口径和日常文本处理。
gezida	格子达	zh	适合格子达毕设管理系统和课程论文场景。
wanfang	万方	zh	适合万方送检和中文论文检测场景。
paperpass	PaperPass · 标准版	zh	适合 PaperPass 检测场景，优先用于普通处理。
paperpass-plus	PaperPass · 强化版	zh	适合 PaperPass 仍偏高时的进一步处理。
paperyy	PaperYY	zh	适合中文论文、课程作业和 PaperYY 检测场景。
bigan	笔杆网	zh	适合中文学术写作和笔杆网检测场景。
turnitin	Turnitin	en	适合英文论文、留学作业和国际检测口径。

无需密钥的接口

方法	路径	说明
GET	/v1/overview	接入概览
GET	/v1/platforms	支持的平台
POST	/v1/usage/preview	字符预估，不扣费
GET	/v1/openapi.yaml	OpenAPI 合同

ppai_ 调用接口

方法	路径	说明
GET	/v1/me	校验当前 ppai_
POST	/v1/text-transformations	提交文本任务
GET	/v1/text-transformations/:id	查询自己的任务

页面对应的后端逻辑

页面	用户动作	后端接口
/	了解服务、申请密钥	公开页面，状态读取 `/v1/ready`
/models	查看可开通平台	`GET /v1/portal/models`
/pricing	查看价格和有效字符口径	公开页面
/dashboard	绑定 ppacct_、查看账号额度	`POST /v1/portal/session/bind`、`GET /v1/portal/account`
/dashboard/keys	生成和停用 ppai_	`POST /v1/portal/api-keys`、`POST /v1/portal/api-keys/:id/disable`
/dashboard/usage	查看用量和明细	`GET /v1/portal/usage/summary`、`GET /v1/portal/usage/events`
/playground	用账号下的 Key 测试一次	`POST /v1/portal/playground/text-transformations`
/admin	内部创建合作方账号	`POST /v1/admin/accounts`

账号管理接口

这些接口使用 `ppacct_`，只服务账号页、调用 Key 页、用量页和在线测试。

方法	路径	说明
POST	/v1/portal/session/bind	绑定账号
GET	/v1/portal/account	查看账号额度
POST	/v1/portal/api-keys	生成调用 Key
GET	/v1/portal/usage/summary	查看用量汇总
GET	/v1/portal/usage/events	查看调用明细
POST	/v1/portal/playground/text-transformations	账号页在线测试

查看调用指南 OpenAPI YAML

错误结构

所有错误都返回同一类结构。额度不足会返回 `429 quota_exceeded`。

{
  "error": {
    "message": "The API key does not have enough remaining character quota.",
    "type": "quota_error",
    "param": "authorization",
    "code": "quota_exceeded"
  },
  "request_id": "req_xxx"
}