Vapi · Schema

HumeVoice

AIVoiceAgentsRealtimeCPaaS

Properties

Name Type Description
cachingEnabled boolean This is the flag to toggle voice caching for the assistant.
provider string This is the voice provider that will be used.
model string This is the model that will be used.
voiceId string The ID of the particular voice you want to use.
isCustomHumeVoice boolean Indicates whether the chosen voice is a preset Hume AI voice or a custom voice.
chunkPlan object This is the plan for chunking the model output before it is sent to the voice provider.
description string Natural language instructions describing how the synthesized speech should sound, including but not limited to tone, intonation, pacing, and accent (e.g., 'a soft, gentle voice with a strong British a
fallbackPlan object This is the plan for voice provider fallbacks in the event that the primary voice provider fails.
View JSON Schema on GitHub

JSON Schema

vapi-humevoice-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/HumeVoice",
  "title": "HumeVoice",
  "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": [
        "hume"
      ]
    },
    "model": {
      "type": "string",
      "description": "This is the model that will be used.",
      "enum": [
        "octave",
        "octave2"
      ],
      "example": "octave2"
    },
    "voiceId": {
      "type": "string",
      "description": "The ID of the particular voice you want to use."
    },
    "isCustomHumeVoice": {
      "type": "boolean",
      "description": "Indicates whether the chosen voice is a preset Hume AI voice or a custom voice.",
      "example": false
    },
    "chunkPlan": {
      "description": "This is the plan for chunking the model output before it is sent to the voice provider.",
      "allOf": [
        {
          "$ref": "#/components/schemas/ChunkPlan"
        }
      ]
    },
    "description": {
      "type": "string",
      "description": "Natural language instructions describing how the synthesized speech should sound, including but not limited to tone, intonation, pacing, and accent (e.g., 'a soft, gentle voice with a strong British accent').\n\nIf a Voice is specified in the request, this description serves as acting instructions.\nIf no Voice is specified, a new voice is generated based on this description."
    },
    "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"
  ]
}