从拿到密钥到跑通一次请求

这里集中说明接入步骤、请求字段、平台参数、响应状态和常见代码示例。账号绑定、Key 生成和用量查看在账号页完成。

先确认四件事

调用地址是 `https://api.linggantext.com`；调用 Key 是 `ppai_`；提交接口是 `POST /v1/text-transformations`；平台名称由客服按账号开通。

生成调用 Key 查看价格

1. 申请账号

联系客服，备注“申请密钥”。说明预计调用量、业务系统和需要的平台范围。

2. 生成 Key

管理员用 `ppacct_` 登录账号页，为业务系统生成 `ppai_` 调用 Key。

3. 提交文本

业务系统用 `ppai_` 提交论文文本。默认能力是降 AI，可按需改为降重或组合处理。

4. 查看用量

成功任务会写入用量明细，可按 Key、平台、能力和有效字符对账。

1. 最小 cURL

示例里只使用占位符，不包含真实密钥。`Idempotency-Key` 由调用方生成，用于安全重试。

curl -X POST https://api.linggantext.com/v1/text-transformations \
  -H "Authorization: Bearer $LINGGAN_API_KEY" \
  -H "Idempotency-Key: partner-task-001" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "需要处理的论文文本",
    "target": {
      "platform": "cnki",
      "language": "zh"
    },
    "mode": "sync"
  }'

2. 最小请求体

调用方只传平台名称；处理档位由平台配置决定。省略 `capability` 时默认执行降 AI。

{
  "input": "需要处理的论文文本",
  "target": {
    "platform": "cnki",
    "language": "zh"
  },
  "mode": "sync"
}

3. 必填和可选字段

字段	是否必填	说明
input	必填	需要处理的论文文本
target.platform	必填	平台名称，例如 `cnki`、`vip`、`paperpass`
capability	可选	默认 `deai`；可选 `rewrite`、`rewrite_deai`
target.language	可选	默认 `zh`
mode	可选	默认 `sync`；未完成时返回任务查询地址
metadata	可选	可放业务侧任务 ID、用户 ID 或订单 ID，方便内部排查

4. 平台参数

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

5. 任务查询

如果短时间内完成，提交接口返回 200；还在处理时返回 202，并带查询地址 `Location`。

curl https://api.linggantext.com/v1/text-transformations/txt_xxx \
  -H "Authorization: Bearer $LINGGAN_API_KEY"

6. 字符预估

预估接口不创建任务、不扣费，适合在提交前展示预计字符数。

curl -X POST https://api.linggantext.com/v1/usage/preview \
  -H "Content-Type: application/json" \
  -d '{"input":"需要处理的论文文本","target":{"language":"zh"}}'

Node fetch

const response = await fetch("https://api.linggantext.com/v1/text-transformations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.LINGGAN_API_KEY,
    "Idempotency-Key": "partner-task-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    input: "需要处理的论文文本",
    target: { platform: "cnki", language: "zh" },
    mode: "sync"
  })
});

const data = await response.json();

Python requests

import os
import requests

response = requests.post(
    "https://api.linggantext.com/v1/text-transformations",
    headers={
        "Authorization": f"Bearer {os.environ['LINGGAN_API_KEY']}",
        "Idempotency-Key": "partner-task-001",
    },
    json={
        "input": "需要处理的论文文本",
        "target": {"platform": "cnki", "language": "zh"},
        "mode": "sync",
    },
    timeout=60,
)
data = response.json()