pronunciation - Judge API

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"
  }
}

​Overview

​Configuration

​Example Configuration

​Result Schema

Overview

Configuration

Example Configuration

Result Schema