## 功能描述
评分任何英文文本或网址的可读性 返回5个行业标准的可读性评分 可操作的通俗建议 句子级别的拆分,并标记出最难的句子 以及可选的目标年级通过/不通过
## 返回的评分
- **Flesch可读性** — 0–100 分 评分越高 = 阅读越容易
- **Flesch-Kincaid年级** — 美国学校年级的等价
- **Gunning Fog Index** — 理解所需的教育年限
- **自动可读性指数(ARI)** — 通过字符/单词比例确定的年级水平
- **SMOG指数** — 通过多音节单词密度确定的年级水平
## 使用案例
内容团队 法律/合规 EdTech 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/12903/technical+writing+readability+api/25683/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/12903/technical+writing+readability+api/25684/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` 端点提供两个文本的并排比较 包括它们的可读性分数 年级水平 以及哪个文本更容易阅读的总结
关键字段包括`success`、`textStats`(词数、句数和字符数)、`scores`(多种可读性指标)、`overall`(平均年级水平和判决)、`suggestions`和`sentenceBreakdown`以进行详细分析
端点 `POST /api/analyze` 接受要分析的文本或 URL 以及可选的目标评分进行评估 端点 `POST /api/compare` 需要两个文本进行比较 用户可以通过提供不同的文本或 URLs 来定制请求
响应数据采用JSON格式结构化,顶层键指示成功状态,随后是文本统计、可读性评分、整体评估、建议和句子细分的嵌套对象,便于解析和使用
典型的使用案例包括创建内容以提高清晰度简化法律文件评估教育材料搜索引擎优化和营销文案的A/B测试帮助团队确保他们的沟通有效且易于获取
用户可以利用可读性分数来识别复杂的句子并提高文本的清晰性 建议可以指导修订而句子分解有助于识别需要简化的特定领域提高沟通的整体质量
该API采用了已有的可读性公式,确保评分的一致性和可靠性 定期更新和针对各种文本样本的测试有助于保持可读性评估的准确性和相关性
用户可以期待从0到100的一系列可读性评分 分数越高表示可读性越容易 平均年级水平通常在1到12之间 反映理解文本所需的教育水平 允许对文本复杂性进行快速评估
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
670ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
637ms
服务级别:
100%
响应时间:
2,125ms