Skip to main content

​
Overview

Evaluates pronunciation of brand and product names in audio. Requires at least one configuration parameter - Provide brand_name or product_name.

​
Configuration

​
config.brand_name
string
Brand name to evaluate.
​
config.product_name
string
Product name to evaluate.
​
config.brand_cue
string
Optional cue phrase for the brand name.
​
config.product_cue
string
Optional cue phrase for the product name.
​
config.brand_audio_url
string
Optional reference audio for brand pronunciation.Allowed extensions: mp3, wav, aac, flac, m4a
​
config.product_audio_url
string
Optional reference audio for product pronunciation.Allowed extensions: mp3, wav, aac, flac, m4a

​
Example Configuration

{
  "detector_name": "pronunciation",
  "config": {
    "brand_name": "Acme",
    "product_name": "Turbo Blender",
    "brand_audio_url": "gs://judge-artifacts/org_123/reference_uploads/acme_pronunciation.mp3"
  }
}

​
Result Schema

{
  "detector_name": "pronunciation",
  "pass_check": true,
  "score": 0.87,
  "rationale": "Overall pronunciation score: 0.87 (3/3 correct mentions).",
  "metrics": {
    "brand_mentions": [
      {
        "mention_number": 1,
        "pronunciation_correct": true,
        "clarity_score": 0.9,
        "confidence": 0.92,
        "feedback": "Clear pronunciation",
        "specific_issues": [],
        "phonetic_transcription": "ak-mee",
        "reference_audio_comparison": "very close"
      }
    ],
    "product_mentions": [],
    "summary": {
      "total_brand_mentions": 3,
      "total_product_mentions": 0,
      "total_correct_brand_mentions": 3,
      "total_correct_product_mentions": 0,
      "overall_score": 0.87,
      "suggestions": []
    },
    "brand_name": "Acme",
    "product_name": "Turbo Blender"
  }
}