CartesiaVoice

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/CartesiaVoice",
  "title": "CartesiaVoice",
  "type": "object",
  "properties": {
    "cachingEnabled": {
      "type": "boolean",
      "description": "This is the flag to toggle voice caching for the assistant.",
      "example": true,
      "default": true
    },
    "provider": {
      "type": "string",
      "description": "This is the voice provider that will be used.",
      "enum": [
        "cartesia"
      ]
    },
    "voiceId": {
      "type": "string",
      "description": "The ID of the particular voice you want to use."
    },
    "model": {
      "type": "string",
      "description": "This is the model that will be used. This is optional and will default to the correct model for the voiceId.",
      "enum": [
        "sonic-3",
        "sonic-3-2026-01-12",
        "sonic-3-2025-10-27",
        "sonic-2",
        "sonic-2-2025-06-11",
        "sonic-english",
        "sonic-multilingual",
        "sonic-preview",
        "sonic"
      ],
      "example": "sonic-english"
    },
    "language": {
      "type": "string",
      "description": "This is the language that will be used. This is optional and will default to the correct language for the voiceId.",
      "enum": [
        "ar",
        "bg",
        "bn",
        "cs",
        "da",
        "de",
        "el",
        "en",
        "es",
        "fi",
        "fr",
        "gu",
        "he",
        "hi",
        "hr",
        "hu",
        "id",
        "it",
        "ja",
        "ka",
        "kn",
        "ko",
        "ml",
        "mr",
        "ms",
        "nl",
        "no",
        "pa",
        "pl",
        "pt",
        "ro",
        "ru",
        "sk",
        "sv",
        "ta",
        "te",
        "th",
        "tl",
        "tr",
        "uk",
        "vi",
        "zh"
      ],
      "example": "en"
    },
    "experimentalControls": {
      "description": "Experimental controls for Cartesia voice generation",
      "allOf": [
        {
          "$ref": "#/components/schemas/CartesiaExperimentalControls"
        }
      ]
    },
    "generationConfig": {
      "description": "Generation config for fine-grained control of sonic-3 voice output (speed, volume, and experimental controls). Only available for sonic-3 model.",
      "allOf": [
        {
          "$ref": "#/components/schemas/CartesiaGenerationConfig"
        }
      ]
    },
    "pronunciationDictId": {
      "type": "string",
      "description": "Pronunciation dictionary ID for sonic-3. Allows custom pronunciations for specific words. Only available for sonic-3 model.",
      "example": "dict_abc123"
    },
    "chunkPlan": {
      "description": "This is the plan for chunking the model output before it is sent to the voice provider.",
      "allOf": [
        {
          "$ref": "#/components/schemas/ChunkPlan"
        }
      ]
    },
    "fallbackPlan": {
      "description": "This is the plan for voice provider fallbacks in the event that the primary voice provider fails.",
      "allOf": [
        {
          "$ref": "#/components/schemas/FallbackPlan"
        }
      ]
    }
  },
  "required": [
    "provider",
    "voiceId"
  ]
}