## 它的功能
评估任何英语文本或网址的可读性。返回5个行业标准的可读性分数,切实可行的简单英语建议,按句子级别的细分及标记的难句,以及可选的目标年级合格/不合格。
## 返回的分数
- **Flesch可读性指数** — 0–100。越高=越容易阅读。
- **Flesch-Kincaid年级** — 相当于美国学校年级。
- **Gunning Fog指数** — 理解所需的教育年数。
- **自动可读性指数(ARI)** — 通过字符/单词比率得出的年级水平。
- **SMOG指数** — 通过多音节单词密度得出的年级水平。
## 使用场景
内容团队,法律/合规,教育科技,搜索引擎优化工具,内容管理系统管道,A/B文案测试。
## 端点
- `POST /api/analyze` — 分析文本或网址,带可选的目标年级
- `POST /api/compare` — 并排比较两个文本
{"success":true,"textStats":{"wordCount":18,"sentenceCount":2,"characterCount":85,"avgSentenceLength":9,"avgSyllablesPerWord":1.56,"polysyllabicWordCount":1,"polysyllabicWordPercentage":5.6},"scores":{"fleschReadingEase":{"score":66.1,"interpretation":"Standard","suitableFor":"Age 15–17"},"fleschKincaidGrade":{"score":6.3,"interpretation":"US Grade 6 reading level"},"gunningFog":{"score":5.8,"interpretation":"Very easy"},"automatedReadabilityIndex":{"score":5.3,"interpretation":"Roughly Grade 5 reading level"},"smogIndex":{"score":6.9,"interpretation":"Grade 7 reading level","note":"SMOG is most accurate with 30+ sentences"}},"overall":{"averageGradeLevel":6.1,"verdict":"Easy read","recommendedFor":"Most adults","plainEnglishScore":70},"suggestions":["Text is short (18 words). Readability scores are most reliable with 100+ words."],"sentenceBreakdown":{"all":[{"index":1,"sentence":"The quick brown fox jumps over the lazy dog.","wordCount":9,"fre":94.3,"grade":2.3,"complexity":"Easy"},{"index":2,"sentence":"This is a simple sentence for testing readability scores.","wordCount":9,"fre":37.9,"grade":10.2,"complexity":"Hard"}],"hardest":[{"index":2,"sentence":"This is a simple sentence for testing readability scores.","wordCount":9,"fre":37.9,"grade":10.2,"complexity":"Hard"},{"index":1,"sentence":"The quick brown fox jumps over the lazy dog.","wordCount":9,"fre":94.3,"grade":2.3,"complexity":"Easy"}]}}
curl --location --request POST 'https://zylalabs.com/api/12906/academic+readability+analysis+api/25689/analizar' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"text": "The quick brown fox jumps over the lazy dog. This is a simple sentence for testing readability scores."}'
{"success":true,"text_a":{"fleschReadingEase":100,"gradeLevel":2.1,"verdict":"Very easy read","wordCount":11},"text_b":{"fleschReadingEase":0,"gradeLevel":19.4,"verdict":"Highly technical","wordCount":15},"comparison":{"moreReadable":"text_a","easeDifference":100,"gradeDifference":17.3,"summary":"text_a is easier to read by 100.0 Flesch points"}}
curl --location --request POST 'https://zylalabs.com/api/12906/academic+readability+analysis+api/25690/comparar' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"text_a": "The cat sat on the mat. It was a sunny day.", "text_b": "The feline proceeded to position itself upon the horizontal surface whilst meteorological conditions remained favourable."}'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
`POST /api/analyze` 端点返回可读性得分、建议、句子分解和一个可选的目标年级结果 `POST /api/compare` 端点提供两个文本的并排比较,包括 Flesch 得分、年级水平和可读性裁定
关键字段包括 `wordCount` `sentenceCount` `scores` (如 `fleschReadingEase` 和 `gunningFog`) `overall` (包含 `averageGradeLevel` 和 `verdict`)以及 `suggestions` 以改善 每个字段提供有关文本可读性的信息
响应数据的结构采用JSON格式 对于`POST /api/analyze` 包括`textStats` `scores` `overall` `suggestions`和`sentenceBreakdown` 对于`POST /api/compare` 包含`text_a` `text_b`和`comparison`部分以便于可读性评估
`POST /api/analyze` 端点接受参数,例如要分析的文本或 URL 和一个可选的评估目标等级 `POST /api/compare` 端点需要两个文本进行比较
用户可以通过提供特定文本或 URL 进行分析并在 `POST /api/analyze` 端点设置目标年级水平来自定义请求这允许根据用户需求进行量身定制的可读性评估
典型的使用案例包括创建内容以提高清晰度 遵守法律文件 开发教育材料 SEO优化 和测试A/B广告文本 API帮助确保文本符合其目标受众的可读性标准
数据的精确性通过使用被广泛认可的Flesch和Gunning Fog等可读性公式来保持 这两个公式在语言研究中都是受到广泛认可的 API的算法旨在提供一致可靠的可读性评估
用户可以期待更高的弗莱施阅读难易度得分表明文本较易,而较低的得分则暗示复杂性。此外,平均年级水平通常与可读性得分相关联,提供对文本难度的清晰理解
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
637ms
服务级别:
100%
响应时间:
670ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
689ms