Speechace
  • Introduction
    • Overview
    • Use-Cases
  • Getting Started
    • Pre-requisites
      • API Features
      • Getting the API Key
      • API Regions and endpoints
      • API Limits
    • API Samples
    • Supported Languages
    • API Versioning
    • Authentication
    • Try the Speechace API
    • Error Handling
      • Common Errors
      • Retry Strategies
  • Solutions
    • Speaking Practice for Language Learning
    • Automated Language Assessment with AI
    • Voice AI for Early Literacy
    • Test Prep for Standardized tests
      • PTE Speaking Questions
      • IELTS Speaking Questions
      • TOEFL Speaking Questions
      • CEFR Speaking Questions
      • TOEIC Speaking Questions
    • Speaking Practice in Spanish and French
  • Features
    • Introduction
    • Scripted activities
      • Pronunciation Scoring
        • Word and Sentence pronunciation
        • Multiple choice
        • Custom pronunciations
        • Phoneme list
      • Fluency scoring
        • Passage scoring
      • Lexical stress and intonation
    • Spontaneous activities
      • Open-ended scoring
        • Language scoring
        • Relevance scoring
        • Language detection
      • Task achievement scoring
        • Describe Image
        • Re-tell Lecture
        • Answer Question
  • API Reference
    • Postman API reference
    • Score Text/Pronunciation
      • Handling overall scores
      • Handling word scores
      • Handling phoneme and syllable scores
    • Score Text/Multiple choice
      • Handling multiple choice response
    • Score Text/Markup Language
      • Handling Markup Response
    • Score Text/Stress & Intonation
      • Handing stress and intonation response
    • Score Text/Phoneme list
      • Handling phoneme list response
    • Score Text/Fluency
      • Handling fluency response
      • Fidelity detection
    • Score Text/Validate Text
    • Score Speech/Open-ended
      • Handling language scores
      • Per metric feedback
        • Grammar metrics
        • Vocabulary metrics
        • Coherence metrics
    • Score Speech/Relevance
      • Handling relevance response
    • Score Speech/Language Detection
    • Score Task/Task Achievement
  • Guides on common topics
    • Intepreting quality score
    • Interpreting overall scores
      • Pronunciation Bands
      • Fluency Bands
      • Vocabulary Bands
      • Grammar Bands
      • Coherence Bands
    • Scoring rubrics
    • Interpreting fidelity class
    • Phonetic notation
      • US English (en-us)
      • UK English (en-gb)
      • French (fr-fr, fr-ca)
      • Spanish (es-es, es-mx)
    • Getting word timestamps in audio
    • Automatic handling of unknown words
    • Phoneme to letter mapping
    • Markup Language
  • Other Resources
    • Requesting Support
    • Rate Limiting
    • Data Retention
    • FAQs
    • Appendices
Powered by GitBook
On this page
  1. API Reference

Score Text/Stress & Intonation

PreviousHandling Markup ResponseNextHanding stress and intonation response

Last updated 6 months ago

Run in Postman:

If the include_intonation=1 parameter is included in the request body for , then the API result will include lexical and intonation metrics. In this example, lexical (word) stress and intonation (text stress) are evaluated in a given passage.

curl --location -g 'https://api.speechace.co/api/scoring/text/v9/json?key={{speechacekey}}&dialect=en-us' \
--form 'text="Some parents admire famous athletes as strong role models, so they name their children after them."' \
--form 'user_audio_file=@"someparents.wav"' \
--form 'include_intonation="1"'
{
  "status": "success",
  "quota_remaining": -1,
  "text_score": {
    "text": "Some parents admire famous athletes as strong role models, so they name their children after them.",
    "word_score_list": [
    {<...pronunciation metrices for other words>},
    {
        "word": "parents",
        "quality_score": 99,
        "phone_score_list": [
          {
            "phone": "p",
            "stress_level": null,
            "extent": [
              42,
              51
            ],
            "quality_score": 100,
            "sound_most_like": "p"
          },
          {
            "phone": "eh",
            "stress_level": 1,
            "extent": [
              51,
              57
            ],
            "quality_score": 100,
            "stress_score": 100,
            "predicted_stress_level": 1,
            "sound_most_like": "eh"
          },
          {
            "phone": "r",
            "stress_level": null,
            "extent": [
              57,
              66
            ],
            "quality_score": 100,
            "sound_most_like": "r"
          },
          {
            "phone": "ah",
            "stress_level": 0,
            "extent": [
              66,
              69
            ],
            "quality_score": 100,
            "stress_score": 100,
            "predicted_stress_level": 0,
            "sound_most_like": "ah"
          },
          {
            "phone": "n",
            "stress_level": null,
            "extent": [
              69,
              75
            ],
            "quality_score": 100,
            "sound_most_like": "n"
          },
          {
            "phone": "t",
            "stress_level": null,
            "extent": [
              75,
              76
            ],
            "quality_score": 94,
            "sound_most_like": "t"
          },
          {
            "phone": "s",
            "stress_level": null,
            "extent": [
              76,
              84
            ],
            "quality_score": 99.25,
            "sound_most_like": "s"
          }
        ],
        "syllable_score_list": [
          {
            "phone_count": 2,
            "stress_level": 1,
            "letters": "pa",
            "quality_score": 100,
            "stress_score": 100,
            "intonation": [
              null,
              "FALL"
            ],
            "pitch_range": [
              226.71435643564357,
              211.65643564356435
            ],
            "predicted_stress_level": 1,
            "extent": [
              42,
              57
            ]
          },
          {
            "phone_count": 5,
            "stress_level": 0,
            "letters": "rents",
            "quality_score": 99,
            "stress_score": 100,
            "intonation": [
              null,
              "FALL"
            ],
            "pitch_range": [
              211.65643564356435,
              184.5521782178218
            ],
            "predicted_stress_level": 0,
            "extent": [
              57,
              84
            ]
          }
        ]
      },
      {<...pronunciation metrices for other words>},
      ],
    "word_intonation_list": [
      {
        "word": "Some",
        "syllable_intonation_list": [
          [
            null,
            "FALL"
          ]
        ]
      },
      {
        "word": "parents",
        "syllable_intonation_list": [
          [
            null,
            "FALL"
          ],
          [
            null,
            "FALL"
          ]
        ]
      },
      {
        "word": "admire",
        "syllable_intonation_list": [
          [
            null,
            "FALL"
          ],
          [
            null,
            "FALL"
          ],
          [
            "FALL",
            "RISE"
          ]
        ]
      },
      {
        "word": "famous",
        "syllable_intonation_list": [
          [
            null,
            "RISE"
          ],
          [
            null,
            "FALL"
          ]
        ]
      },
      {
        "word": "athletes",
        "syllable_intonation_list": [
          [
            null,
            "FALL"
          ],
          [
            "RISE",
            "FALL"
          ]
        ]
      },
      {
        "word": "as",
        "syllable_intonation_list": [
          [
            "RISE",
            "FALL"
          ]
        ]
      },
      {
        "word": "strong",
        "syllable_intonation_list": [
          [
            null,
            "RISE"
          ]
        ]
      },
      {
        "word": "role",
        "syllable_intonation_list": [
          [
            null,
            "FALL"
          ]
        ]
      },
      {
        "word": "models",
        "syllable_intonation_list": [
          [
            null,
            "FALL"
          ],
          [
            null,
            "FALL"
          ]
        ]
      },
      {
        "word": "so",
        "syllable_intonation_list": [
          [
            null,
            "RISE"
          ]
        ]
      },
      {
        "word": "they",
        "syllable_intonation_list": [
          [
            null,
            "RISE"
          ]
        ]
      },
      {
        "word": "name",
        "syllable_intonation_list": [
          [
            "RISE",
            "FALL"
          ]
        ]
      },
      {
        "word": "their",
        "syllable_intonation_list": [
          [
            null,
            "FALL"
          ]
        ]
      },
      {
        "word": "children",
        "syllable_intonation_list": [
          [
            "RISE",
            "FALL"
          ],
          [
            null,
            "RISE"
          ]
        ]
      },
      {
        "word": "after",
        "syllable_intonation_list": [
          [
            "FALL",
            "RISE"
          ],
          [
            null,
            "FALL"
          ]
        ]
      },
      {
        "word": "them",
        "syllable_intonation_list": [
          [
            null,
            "FALL"
          ]
        ]
      }
    ],
    "ielts_score": {
      "pronunciation": 9
    },
    "pte_score": {
      "pronunciation": 89
    },
    "speechace_score": {
      "pronunciation": 99
    }
  },
  "version": "9.0"
}

Score Lexical Stress and Intonation
Score Text/Pronunciation