The actual response body shapes for every status code you’ll see.
Kova returns JSON error bodies for every status code except 500, which returns plain text. The HTTP status is the primary signal; the JSON body carries an error or detail field.
Do not assume error bodies are JSON. A 500 returns Content-Type: text/plain with the literal body Internal Server Error. Calling .json() on it will throw. Guard every error parse.
Two distinct shapes, depending on where the request was rejected.Missing or malformed key — rejected at the gateway:
{"error": "Invalid or missing API key"}
Returned when the x-api-key header is absent, or its value doesn’t begin with kova_sk_. Also returned if you send Authorization: Bearer <key> instead — Kova does not accept bearer tokens.Well-formed but unknown key — rejected at the billing service:
{"error": "INVALID_API_KEY"}
The header parsed correctly but the key doesn’t exist or has been revoked.Fix: Verify the header name and value, then regenerate on Dashboard → API keys. The header name is case-insensitive — x-api-key and X-API-KEY both work.
Cause: The account behind the key has run out of credit.Fix: Top up at Dashboard → Billing. Requests resume as soon as credit lands — the key stays valid, so there’s nothing to regenerate.
Input should be a valid string / ... valid boolean
response_format: null
Input should be a valid dictionary or object to extract fields from
Bad encoding
Value error, Unsupported audio encoding: flac
Bad rate for encoding
Value error, mp3 audio sample_rate must be between 16000 and 48000 Hz
Bad opus rate
Value error, opus audio sample_rate must be one of 8000, 12000, 16000, 24000, or 48000 Hz
Bad telephony rate
Value error, mulaw audio requires an 8000 Hz sample rate
Bad bitrate
Value error, mp3 audio bitrate must be between 32kbps and 320kbps
Unparseable bitrate
Value error, Invalid mp3 audio bitrate: abc
Bitrate on a PCM-family encoding
Value error, wav audio does not support a bitrate option
temperature below range
Input should be greater than or equal to 0.5
temperature above range
Input should be less than or equal to 3
Two easy 422s to hit: passing bitrate in bits per second (128000) instead of kbps ("128k" or 128), and passing bitrate at all to wav, pcm, linear16, mulaw or alaw. See Text to speech.
valid_voices is the live catalog, so this error is self-correcting — you can read the allowed set straight off the failure. The same shape is returned by POST /v1/tts, POST /v1/tts/stream, and the Vapi endpoint.
Because this body has error and not detail, code that assumes every 422 has a detail array will KeyError here. Branch on which key is present.
Cause: Your key already has 9 requests in flight. The 10th is rejected immediately — nothing queues server-side. HTTP requests and open WebSocket connections draw on the same budget.Fix: Hold a client-side semaphore of 9 or fewer, and retry with backoff.
429 responses carry no Retry-After header. Choose your own schedule — start at 200 ms and back off exponentially with jitter, capped around 5 s.
Plain text, Content-Type: text/plain; charset=utf-8, with an x-request-id header.A genuine server fault. Transient — retry with backoff. The SDKs retry 5xx automatically.
Note the content type: 500 is the one status code that does not return JSON. Guard your error parsing so a .json() call doesn’t throw on top of the original failure.
from kova_tts import KovaTTSClient, KovaTTSErrorclient = KovaTTSClient(api_key="kova_sk_...")try: result = client.tts(text="hi", voice="cal")except KovaTTSError as e: print(e.status_code, e.body) # e.g. 401 {'error': 'Invalid or missing API key'}
import { KovaTTSClient, KovaTTSError } from "@kova-ai/tts";const client = new KovaTTSClient({ apiKey: "kova_sk_..." });try { await client.tts({ text: "hi", voice: "cal" });} catch (e) { if (e instanceof KovaTTSError) { console.log(e.status, e.body); }}
The SDKs also export KovaTTSAuthError (401), KovaTTSRateLimitError (429), KovaTTSValidationError (422), KovaTTSServerError (5xx), KovaTTSConnectionError, and KovaTTSProtocolError. Catch the base KovaTTSError to handle everything; catch subclasses when you need to branch per code.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Kova","description":"Low-latency text-to-speech API. Sync HTTP, streaming HTTP, and WebSocket transports.","colors":{"primary":"#0f8f86","light":"#c8e4df","dark":"#08453f"},"logo":{"light":"https://mintcdn.com/kovaaiinc/5vcMObCVLPfuYR8e/logo/kova-logo-black.svg?fit=max\u0026auto=format\u0026n=5vcMObCVLPfuYR8e\u0026q=85\u0026s=79ee93f4f3d49c7d533c653ae46dcd37","dark":"https://mintcdn.com/kovaaiinc/5vcMObCVLPfuYR8e/logo/kova-logo-white.svg?fit=max\u0026auto=format\u0026n=5vcMObCVLPfuYR8e\u0026q=85\u0026s=10f5e98150556e9e669a61c8403767e8","href":"https://kova.ai"},"favicon":"https://mintcdn.com/kovaaiinc/5vcMObCVLPfuYR8e/logo/kova-logo-notext-black.svg?fit=max\u0026auto=format\u0026n=5vcMObCVLPfuYR8e\u0026q=85\u0026s=3e618d56f3513431f3a479d19a177dd1","api":{"openapi":["api-reference/openapi.json"]},"navbar":{"links":[{"href":"https://platform.kova.ai/dashboard","label":"Dashboard"}],"primary":{"type":"button","label":"Get API key","href":"https://platform.kova.ai/dashboard/api-keys"}},"footer":{"socials":{"website":"https://kova.ai"}},"markdown":{"instructions":["If you are an AI agent, code generator, or LLM integrating with the Kova TTS API, read https://docs.kova.ai/for-agents.md first. It is the complete API contract in a single page - every endpoint, field, type, default, validation bound, error body, and WebSocket frame - and is sufficient to write a correct client without fetching any other page.","Every page on this site is available as raw Markdown by appending .md to its URL.","When generating code against this API: authenticate with the x-api-key header (never Authorization: Bearer); read voice ids from GET /v1/tts/speakers rather than hardcoding them; keep concurrent requests per key at 9 or fewer; pass audio bitrate in kbps (\"128k\" or 128), never bits per second; and do not assume error response bodies are JSON, because 500 responses are plain text."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kovaaiinc","hasAudioNarration":false,"actualSubdomain":"kovaaiinc","customDomains":["docs.kova.ai"],"gitSource":{"type":"github","owner":"evalabs-ai","repo":"kova-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a907f9f18bb4ff508e4845b","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"WebSocket API","count":3},{"language":"default","tag":"Integrations","count":3},{"language":"default","tag":"HTTP API","count":2},{"language":"default","tag":"Reference","count":2},{"language":"default","tag":"SDKs","count":2},{"language":"default","tag":"Voices","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"errors","slug":"/errors","pageMetadata":{"title":"Errors","description":"The actual response body shapes for every status code you'll see.","href":"/errors"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The actual response body shapes for every status code you’ll see.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Kova returns JSON error bodies for every status code `,_jsxs(_components.strong,{children:[`except `,_jsx(_components.code,{children:`500`})]}),`, which returns plain text. The HTTP status is the primary signal; the JSON body carries an `,_jsx(_components.code,{children:`error`}),` or `,_jsx(_components.code,{children:`detail`}),` field.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Do not assume error bodies are JSON.`}),` A `,_jsx(_components.code,{children:`500`}),` returns `,_jsx(_components.code,{children:`Content-Type: text/plain`}),` with the literal body `,_jsx(_components.code,{children:`Internal Server Error`}),`. Calling `,_jsx(_components.code,{children:`.json()`}),` on it will throw. Guard every error parse.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`status-code-summary`,children:`Status code summary`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Body`}),_jsx(_components.th,{children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"error\": \"Invalid or missing API key\"}`})}),_jsxs(_components.td,{children:[`Header missing, or doesn’t start with `,_jsx(_components.code,{children:`kova_sk_`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"error\": \"INVALID_API_KEY\"}`})}),_jsx(_components.td,{children:`Well-formed key that doesn’t exist or was revoked.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`402`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"error\": \"INSUFFICIENT_CREDITS\"}`})}),_jsx(_components.td,{children:`Account out of credit.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`405`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"detail\": \"Method Not Allowed\"}`})}),_jsx(_components.td,{children:`Wrong HTTP method on a valid path.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"detail\": [ ... ]}`})}),_jsx(_components.td,{children:`Request body failed validation.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`{\"error\": \"Rate limit exceeded\", \"reason\": \"concurrency\"}`})}),_jsx(_components.td,{children:`9 requests already in flight on this key.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Internal Server Error`}),` (plain text)`]}),_jsx(_components.td,{children:`Genuine server fault. Transient — retry with backoff.`})]})]})]}),`\n`,_jsxs(Heading,{level:`2`,id:`the-x-request-id-header`,children:[`The `,_jsx(_components.code,{children:`x-request-id`}),` header`]}),`\n`,_jsxs(_components.p,{children:[`Successful and most failed responses carry an `,_jsx(_components.code,{children:`x-request-id`}),` header. Log it — it’s what support needs to trace a request.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`x-request-id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 77d989199c5a6d965c99f76cab579509`})]}),`\n`]})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`x-request-id`}),` is returned on every response, including `,_jsx(_components.code,{children:`500`}),`s. Always log it — it’s what support needs to trace a request.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`401-unauthorized`,children:`401 Unauthorized`}),`\n`,_jsx(_components.p,{children:`Two distinct shapes, depending on where the request was rejected.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Missing or malformed key`}),` — rejected at the gateway:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Invalid or missing API key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Returned when the `,_jsx(_components.code,{children:`x-api-key`}),` header is absent, or its value doesn’t begin with `,_jsx(_components.code,{children:`kova_sk_`}),`. Also returned if you send `,_jsx(_components.code,{children:`Authorization: Bearer \u003ckey>`}),` instead — Kova does not accept bearer tokens.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Well-formed but unknown key`}),` — rejected at the billing service:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INVALID_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The header parsed correctly but the key doesn’t exist or has been revoked.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix:`}),` Verify the header name and value, then regenerate on `,_jsx(_components.a,{href:`https://platform.kova.ai/dashboard/api-keys`,children:`Dashboard → API keys`}),`. The header name is case-insensitive — `,_jsx(_components.code,{children:`x-api-key`}),` and `,_jsx(_components.code,{children:`X-API-KEY`}),` both work.`]}),`\n`,_jsx(Heading,{level:`2`,id:`402-payment-required`,children:`402 Payment Required`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INSUFFICIENT_CREDITS\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` The account behind the key has run out of credit.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix:`}),` Top up at `,_jsx(_components.a,{href:`https://platform.kova.ai/dashboard/billing`,children:`Dashboard → Billing`}),`. Requests resume as soon as credit lands — the key stays valid, so there’s nothing to regenerate.`]}),`\n`,_jsx(Heading,{level:`2`,id:`422-unprocessable-entity`,children:`422 Unprocessable Entity`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"detail\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"missing\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"loc\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"body\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"voice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"msg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Field required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"input\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hello\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`detail`}),` is an array and may contain several errors at once. `,_jsx(_components.code,{children:`loc`}),` is the path to the offending field.`]}),`\n`,_jsx(Heading,{level:`3`,id:`common-causes-and-exact-messages`,children:`Common causes and exact messages`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Cause`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`msg`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Missing `,_jsx(_components.code,{children:`text`}),` or `,_jsx(_components.code,{children:`voice`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Field required`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Unknown field in the body`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Extra inputs are not permitted`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Wrong type`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Input should be a valid string`}),` / `,_jsx(_components.code,{children:`... valid boolean`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`response_format: null`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Input should be a valid dictionary or object to extract fields from`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Bad encoding`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Value error, Unsupported audio encoding: flac`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Bad rate for encoding`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Value error, mp3 audio sample_rate must be between 16000 and 48000 Hz`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Bad opus rate`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Value error, opus audio sample_rate must be one of 8000, 12000, 16000, 24000, or 48000 Hz`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Bad telephony rate`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Value error, mulaw audio requires an 8000 Hz sample rate`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Bad bitrate`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Value error, mp3 audio bitrate must be between 32kbps and 320kbps`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Unparseable bitrate`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Value error, Invalid mp3 audio bitrate: abc`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Bitrate on a PCM-family encoding`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Value error, wav audio does not support a bitrate option`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`temperature`}),` below range`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Input should be greater than or equal to 0.5`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`temperature`}),` above range`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Input should be less than or equal to 3`})})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Two easy 422s to hit: passing `,_jsx(_components.code,{children:`bitrate`}),` in `,_jsx(_components.strong,{children:`bits`}),` per second (`,_jsx(_components.code,{children:`128000`}),`) instead of kbps (`,_jsx(_components.code,{children:`\"128k\"`}),` or `,_jsx(_components.code,{children:`128`}),`), and passing `,_jsx(_components.code,{children:`bitrate`}),` at all to `,_jsx(_components.code,{children:`wav`}),`, `,_jsx(_components.code,{children:`pcm`}),`, `,_jsx(_components.code,{children:`linear16`}),`, `,_jsx(_components.code,{children:`mulaw`}),` or `,_jsx(_components.code,{children:`alaw`}),`. See `,_jsx(_components.a,{href:`/api-reference/http/text-to-speech#response-format`,children:`Text to speech`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`unknown-voice`,children:`Unknown voice`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`voice`}),` that isn’t in the catalog returns `,_jsx(_components.code,{children:`422`}),` with a `,_jsx(_components.strong,{children:`different body shape`}),` from the validation errors above — no `,_jsx(_components.code,{children:`detail`}),` array:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"unknown_voice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Unknown voice 'nope'. Valid voices: ash, ash_conv, cal, mira, mira_conv, owen, paul, tess, theo\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"voice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"nope\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"valid_voices\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ash\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ash_conv\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mira\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mira_conv\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"owen\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"paul\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tess\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"theo\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`valid_voices`}),` is the live catalog, so this error is self-correcting — you can read the allowed set straight off the failure. The same shape is returned by `,_jsx(_components.code,{children:`POST /v1/tts`}),`, `,_jsx(_components.a,{href:`/api-reference/http/streaming-tts`,children:_jsx(_components.code,{children:`POST /v1/tts/stream`})}),`, and the `,_jsx(_components.a,{href:`/integrations/vapi`,children:`Vapi endpoint`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Because this body has `,_jsx(_components.code,{children:`error`}),` and not `,_jsx(_components.code,{children:`detail`}),`, code that assumes every `,_jsx(_components.code,{children:`422`}),` has a `,_jsx(_components.code,{children:`detail`}),` array will `,_jsx(_components.code,{children:`KeyError`}),` here. Branch on which key is present.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`429-too-many-requests`,children:`429 Too Many Requests`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Rate limit exceeded\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"reason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"concurrency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Cause:`}),` Your key already has 9 requests in flight. The 10th is rejected immediately — nothing queues server-side. HTTP requests and open WebSocket connections draw on the same budget.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Fix:`}),` Hold a client-side semaphore of 9 or fewer, and retry with backoff.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`429`}),` responses carry `,_jsxs(_components.strong,{children:[`no `,_jsx(_components.code,{children:`Retry-After`}),` header`]}),`. Choose your own schedule — start at 200 ms and back off exponentially with jitter, capped around 5 s.`]})}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/rate-limits`,children:`Rate limits`}),` for the full policy.`]}),`\n`,_jsx(Heading,{level:`2`,id:`500-internal-server-error`,children:`500 Internal Server Error`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Internal Server Error`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Plain text, `,_jsx(_components.code,{children:`Content-Type: text/plain; charset=utf-8`}),`, with an `,_jsx(_components.code,{children:`x-request-id`}),` header.`]}),`\n`,_jsx(_components.p,{children:`A genuine server fault. Transient — retry with backoff. The SDKs retry 5xx automatically.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Note the content type: `,_jsx(_components.code,{children:`500`}),` is the one status code that does `,_jsx(_components.strong,{children:`not`}),` return JSON. Guard your error parsing so a `,_jsx(_components.code,{children:`.json()`}),` call doesn’t throw on top of the original failure.`]})}),`\n`,_jsxs(_components.p,{children:[`For persistent 500s, `,_jsx(_components.a,{href:`mailto:support@kova.ai`,children:`contact support`}),` with the `,_jsx(_components.code,{children:`x-request-id`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`websocket-errors`,children:`WebSocket errors`}),`\n`,_jsxs(_components.p,{children:[`The WebSocket transport does not use HTTP status codes after the handshake. Failures arrive as `,_jsx(_components.code,{children:`error`}),` frames:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"unknown context_id: c1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"context_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"c1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Key differences from HTTP:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`error`}),` frames are not fatal.`]}),` The socket stays open and other contexts keep working.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`An unknown `,_jsx(_components.code,{children:`voice_id`}),` produces a clean `,_jsx(_components.code,{children:`error`}),` frame`]}),` naming every valid voice.`]}),`\n`,_jsxs(_components.li,{children:[`A revoked key produces `,_jsx(_components.code,{children:`{\"error\": \"INVALID_API_KEY\"}`}),` followed by WebSocket close code `,_jsx(_components.code,{children:`1008`}),` (policy violation).`]}),`\n`,_jsxs(_components.li,{children:[`A malformed frame produces `,_jsx(_components.code,{children:`{\"error\": \"invalid frame: ...\"}`}),` with the underlying validation message.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/api-reference/websocket/frames#error`,children:`WebSocket frames`}),` for the full frame reference.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-errors-surface-in-the-sdks`,children:`How errors surface in the SDKs`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Python`,numberOfLines:`7`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` kova_tts `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` KovaTTSClient, KovaTTSError`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` KovaTTSClient(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`api_key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"kova_sk_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`try`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.tts(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`text`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"hi\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`voice`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`except`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` KovaTTSError `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`as`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` e:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(e.status_code, e.body) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# e.g. 401 {'error': 'Invalid or missing API key'}`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`10`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`KovaTTSClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`KovaTTSError`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"@kova-ai/tts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` client`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` KovaTTSClient`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`apiKey:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"kova_sk_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`try`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`tts`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`text:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"hi\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`voice:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"cal\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`catch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`e`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` instanceof`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:` KovaTTSError`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`e`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`e`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`body`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`The SDKs also export `,_jsx(_components.code,{children:`KovaTTSAuthError`}),` (401), `,_jsx(_components.code,{children:`KovaTTSRateLimitError`}),` (429), `,_jsx(_components.code,{children:`KovaTTSValidationError`}),` (422), `,_jsx(_components.code,{children:`KovaTTSServerError`}),` (5xx), `,_jsx(_components.code,{children:`KovaTTSConnectionError`}),`, and `,_jsx(_components.code,{children:`KovaTTSProtocolError`}),`. Catch the base `,_jsx(_components.code,{children:`KovaTTSError`}),` to handle everything; catch subclasses when you need to branch per code.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Errors","description":"The actual response body shapes for every status code you'll see.","href":"/errors"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Status code summary","slug":"status-code-summary","depth":2,"children":[]},{"title":"The x-request-id header","slug":"the-x-request-id-header","depth":2,"children":[]},{"title":"401 Unauthorized","slug":"401-unauthorized","depth":2,"children":[]},{"title":"402 Payment Required","slug":"402-payment-required","depth":2,"children":[]},{"title":"422 Unprocessable Entity","slug":"422-unprocessable-entity","depth":2,"children":[{"title":"Common causes and exact messages","slug":"common-causes-and-exact-messages","depth":3,"children":[]},{"title":"Unknown voice","slug":"unknown-voice","depth":3,"children":[]}]},{"title":"429 Too Many Requests","slug":"429-too-many-requests","depth":2,"children":[]},{"title":"500 Internal Server Error","slug":"500-internal-server-error","depth":2,"children":[]},{"title":"WebSocket errors","slug":"websocket-errors","depth":2,"children":[]},{"title":"How errors surface in the SDKs","slug":"how-errors-surface-in-the-sdks","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"kovaaiinc","siteName":"Kova","title":"Errors - Kova","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T18:26:25.912Z","originalFileLocation":"errors.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The actual response body shapes for every status code you\u0026#x27;ll see.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kova\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kovaaiinc/4Ek0Ez0gwLwyUrBD/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/kovaaiinc/4Ek0Ez0gwLwyUrBD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kovaaiinc/4Ek0Ez0gwLwyUrBD/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/kovaaiinc/4Ek0Ez0gwLwyUrBD/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/kovaaiinc/4Ek0Ez0gwLwyUrBD/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kovaaiinc/4Ek0Ez0gwLwyUrBD/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kovaaiinc/4Ek0Ez0gwLwyUrBD/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/kovaaiinc/4Ek0Ez0gwLwyUrBD/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/kovaaiinc/4Ek0Ez0gwLwyUrBD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Errors - Kova\">\u003cmeta data-mint-head property=\"og:description\" content=\"The actual response body shapes for every status code you\u0026#x27;ll see.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kova\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kova.ai/errors\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kovaaiinc.mintlify.site/_mintlify/api/og/v2?division=Reference\u0026amp;title=Errors\u0026amp;description=The+actual+response+body+shapes+for+every+status+code+you%27ll+see.\u0026amp;theme=edff6544bbc15f624cc382a4\u0026amp;signature=8206bf6bc66e13f707106eea07a740ea92e3699f01a3a700b88b36a62bb8745f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Errors - Kova\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The actual response body shapes for every status code you\u0026#x27;ll see.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kovaaiinc.mintlify.site/_mintlify/api/og/v2?division=Reference\u0026amp;title=Errors\u0026amp;description=The+actual+response+body+shapes+for+every+status+code+you%27ll+see.\u0026amp;theme=edff6544bbc15f624cc382a4\u0026amp;signature=8206bf6bc66e13f707106eea07a740ea92e3699f01a3a700b88b36a62bb8745f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/kovaaiinc/4Ek0Ez0gwLwyUrBD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kova\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0f8f86\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kova.ai/errors\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/errors.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kova.ai/#organization\",\"name\":\"Kova\",\"url\":\"https://docs.kova.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kovaaiinc/5vcMObCVLPfuYR8e/logo/kova-logo-black.svg?fit=max\u0026auto=format\u0026n=5vcMObCVLPfuYR8e\u0026q=85\u0026s=79ee93f4f3d49c7d533c653ae46dcd37\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kova.ai#website\",\"name\":\"Kova\",\"url\":\"https://docs.kova.ai\",\"publisher\":{\"@id\":\"https://docs.kova.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kova.ai/errors#webpage\",\"url\":\"https://docs.kova.ai/errors\",\"name\":\"Errors\",\"description\":\"The actual response body shapes for every status code you'll see.\",\"dateModified\":\"2026-08-27T18:26:25.912Z\",\"isPartOf\":{\"@id\":\"https://docs.kova.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kova.ai/errors#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kova.ai/errors#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Kova\",\"item\":\"https://docs.kova.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Errors\",\"item\":\"https://docs.kova.ai/errors\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.kova.ai/errors#article\",\"headline\":\"Errors\",\"name\":\"Errors\",\"description\":\"The actual response body shapes for every status code you'll see.\",\"url\":\"https://docs.kova.ai/errors\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kova.ai/errors#webpage\"},\"dateModified\":\"2026-08-27T18:26:25.912Z\",\"publisher\":{\"@id\":\"https://docs.kova.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kova.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kova\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Kova","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Overview","href":"/overview"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"Kova TTS for AI agents","href":"/for-agents"}]},{"group":"HTTP API","pages":[{"title":"Text to speech","openapi":"POST /v1/tts","href":"/api-reference/http/text-to-speech"},{"title":"Streaming TTS","openapi":"POST /v1/tts/stream","href":"/api-reference/http/streaming-tts"}]},{"group":"WebSocket API","pages":[{"title":"WebSocket overview","href":"/api-reference/websocket/overview"},{"title":"WebSocket frames","href":"/api-reference/websocket/frames"},{"title":"Example: streaming a long document","href":"/api-reference/websocket/examples/streaming-long-doc"}]},{"group":"Voices","pages":[{"title":"Voices","openapi":"GET /v1/tts/speakers","href":"/voices"}]},{"group":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"},{"title":"Vapi","href":"/integrations/vapi"},{"title":"Ultravox","href":"/integrations/ultravox"}]},{"group":"SDKs","pages":[{"title":"Python SDK","href":"/sdks/python"},{"title":"JavaScript / TypeScript SDK","description":"Official JavaScript/TypeScript client for the Kova TTS API.","href":"/sdks/javascript"}]},{"group":"Reference","pages":[{"title":"Errors","href":"/errors"},{"title":"Rate limits","description":"Per-key concurrency, what 429 looks like, and how to back off.","href":"/rate-limits"}]}]},"basePath":"","title":"Errors - Kova","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":[],"chunks":[]}