## 它的功能
评估任何英语文本或网址的可读性。返回5个行业标准可读性分数,可操作的简单英语建议,逐句分解并标记最难理解的句子,以及可选的目标年级合格/不合格。
## 返回的分数
- **Flesch 可读性指数** — 0–100。分数越高,阅读越容易。
- **Flesch-Kincaid 年级** — 相当于美国学校的年级。
- **Gunning Fog 指数** — 理解所需的教育年限。
- **自动可读性指数(ARI)** — 通过字符/单词比例来确定年级水平。
- **SMOG 指数** — 通过多音节词密度来确定年级水平。
## 使用场景
内容团队、法律/合规、教育科技、SEO工具、CMS管道、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/12902/seo+optimization+readability+api/25677/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/12902/seo+optimization+readability+api/25678/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` 提供两个文本的并排比较 包括它们的可读性分数 年级水平 和哪个文本更容易阅读的摘要
响应中的关键字段包括 `wordCount` `sentenceCount` `scores`(其中包含各种可读性指标)`suggestions` 和 `sentenceBreakdown` 用于详细分析 每个分数包括一个 `score` 值和一个 `interpretation`
端点 `POST /api/analyze` 接受要分析的文本或URL的参数和一个可选的目标评分 端点 `POST /api/compare` 需要两个文本进行比较 用户可以通过提供不同的文本或URL来定制请求
响应数据采用 JSON 格式构建 包括一个 `success` 布尔值 以及详细的统计信息如 `textStats` `scores` `overall` `suggestions` 和 `sentenceBreakdown 方便用户轻松访问和解释结果
典型的用例包括优化SEO内容 确保法律文件易于理解 改善教育科技领域的教学材料以及进行营销文案的A/B测试 该API帮助提高各种内容的可读性
数据准确性通过使用已建立的可读性公式如Flesch阅读易读性和Gunning Fog指数得以保持 这些公式基于语言学研究并在行业内广泛认可 确保可靠的结果
用户可以预期可读性得分范围从0到100较高的得分表示更容易阅读级别通常与美国的年级对齐提供对文本复杂性的清晰理解
用户可以利用可读性评分根据特定受众调整内容,并使用建议来提高清晰度 句子的细分有助于识别复杂句子,从而进行具体修订以提高整体可读性
服务级别:
100%
响应时间:
1,249ms
服务级别:
100%
响应时间:
1,867ms
服务级别:
100%
响应时间:
2,921ms
服务级别:
100%
响应时间:
2,559ms
服务级别:
100%
响应时间:
1,512ms
服务级别:
100%
响应时间:
581ms
服务级别:
100%
响应时间:
39ms
服务级别:
100%
响应时间:
1,130ms
服务级别:
100%
响应时间:
2,643ms
服务级别:
100%
响应时间:
4,671ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
670ms
服务级别:
100%
响应时间:
637ms
服务级别:
100%
响应时间:
1,213ms
服务级别:
100%
响应时间:
2,973ms