SuperAPI AI 工具集

grammarly-hello-world

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:这是一个 Grammarly 集成的最小可用示例,用于在新建集成、测试环境或学习 Grammarly API 基础用法时,对文本进行评分与检测。

主要能力:调用写作评分接口(POST https://api.grammarly.com/ecosystem/api/v2/scores)返回总分及 engagement、correctness、clarity、tone 子分;调用 AI 检测接口(/v1/ai-detection)返回 0-100 的 score,越高越可能为 AI 生成;调用查重接口(/v1/plagiarism)先创建请求再轮询结果,返回 score 与 matches。

使用前提:需先完成 grammarly-install-auth 配置,并持有带 scores-api:read 权限的有效访问令牌,通过环境变量 GRAMMARLY_ACCESS_TOKEN 提供。

使用方式:示例代码使用 fetch 携带 Authorization: Bearer 令牌与 Content-Type: application/json,请求体为 {"text": ...};查重需以 3 秒间隔轮询直到状态不再为 pending。也可用 curl 快速测试:curl -X POST https://api.grammarly.com/ecosystem/api/v2/scores -H "Authorization: Bearer $GRAMMARLY_ACCESS_TOKEN" -H "Content-Type: application/json" -d '{"text": "This is a test sentence."}' | python3 -m json.tool

错误处理:401 表示令牌过期需重新认证;400 表示文本过短(少于 30 词);413 表示超过 10 万字符需分块;429 为限流需退避重试。

限制:文本最少 30 词、最大 100000 字符;其余费用、价格与平台支持情况资料未提供。