Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.
POST https://api.voicecheap.ai/v1/actions/voices_preview_get
Authentication and permissions
string
required
Send a VoiceCheap API key in this header. Authorization: Bearer with the same API key is also supported. OAuth access tokens are accepted only by
MCP, not by this REST endpoint.
Required permissions: voices:read.An active paid subscription is required. Permissions do not change team roles, resource ownership, media credits, or plan limits.
Parameters
string
required
Text value.Format: “uuid”. Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$.
Complete input schema
The JSON Schema below preserves the exact field names, nested types, defaults, bounds, and accepted values exposed by discovery. Additional cross-field rules are listed in the operation notes.
Replace example resource identifiers and media keys with values returned for your account. Keep the request identifier stable when retrying the same mutation.
A successful first execution returns HTTP 200 with the operation result under data. A replay may return saved request state instead. The example shows one supported response, not every optional field.One active owned voice preview, with a refreshed temporary playback URL and its expiry.
Candidate expiry as a Unix timestamp in milliseconds.
data.durationSeconds
Preview audio duration in seconds.
Operation notes
previewId is the candidate UUID returned in voicePreviews by voices_preview_clone, voices_design, or voices_list.
Only ready, unsaved, unexpired previews are visible. A saved candidate moves to voices_list as clone:<previewId>. Expired, saved, missing, and unowned candidates return VOICE_PREVIEW_NOT_FOUND here.
The URL is temporary and can expire before expiresAt. Save the chosen candidate with voices_save_preview before the preview itself expires.
Speech history and custom voices belong to the authenticated account. Team billing does not grant access to another member’s speech or voices.
Usage
Each successful invocation consumes one monthly API/MCP call. Media credits and the operation’s own generation allowances also apply.
Errors
HTTP status
Code
Meaning or recovery
400
CREDENTIAL_IN_QUERY
Credentials were supplied in an access_token or api_key query parameter. Send credentials in headers.
400
VALIDATION_ERROR
The input does not match the action schema; inspect details for field errors.
401
API_KEY_EXPIRED
The API key has expired.
401
INVALID_API_KEY
Provide a valid, unexpired API key.
401
INVALID_CREDENTIAL
The Authorization header is malformed or conflicts with x-api-key.
401
MISSING_CREDENTIAL
No usable header credential was supplied, or it exceeded 4096 characters.
401
USER_NOT_FOUND
The credential’s account no longer exists.
403
AMBIGUOUS_TEAM_API_KEY
The credential’s user belongs to more than one team, so the billing context is ambiguous.
403
INSUFFICIENT_SCOPE
Grant every required permission or choose another credential.
403
INTEGRATION_PLAN_UNSUPPORTED
The account’s integration limits could not be verified.
403
SUBSCRIPTION_REQUIRED
Use an active paid subscription.
403
TEAM_OWNER_NOT_FOUND
The effective team owner account could not be found.
404
USER_NOT_FOUND
The authenticated account no longer exists.
404
VOICE_PREVIEW_NOT_FOUND
The preview is missing, unowned, already saved, or expired.
429
INTEGRATION_MONTHLY_LIMIT_REACHED
Wait for the monthly reset or change plan.
429
INTEGRATION_RATE_LIMIT_REACHED
Wait for Retry-After when present and use backoff.
500
INTERNAL_ERROR
Check saved request state and resource history before deciding to retry a mutation.
503
SERVER_RESTARTING
The server is restarting. Retry shortly and keep the same request identifier for a mutation.
{ "code": "INSUFFICIENT_SCOPE", "message": "This credential does not permit the requested action.", "status": 403, "details": { "requiredScopes": ["voices:read"] }}
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"VoiceCheap Documentation","colors":{"primary":"#7C3AED","light":"#A78BFA","dark":"#5B21B6"},"logo":{"light":"https://mintcdn.com/voicecheap/h-Bn773dalfhYrfJ/images/logo-light.png?fit=max\u0026auto=format\u0026n=h-Bn773dalfhYrfJ\u0026q=85\u0026s=4c1fb3404e1facd7b0d51c296871a6fa","dark":"https://mintcdn.com/voicecheap/h-Bn773dalfhYrfJ/images/logo-dark.png?fit=max\u0026auto=format\u0026n=h-Bn773dalfhYrfJ\u0026q=85\u0026s=81faeeeb11206fb5130c732ceae69c71"},"favicon":"https://mintcdn.com/voicecheap/5RypjMNMUU2K3f1p/images/favicon.svg?fit=max\u0026auto=format\u0026n=5RypjMNMUU2K3f1p\u0026q=85\u0026s=f30069e88bef43f593516ad5a74dcb7e","api":{},"seo":{"metatags":{"canonical":"https://voicecheap.ai/docs","theme-color":"#7C3AED","twitter:site":"@voicecheap_ai","application-name":"VoiceCheap Documentation","apple-mobile-web-app-title":"VoiceCheap Documentation","keywords":"voicecheap documentation, voicecheap api, ai dubbing, video translation, voice cloning, lip-sync, SmartSync, subtitle generation, text to speech, speech to text, model context protocol"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","add-mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","default":true,"navbar":{"links":[{"href":"https://voicecheap.ai","label":"Website"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Community"},{"href":"mailto:contact@voicecheap.ai","label":"Support"}],"primary":{"type":"button","label":"Open app","href":"https://app.voicecheap.ai"}},"href":"introduction"},{"language":"de","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Webseite"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Gemeinschaft"},{"href":"mailto:contact@voicecheap.ai","label":"Hilfe"}],"primary":{"type":"button","label":"App öffnen","href":"https://app.voicecheap.ai"}},"href":"de/introduction"},{"language":"es","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Sitio web"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Comunidad"},{"href":"mailto:contact@voicecheap.ai","label":"Soporte"}],"primary":{"type":"button","label":"Abrir la aplicación","href":"https://app.voicecheap.ai"}},"href":"es/introduction"},{"language":"fr","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Site web"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Communauté"},{"href":"mailto:contact@voicecheap.ai","label":"Assistance"}],"primary":{"type":"button","label":"Ouvrir l’application","href":"https://app.voicecheap.ai"}},"href":"fr/introduction"},{"language":"it","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Sito web"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Comunità"},{"href":"mailto:contact@voicecheap.ai","label":"Assistenza"}],"primary":{"type":"button","label":"Apri l’app","href":"https://app.voicecheap.ai"}},"href":"it/introduction"},{"language":"ja","navbar":{"links":[{"href":"https://voicecheap.ai","label":"ウェブサイト"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"コミュニティ"},{"href":"mailto:contact@voicecheap.ai","label":"サポート"}],"primary":{"type":"button","label":"アプリを開く","href":"https://app.voicecheap.ai"}},"href":"ja/introduction"},{"language":"ko","navbar":{"links":[{"href":"https://voicecheap.ai","label":"웹사이트"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"커뮤니티"},{"href":"mailto:contact@voicecheap.ai","label":"지원"}],"primary":{"type":"button","label":"앱 열기","href":"https://app.voicecheap.ai"}},"href":"ko/introduction"},{"language":"nl","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Website"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Gemeenschap"},{"href":"mailto:contact@voicecheap.ai","label":"Ondersteuning"}],"primary":{"type":"button","label":"App openen","href":"https://app.voicecheap.ai"}},"href":"nl/introduction"},{"language":"pl","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Strona internetowa"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Społeczność"},{"href":"mailto:contact@voicecheap.ai","label":"Pomoc"}],"primary":{"type":"button","label":"Otwórz aplikację","href":"https://app.voicecheap.ai"}},"href":"pl/introduction"},{"language":"pt","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Site"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Comunidade"},{"href":"mailto:contact@voicecheap.ai","label":"Suporte"}],"primary":{"type":"button","label":"Abrir o aplicativo","href":"https://app.voicecheap.ai"}},"href":"pt/introduction"},{"language":"zh","navbar":{"links":[{"href":"https://voicecheap.ai","label":"网站"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"社区"},{"href":"mailto:contact@voicecheap.ai","label":"支持"}],"primary":{"type":"button","label":"打开应用","href":"https://app.voicecheap.ai"}},"href":"zh/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"voicecheap","hasAudioNarration":false,"actualSubdomain":"voicecheap","customDomains":["api-docs.voicecheap.ai"],"gitSource":{"type":"github","owner":"voicecheap","repo":"client-server","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af9cfa0d68a947269633928","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"en","tag":"API Reference","count":175},{"language":"de","tag":"API-Referenz","count":175},{"language":"es","tag":"Referencia de la API","count":175},{"language":"fr","tag":"Référence API","count":175},{"language":"it","tag":"Riferimento API","count":175},{"language":"ja","tag":"API リファレンス","count":175},{"language":"ko","tag":"API 레퍼런스","count":175},{"language":"nl","tag":"API-referentie","count":175},{"language":"pl","tag":"Dokumentacja API","count":175},{"language":"pt","tag":"Referência da API","count":175},{"language":"zh","tag":"API 参考","count":175},{"language":"en","tag":"Documentation","count":35},{"language":"de","tag":"Dokumentation","count":35},{"language":"es","tag":"Documentación","count":35},{"language":"fr","tag":"Documentation","count":35},{"language":"it","tag":"Documentazione","count":35},{"language":"ja","tag":"ドキュメント","count":35},{"language":"ko","tag":"문서","count":35},{"language":"nl","tag":"Documentatie","count":35},{"language":"pl","tag":"Dokumentacja","count":35},{"language":"pt","tag":"Documentação","count":35},{"language":"zh","tag":"文档","count":35},{"language":"en","tag":"Subtitles and captions","count":25},{"language":"de","tag":"Untertitel","count":25},{"language":"es","tag":"Subtítulos","count":25},{"language":"fr","tag":"Sous-titres et légendes","count":25},{"language":"it","tag":"Sottotitoli e didascalie","count":25},{"language":"ja","tag":"字幕とキャプション","count":25},{"language":"ko","tag":"자막 및 캡션","count":25},{"language":"nl","tag":"Ondertitels en captions","count":25},{"language":"pl","tag":"Napisy","count":25},{"language":"pt","tag":"Legendas","count":25},{"language":"zh","tag":"字幕","count":25},{"language":"en","tag":"Transcription","count":21},{"language":"de","tag":"Transkription","count":21},{"language":"es","tag":"Transcripción","count":21},{"language":"fr","tag":"Transcription","count":21},{"language":"it","tag":"Trascrizione","count":21},{"language":"ja","tag":"文字起こし","count":21},{"language":"ko","tag":"음성 전사","count":21},{"language":"nl","tag":"Transcriptie","count":21},{"language":"pl","tag":"Transkrypcja","count":21},{"language":"pt","tag":"Transcrição","count":21},{"language":"zh","tag":"转写","count":21},{"language":"en","tag":"Projects","count":15},{"language":"de","tag":"Projekte","count":15},{"language":"es","tag":"Proyectos","count":15},{"language":"fr","tag":"Projets","count":15},{"language":"it","tag":"Progetti","count":15},{"language":"ja","tag":"プロジェクト","count":15},{"language":"ko","tag":"프로젝트","count":15},{"language":"nl","tag":"Projecten","count":15},{"language":"pl","tag":"Projekty","count":15},{"language":"pt","tag":"Projetos","count":15},{"language":"zh","tag":"项目","count":15},{"language":"en","tag":"OAuth and MCP protocol","count":12},{"language":"de","tag":"OAuth- und MCP-Protokoll","count":12},{"language":"es","tag":"OAuth y protocolo MCP","count":12},{"language":"fr","tag":"OAuth et protocole MCP","count":12},{"language":"it","tag":"OAuth e protocollo MCP","count":12},{"language":"ja","tag":"OAuth と MCP プロトコル","count":12},{"language":"ko","tag":"OAuth 및 MCP 프로토콜","count":12},{"language":"nl","tag":"OAuth en het MCP-protocol","count":12},{"language":"pl","tag":"OAuth i protokół MCP","count":12},{"language":"pt","tag":"OAuth e protocolo MCP","count":12},{"language":"zh","tag":"OAuth 和 MCP 协议","count":12},{"language":"en","tag":"Transcripts and editing","count":11},{"language":"en","tag":"Speech voices","count":11},{"language":"de","tag":"Transkripte und Bearbeitung","count":11},{"language":"de","tag":"Stimmen für die Sprachausgabe","count":11},{"language":"es","tag":"Transcripciones y edición","count":11},{"language":"es","tag":"Voces de texto a voz","count":11},{"language":"fr","tag":"Transcriptions et édition","count":11},{"language":"fr","tag":"Voix de synthèse","count":11},{"language":"it","tag":"Trascrizioni e modifica","count":11},{"language":"it","tag":"Voci per la sintesi vocale","count":11},{"language":"ja","tag":"文字起こしと編集","count":11},{"language":"ja","tag":"読み上げ音声","count":11},{"language":"ko","tag":"전사문 및 편집","count":11},{"language":"ko","tag":"음성 합성용 음성","count":11},{"language":"nl","tag":"Transcripten en bewerking","count":11},{"language":"nl","tag":"Spraakstemmen","count":11},{"language":"pl","tag":"Transkrypcje i edycja","count":11},{"language":"pl","tag":"Głosy do syntezy mowy","count":11},{"language":"pt","tag":"Transcrições e edição","count":11},{"language":"pt","tag":"Vozes de fala","count":11},{"language":"zh","tag":"转写文本和编辑","count":11},{"language":"zh","tag":"语音音色","count":11},{"language":"en","tag":"Translation and dubbing","count":10},{"language":"de","tag":"Übersetzung und Synchronisation","count":10},{"language":"es","tag":"Traducción y doblaje","count":10},{"language":"fr","tag":"Traduction et doublage","count":10},{"language":"it","tag":"Traduzione e doppiaggio","count":10},{"language":"ja","tag":"翻訳と吹き替え","count":10},{"language":"ko","tag":"번역 및 더빙","count":10},{"language":"nl","tag":"Vertaling en nasynchronisatie","count":10},{"language":"pl","tag":"Tłumaczenie i dubbing","count":10},{"language":"pt","tag":"Tradução e dublagem","count":10},{"language":"zh","tag":"翻译和配音","count":10},{"language":"en","tag":"Overview","count":8},{"language":"de","tag":"Überblick","count":8},{"language":"es","tag":"Descripción general","count":8},{"language":"fr","tag":"Vue d’ensemble","count":8},{"language":"it","tag":"Panoramica","count":8},{"language":"ja","tag":"概要","count":8},{"language":"ko","tag":"개요","count":8},{"language":"nl","tag":"Overzicht","count":8},{"language":"pl","tag":"Przegląd","count":8},{"language":"pt","tag":"Visão geral","count":8},{"language":"zh","tag":"概述","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/actions/voices/voices-preview-get","slug":"/api-reference/actions/voices/voices-preview-get","pageMetadata":{"title":"Get a voice preview","description":"Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.","api":"POST https://api.voicecheap.ai/v1/actions/voices_preview_get","playground":"simple","href":"/api-reference/actions/voices/voices-preview-get"},"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: \"Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.\"\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={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,CodeBlock,Heading,ParamField,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.`}),`\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:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://api.voicecheap.ai/v1/actions/voices_preview_get`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`authentication-and-permissions`,children:`Authentication and permissions`}),`\n`,_jsx(ParamField,{header:`x-api-key`,type:`string`,required:true,id:`param-x-api-key`,children:_jsx(_components.p,{children:`Send a VoiceCheap API key in this header. Authorization: Bearer with the same API key is also supported. OAuth access tokens are accepted only by\nMCP, not by this REST endpoint.`})}),`\n`,_jsxs(_components.p,{children:[`Required permissions: `,_jsx(_components.code,{children:`voices:read`}),`.`]}),`\n`,_jsx(_components.p,{children:`An active paid subscription is required. Permissions do not change team roles, resource ownership, media credits, or plan limits.`}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsxs(ParamField,{body:`previewId`,type:`string`,required:true,id:`param-preview-id`,children:[_jsx(_components.p,{children:`Text value.`}),_jsxs(_components.p,{children:[`Format: “uuid”. Pattern: `,_jsx(_components.code,{children:`^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`}),`.`]})]}),`\n`,_jsxs(Accordion,{title:`Complete input schema`,id:`complete-input-schema`,children:[_jsx(_components.p,{children:`The JSON Schema below preserves the exact field names, nested types, defaults, bounds, and accepted values exposed by discovery. Additional cross-field rules are listed in the operation notes.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`12`,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:`12`,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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"object\"`}),_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:` \"properties\"`}),_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:` \"previewId\"`}),_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:`\"string\"`}),_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:` \"format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"uuid\"`}),_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:` \"pattern\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$\"`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"previewId\"`}),_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:` \"additionalProperties\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`request-examples`,children:`Request examples`}),`\n`,_jsx(_components.p,{children:`Replace example resource identifiers and media keys with values returned for your account. Keep the request identifier stable when retrying the same mutation.`}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`A successful first execution returns HTTP 200 with the operation result under data. A replay may return saved request state instead. The example shows one supported response, not every optional field.`}),`\n`,_jsx(_components.p,{children:`One active owned voice preview, with a refreshed temporary playback URL and its expiry.`}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`result-fields`,children:`Result fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.id`})}),_jsx(_components.td,{children:`Candidate UUID for voices_save_preview.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.kind`})}),_jsx(_components.td,{children:`clone or design.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.name`})}),_jsx(_components.td,{children:`Candidate display name.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.previewUrl`})}),_jsx(_components.td,{children:`Fresh temporary playable audio URL.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.expiresAt`})}),_jsx(_components.td,{children:`Candidate expiry as a Unix timestamp in milliseconds.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.durationSeconds`})}),_jsx(_components.td,{children:`Preview audio duration in seconds.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`operation-notes`,children:`Operation notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`previewId is the candidate UUID returned in voicePreviews by voices_preview_clone, voices_design, or voices_list.`}),`\n`,_jsx(_components.li,{children:`Only ready, unsaved, unexpired previews are visible. A saved candidate moves to voices_list as clone:\u003cpreviewId>. Expired, saved, missing, and unowned candidates return VOICE_PREVIEW_NOT_FOUND here.`}),`\n`,_jsx(_components.li,{children:`The URL is temporary and can expire before expiresAt. Save the chosen candidate with voices_save_preview before the preview itself expires.`}),`\n`,_jsx(_components.li,{children:`Speech history and custom voices belong to the authenticated account. Team billing does not grant access to another member’s speech or voices.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`usage`,children:`Usage`}),`\n`,_jsx(_components.p,{children:`Each successful invocation consumes one monthly API/MCP call. Media credits and the operation’s own generation allowances also apply.`}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP status`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Meaning or recovery`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CREDENTIAL_IN_QUERY`})}),_jsx(_components.td,{children:`Credentials were supplied in an access_token or api_key query parameter. Send credentials in headers.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{children:`The input does not match the action schema; inspect details for field errors.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_KEY_EXPIRED`})}),_jsx(_components.td,{children:`The API key has expired.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_API_KEY`})}),_jsx(_components.td,{children:`Provide a valid, unexpired API key.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_CREDENTIAL`})}),_jsx(_components.td,{children:`The Authorization header is malformed or conflicts with x-api-key.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MISSING_CREDENTIAL`})}),_jsx(_components.td,{children:`No usable header credential was supplied, or it exceeded 4096 characters.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`USER_NOT_FOUND`})}),_jsx(_components.td,{children:`The credential’s account no longer exists.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AMBIGUOUS_TEAM_API_KEY`})}),_jsx(_components.td,{children:`The credential’s user belongs to more than one team, so the billing context is ambiguous.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INSUFFICIENT_SCOPE`})}),_jsx(_components.td,{children:`Grant every required permission or choose another credential.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INTEGRATION_PLAN_UNSUPPORTED`})}),_jsx(_components.td,{children:`The account’s integration limits could not be verified.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SUBSCRIPTION_REQUIRED`})}),_jsx(_components.td,{children:`Use an active paid subscription.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`TEAM_OWNER_NOT_FOUND`})}),_jsx(_components.td,{children:`The effective team owner account could not be found.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`USER_NOT_FOUND`})}),_jsx(_components.td,{children:`The authenticated account no longer exists.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VOICE_PREVIEW_NOT_FOUND`})}),_jsx(_components.td,{children:`The preview is missing, unowned, already saved, or expired.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INTEGRATION_MONTHLY_LIMIT_REACHED`})}),_jsx(_components.td,{children:`Wait for the monthly reset or change plan.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INTEGRATION_RATE_LIMIT_REACHED`})}),_jsx(_components.td,{children:`Wait for Retry-After when present and use backoff.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INTERNAL_ERROR`})}),_jsx(_components.td,{children:`Check saved request state and resource history before deciding to retry a mutation.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SERVER_RESTARTING`})}),_jsx(_components.td,{children:`The server is restarting. Retry shortly and keep the same request identifier for a mutation.`})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INSUFFICIENT_SCOPE\"`}),_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:`\"This credential does not permit the requested action.\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`403`}),_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:` \"details\"`}),_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:` \"requiredScopes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"voices:read\"`}),_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`]})})})]})}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":"Get a voice preview","description":"Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.","api":"POST https://api.voicecheap.ai/v1/actions/voices_preview_get","playground":"simple","href":"/api-reference/actions/voices/voices-preview-get"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,CodeBlock,Heading,ParamField,RequestExample,ResponseExample,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.`}),`\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:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://api.voicecheap.ai/v1/actions/voices_preview_get`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`authentication-and-permissions`,children:`Authentication and permissions`}),`\n`,_jsx(ParamField,{header:`x-api-key`,type:`string`,required:true,id:`param-x-api-key`,children:_jsx(_components.p,{children:`Send a VoiceCheap API key in this header. Authorization: Bearer with the same API key is also supported. OAuth access tokens are accepted only by\nMCP, not by this REST endpoint.`})}),`\n`,_jsxs(_components.p,{children:[`Required permissions: `,_jsx(_components.code,{children:`voices:read`}),`.`]}),`\n`,_jsx(_components.p,{children:`An active paid subscription is required. Permissions do not change team roles, resource ownership, media credits, or plan limits.`}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsxs(ParamField,{body:`previewId`,type:`string`,required:true,id:`param-preview-id`,children:[_jsx(_components.p,{children:`Text value.`}),_jsxs(_components.p,{children:[`Format: “uuid”. Pattern: `,_jsx(_components.code,{children:`^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`}),`.`]})]}),`\n`,_jsxs(Accordion,{title:`Complete input schema`,id:`complete-input-schema`,children:[_jsx(_components.p,{children:`The JSON Schema below preserves the exact field names, nested types, defaults, bounds, and accepted values exposed by discovery. Additional cross-field rules are listed in the operation notes.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`12`,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:`12`,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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"object\"`}),_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:` \"properties\"`}),_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:` \"previewId\"`}),_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:`\"string\"`}),_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:` \"format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"uuid\"`}),_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:` \"pattern\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$\"`})]}),`\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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"required\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"previewId\"`}),_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:` \"additionalProperties\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`request-examples`,children:`Request examples`}),`\n`,_jsx(_components.p,{children:`Replace example resource identifiers and media keys with values returned for your account. Keep the request identifier stable when retrying the same mutation.`}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`4`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.voicecheap.ai/v1/actions/voices_preview_get'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$VOICECHEAP_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"previewId\":\"44444444-4444-4444-8444-444444444444\"}'`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`14`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`14`,children:[_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:` input`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_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:` previewId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '44444444-4444-4444-8444-444444444444'`}),_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:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.voicecheap.ai/v1/actions/voices_preview_get'`}),_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:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_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:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'x-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`VOICECHEAP_API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_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:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`input`}),_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:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` body`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_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:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ok`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`throw`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Error`}),_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:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`code`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` +`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ': '`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--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:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`message`}),_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:`body`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`13`,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:`13`,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:` os`})]}),`\n`,_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:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.voicecheap.ai/v1/actions/voices_preview_get\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"x-api-key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: os.environ[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VOICECHEAP_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"previewId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"44444444-4444-4444-8444-444444444444\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` timeout`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`120`}),_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:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`body `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` not`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.ok:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` raise`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` RuntimeError`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`body.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'code'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`body.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'message'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\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:`(body)`})]}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`A successful first execution returns HTTP 200 with the operation result under data. A replay may return saved request state instead. The example shows one supported response, not every optional field.`}),`\n`,_jsx(_components.p,{children:`One active owned voice preview, with a refreshed temporary playback URL and its expiry.`}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`HTTP 200`,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:` \"data\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"44444444-4444-4444-8444-444444444444\"`}),_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:` \"kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"clone\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Studio narrator\"`}),_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:` \"previewUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://files.example.com/narrator-preview.mp3\"`}),_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:` \"expiresAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1792238400000`}),_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:` \"durationSeconds\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`})]}),`\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`,_jsx(Heading,{level:`2`,id:`result-fields`,children:`Result fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.id`})}),_jsx(_components.td,{children:`Candidate UUID for voices_save_preview.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.kind`})}),_jsx(_components.td,{children:`clone or design.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.name`})}),_jsx(_components.td,{children:`Candidate display name.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.previewUrl`})}),_jsx(_components.td,{children:`Fresh temporary playable audio URL.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.expiresAt`})}),_jsx(_components.td,{children:`Candidate expiry as a Unix timestamp in milliseconds.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data.durationSeconds`})}),_jsx(_components.td,{children:`Preview audio duration in seconds.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`operation-notes`,children:`Operation notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`previewId is the candidate UUID returned in voicePreviews by voices_preview_clone, voices_design, or voices_list.`}),`\n`,_jsx(_components.li,{children:`Only ready, unsaved, unexpired previews are visible. A saved candidate moves to voices_list as clone:\u003cpreviewId>. Expired, saved, missing, and unowned candidates return VOICE_PREVIEW_NOT_FOUND here.`}),`\n`,_jsx(_components.li,{children:`The URL is temporary and can expire before expiresAt. Save the chosen candidate with voices_save_preview before the preview itself expires.`}),`\n`,_jsx(_components.li,{children:`Speech history and custom voices belong to the authenticated account. Team billing does not grant access to another member’s speech or voices.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`usage`,children:`Usage`}),`\n`,_jsx(_components.p,{children:`Each successful invocation consumes one monthly API/MCP call. Media credits and the operation’s own generation allowances also apply.`}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP status`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Meaning or recovery`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CREDENTIAL_IN_QUERY`})}),_jsx(_components.td,{children:`Credentials were supplied in an access_token or api_key query parameter. Send credentials in headers.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsx(_components.td,{children:`The input does not match the action schema; inspect details for field errors.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`API_KEY_EXPIRED`})}),_jsx(_components.td,{children:`The API key has expired.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_API_KEY`})}),_jsx(_components.td,{children:`Provide a valid, unexpired API key.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_CREDENTIAL`})}),_jsx(_components.td,{children:`The Authorization header is malformed or conflicts with x-api-key.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`MISSING_CREDENTIAL`})}),_jsx(_components.td,{children:`No usable header credential was supplied, or it exceeded 4096 characters.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`USER_NOT_FOUND`})}),_jsx(_components.td,{children:`The credential’s account no longer exists.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`AMBIGUOUS_TEAM_API_KEY`})}),_jsx(_components.td,{children:`The credential’s user belongs to more than one team, so the billing context is ambiguous.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INSUFFICIENT_SCOPE`})}),_jsx(_components.td,{children:`Grant every required permission or choose another credential.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INTEGRATION_PLAN_UNSUPPORTED`})}),_jsx(_components.td,{children:`The account’s integration limits could not be verified.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SUBSCRIPTION_REQUIRED`})}),_jsx(_components.td,{children:`Use an active paid subscription.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`TEAM_OWNER_NOT_FOUND`})}),_jsx(_components.td,{children:`The effective team owner account could not be found.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`USER_NOT_FOUND`})}),_jsx(_components.td,{children:`The authenticated account no longer exists.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VOICE_PREVIEW_NOT_FOUND`})}),_jsx(_components.td,{children:`The preview is missing, unowned, already saved, or expired.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INTEGRATION_MONTHLY_LIMIT_REACHED`})}),_jsx(_components.td,{children:`Wait for the monthly reset or change plan.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INTEGRATION_RATE_LIMIT_REACHED`})}),_jsx(_components.td,{children:`Wait for Retry-After when present and use backoff.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INTERNAL_ERROR`})}),_jsx(_components.td,{children:`Check saved request state and resource history before deciding to retry a mutation.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SERVER_RESTARTING`})}),_jsx(_components.td,{children:`The server is restarting. Retry shortly and keep the same request identifier for a mutation.`})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"INSUFFICIENT_SCOPE\"`}),_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:`\"This credential does not permit the requested action.\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`403`}),_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:` \"details\"`}),_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:` \"requiredScopes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"voices:read\"`}),_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`]})})})]})}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":"Get a voice preview","description":"Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.","api":"POST https://api.voicecheap.ai/v1/actions/voices_preview_get","playground":"simple","href":"/api-reference/actions/voices/voices-preview-get"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Authentication and permissions","slug":"authentication-and-permissions","depth":2,"children":[]},{"title":"Parameters","slug":"parameters","depth":2,"children":[]},{"title":"Request examples","slug":"request-examples","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Result fields","slug":"result-fields","depth":2,"children":[]},{"title":"Operation notes","slug":"operation-notes","depth":2,"children":[]},{"title":"Usage","slug":"usage","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --request\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.voicecheap.ai/v1/actions/voices_preview_get'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --header\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"x-api-key: \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">$VOICECHEAP_API_KEY\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --header\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type: application/json'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --data\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\"previewId\":\"44444444-4444-4444-8444-444444444444\"}'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"JavaScript","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"14\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> input\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> previewId:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '44444444-4444-4444-8444-444444444444'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">};\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'https://api.voicecheap.ai/v1/actions/voices_preview_get'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> method:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'POST'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'x-api-key'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> process\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">env\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\">VOICECHEAP_API_KEY\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'application/json'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> body:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> JSON\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">stringify\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">input\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> body\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">if\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">!\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">ok\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">throw\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> new\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> Error\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">body\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">code\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> +\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> ': '\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> +\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> body\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">message\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">console\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">log\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">body\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"13\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> os\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">response \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> requests.post(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.voicecheap.ai/v1/actions/voices_preview_get\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"x-api-key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: os.environ[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"VOICECHEAP_API_KEY\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> json\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"previewId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"44444444-4444-4444-8444-444444444444\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\"> timeout\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">120\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">body \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.json()\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">if\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> not\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.ok:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> raise\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4EC9B0\"> RuntimeError\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">f\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">body.get(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'code'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">{\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">body.get(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'message'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#DCDCAA\">print\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(body)\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"HTTP 200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"10\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"44444444-4444-4444-8444-444444444444\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"kind\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"clone\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Studio narrator\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"previewUrl\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://files.example.com/narrator-preview.mp3\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"expiresAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1792238400000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"durationSeconds\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">10\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Get a voice preview","path":"/v1/actions/voices_preview_get","servers":[{"url":"https://api.voicecheap.ai"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"x-api-key":{"schema":[{"type":"string","description":"Send a VoiceCheap API key in this header. Authorization: Bearer with the same API key is also supported. OAuth access tokens are accepted only by MCP, not by this REST endpoint.","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"previewId":[{"type":"string","description":"Text value. Format: “uuid”. Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$` .","required":true}]}}],"examples":{"example":{"value":{"previewId":"\u003cstring>"}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"voicecheap","siteName":"VoiceCheap Documentation","title":"Get a voice preview - VoiceCheap Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/actions/voices/voices-preview-get","matchLevel":0},"de":{"href":"/de/api-reference/actions/voices/voices-preview-get","matchLevel":1},"es":{"href":"/es/api-reference/actions/voices/voices-preview-get","matchLevel":1},"fr":{"href":"/fr/api-reference/actions/voices/voices-preview-get","matchLevel":1},"it":{"href":"/it/api-reference/actions/voices/voices-preview-get","matchLevel":1},"ja":{"href":"/ja/api-reference/actions/voices/voices-preview-get","matchLevel":1},"ko":{"href":"/ko/api-reference/actions/voices/voices-preview-get","matchLevel":1},"nl":{"href":"/nl/api-reference/actions/voices/voices-preview-get","matchLevel":1},"pl":{"href":"/pl/api-reference/actions/voices/voices-preview-get","matchLevel":1},"pt":{"href":"/pt/api-reference/actions/voices/voices-preview-get","matchLevel":1},"zh":{"href":"/zh/api-reference/actions/voices/voices-preview-get","matchLevel":1}}},"lastModified":"2026-11-14T11:26:56.585Z","originalFileLocation":"api-reference/actions/voices/voices-preview-get.mdx","locale":"en"},"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=\"Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.\">\u003cmeta data-mint-head name=\"keywords\" content=\"voicecheap documentation, voicecheap api, ai dubbing, video translation, voice cloning, lip-sync, SmartSync, subtitle generation, text to speech, speech to text, model context protocol\">\u003cmeta data-mint-head name=\"application-name\" content=\"VoiceCheap Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/voicecheap/CUwDktg-cO2zZwjP/_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=\"/docs/mintlify-assets/_mintlify/favicons/voicecheap/CUwDktg-cO2zZwjP/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/voicecheap/CUwDktg-cO2zZwjP/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/voicecheap/CUwDktg-cO2zZwjP/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/voicecheap/CUwDktg-cO2zZwjP/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/voicecheap/CUwDktg-cO2zZwjP/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/voicecheap/CUwDktg-cO2zZwjP/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/voicecheap/CUwDktg-cO2zZwjP/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/voicecheap/CUwDktg-cO2zZwjP/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a voice preview - VoiceCheap Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"VoiceCheap Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://voicecheap.mintlify.site/docs/_mintlify/api/og/v2?division=Speech+voices\u0026amp;title=Get+a+voice+preview\u0026amp;description=Get+a+playable+temporary+URL+for+your+unsaved+cloned+or+designed+voice+preview.+Use+voices_save_preview+to+keep+it+before+it+expires.\u0026amp;theme=fccabee10dd47edbc2b78a83\u0026amp;signature=71037138cd013a4b60251dcd108c870ce898dd52dd7177c2c0ac38e81746bf8e\">\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=\"Get a voice preview - VoiceCheap Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://voicecheap.mintlify.site/docs/_mintlify/api/og/v2?division=Speech+voices\u0026amp;title=Get+a+voice+preview\u0026amp;description=Get+a+playable+temporary+URL+for+your+unsaved+cloned+or+designed+voice+preview.+Use+voices_save_preview+to+keep+it+before+it+expires.\u0026amp;theme=fccabee10dd47edbc2b78a83\u0026amp;signature=71037138cd013a4b60251dcd108c870ce898dd52dd7177c2c0ac38e81746bf8e\">\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=\"/docs/mintlify-assets/_mintlify/favicons/voicecheap/CUwDktg-cO2zZwjP/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"VoiceCheap Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7C3AED\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#7C3AED\">\u003cmeta data-mint-head name=\"application-name\" content=\"VoiceCheap Documentation\">\u003clink data-mint-head rel=\"canonical\" href=\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/actions/voices/voices-preview-get.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://voicecheap.ai/docs/de/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://voicecheap.ai/docs/es/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://voicecheap.ai/docs/fr/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://voicecheap.ai/docs/it/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://voicecheap.ai/docs/ja/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://voicecheap.ai/docs/ko/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"nl\" href=\"https://voicecheap.ai/docs/nl/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pl\" href=\"https://voicecheap.ai/docs/pl/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://voicecheap.ai/docs/pt/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://voicecheap.ai/docs/zh/api-reference/actions/voices/voices-preview-get\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://voicecheap.ai/#organization\",\"name\":\"VoiceCheap Documentation\",\"url\":\"https://voicecheap.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/voicecheap/h-Bn773dalfhYrfJ/images/logo-light.png?fit=max\u0026auto=format\u0026n=h-Bn773dalfhYrfJ\u0026q=85\u0026s=4c1fb3404e1facd7b0d51c296871a6fa\"}},{\"@type\":\"WebSite\",\"@id\":\"https://voicecheap.ai/docs#website\",\"name\":\"VoiceCheap Documentation\",\"url\":\"https://voicecheap.ai/docs\",\"publisher\":{\"@id\":\"https://voicecheap.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get#webpage\",\"url\":\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get\",\"name\":\"Get a voice preview\",\"description\":\"Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.\",\"dateModified\":\"2026-11-14T11:26:56.585Z\",\"isPartOf\":{\"@id\":\"https://voicecheap.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Speech voices\",\"item\":\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-clone\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a voice preview\",\"item\":\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get#apireference\",\"headline\":\"Get a voice preview\",\"name\":\"Get a voice preview\",\"description\":\"Get a playable temporary URL for your unsaved cloned or designed voice preview. Use voices_save_preview to keep it before it expires.\",\"url\":\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get\",\"mainEntityOfPage\":{\"@id\":\"https://voicecheap.ai/docs/api-reference/actions/voices/voices-preview-get#webpage\"},\"dateModified\":\"2026-11-14T11:26:56.585Z\",\"publisher\":{\"@id\":\"https://voicecheap.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://voicecheap.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"VoiceCheap Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"VoiceCheap Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/actions/voices/voices-preview-get.md","siteName":"VoiceCheap Documentation","nav":{"global":null,"languages":[{"language":"en","default":true,"navbar":{"links":[{"href":"https://voicecheap.ai","label":"Website"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Community"},{"href":"mailto:contact@voicecheap.ai","label":"Support"}],"primary":{"type":"button","label":"Open app","href":"https://app.voicecheap.ai"}},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"Authentication","href":"/authentication"},{"title":"Actions and endpoints","href":"/api-reference/actions"},{"title":"Usage and limits","href":"/api-reference/limits"},{"title":"Error Codes","href":"/api-reference/errors"}]},{"group":"Discovery","pages":[{"title":"Get the action OpenAPI document","api":"GET https://api.voicecheap.ai/v1/openapi.json","playground":"simple","href":"/api-reference/discovery/openapi-get"},{"title":"List permitted actions","api":"GET https://api.voicecheap.ai/v1/actions","playground":"simple","href":"/api-reference/discovery/actions-list"}]},{"group":"Account","pages":[{"title":"Get account and credit balances","api":"POST https://api.voicecheap.ai/v1/actions/account_get","playground":"simple","href":"/api-reference/actions/account/account-get"}]},{"group":"Usage and activity","pages":[{"title":"Get API and MCP call usage","api":"POST https://api.voicecheap.ai/v1/actions/usage_get","playground":"simple","href":"/api-reference/actions/usage/usage-get"},{"title":"List media usage","api":"POST https://api.voicecheap.ai/v1/actions/usage_logs_list","playground":"simple","href":"/api-reference/actions/usage/usage-logs-list"},{"title":"Get project usage lifecycle","api":"POST https://api.voicecheap.ai/v1/actions/usage_project_get","playground":"simple","href":"/api-reference/actions/usage/usage-project-get"},{"title":"Get translation usage lifecycle","api":"POST https://api.voicecheap.ai/v1/actions/usage_translation_get","playground":"simple","href":"/api-reference/actions/usage/usage-translation-get"}]},{"group":"Settings and notifications","pages":[{"title":"Get notification preferences","api":"POST https://api.voicecheap.ai/v1/actions/notifications_get","playground":"simple","href":"/api-reference/actions/settings/notifications-get"},{"title":"Update notification preferences","api":"POST https://api.voicecheap.ai/v1/actions/notifications_update","playground":"simple","href":"/api-reference/actions/settings/notifications-update"},{"title":"Get account settings","api":"POST https://api.voicecheap.ai/v1/actions/settings_get","playground":"simple","href":"/api-reference/actions/settings/settings-get"},{"title":"Update account settings","api":"POST https://api.voicecheap.ai/v1/actions/settings_update","playground":"simple","href":"/api-reference/actions/settings/settings-update"}]},{"group":"Team","pages":[{"title":"Add a team member","api":"POST https://api.voicecheap.ai/v1/actions/team_add_member","playground":"simple","href":"/api-reference/actions/team/team-add-member"},{"title":"Create your team","api":"POST https://api.voicecheap.ai/v1/actions/team_create","playground":"simple","href":"/api-reference/actions/team/team-create"},{"title":"Get your team","api":"POST https://api.voicecheap.ai/v1/actions/team_get","playground":"simple","href":"/api-reference/actions/team/team-get"},{"title":"Remove a team member","api":"POST https://api.voicecheap.ai/v1/actions/team_remove_member","playground":"simple","href":"/api-reference/actions/team/team-remove-member"}]},{"group":"Projects","pages":[{"title":"Create Project","api":"POST https://api.voicecheap.ai/v1/projects","playground":"none","href":"/api-reference/create-project"},{"title":"Get Project Details","api":"GET https://api.voicecheap.ai/v1/projects/{projectId}","playground":"none","href":"/api-reference/project-details"},{"title":"Delete Project","api":"DELETE https://api.voicecheap.ai/v1/translate/{projectId}","playground":"none","href":"/api-reference/delete-project"},{"title":"Get Translation Status","api":"GET https://api.voicecheap.ai/v1/translate/{projectId}/status","playground":"none","href":"/api-reference/translation-status"},{"title":"Create and transcribe a project","api":"POST https://api.voicecheap.ai/v1/actions/projects_create","playground":"simple","href":"/api-reference/actions/projects/projects-create"},{"title":"Delete a project","api":"POST https://api.voicecheap.ai/v1/actions/projects_delete","playground":"simple","href":"/api-reference/actions/projects/projects-delete"},{"title":"Get a project","api":"POST https://api.voicecheap.ai/v1/actions/projects_get","playground":"simple","href":"/api-reference/actions/projects/projects-get"},{"title":"List or search projects","api":"POST https://api.voicecheap.ai/v1/actions/projects_list","playground":"simple","href":"/api-reference/actions/projects/projects-list"},{"title":"Get project processing status","api":"POST https://api.voicecheap.ai/v1/actions/projects_status","playground":"simple","href":"/api-reference/actions/projects/projects-status"},{"title":"Update project settings","api":"POST https://api.voicecheap.ai/v1/actions/projects_update","playground":"simple","href":"/api-reference/actions/projects/projects-update"},{"title":"Abort a media upload for projects","api":"POST https://api.voicecheap.ai/v1/actions/projects_upload_abort","playground":"simple","href":"/api-reference/actions/projects/projects-upload-abort"},{"title":"Complete a media upload for projects","api":"POST https://api.voicecheap.ai/v1/actions/projects_upload_complete","playground":"simple","href":"/api-reference/actions/projects/projects-upload-complete"},{"title":"Import media from a URL for projects","api":"POST https://api.voicecheap.ai/v1/actions/projects_upload_import","playground":"simple","href":"/api-reference/actions/projects/projects-upload-import"},{"title":"Initialize a media upload for projects","api":"POST https://api.voicecheap.ai/v1/actions/projects_upload_initialize","playground":"simple","href":"/api-reference/actions/projects/projects-upload-initialize"},{"title":"Sign upload parts for projects","api":"POST https://api.voicecheap.ai/v1/actions/projects_upload_sign_parts","playground":"simple","href":"/api-reference/actions/projects/projects-upload-sign-parts"}]},{"group":"Translation and dubbing","pages":[{"title":"Start Translation","api":"POST https://api.voicecheap.ai/v1/translate","playground":"none","href":"/api-reference/translate"},{"title":"Dub Project","api":"POST https://api.voicecheap.ai/v1/projects/{projectId}/dub","playground":"none","href":"/api-reference/dub-project"},{"title":"Lip-sync a translated video","api":"POST https://api.voicecheap.ai/v1/actions/lipsync_create","playground":"simple","href":"/api-reference/actions/translations/lipsync-create"},{"title":"Add a target language","api":"POST https://api.voicecheap.ai/v1/actions/translations_add","playground":"simple","href":"/api-reference/actions/translations/translations-add"},{"title":"Create a translated video or audio project","api":"POST https://api.voicecheap.ai/v1/actions/translations_create","playground":"simple","href":"/api-reference/actions/translations/translations-create"},{"title":"Dub a supplied translation","api":"POST https://api.voicecheap.ai/v1/actions/translations_dub","playground":"simple","href":"/api-reference/actions/translations/translations-dub"},{"title":"Get a language work","api":"POST https://api.voicecheap.ai/v1/actions/translations_get","playground":"simple","href":"/api-reference/actions/translations/translations-get"},{"title":"List project language works","api":"POST https://api.voicecheap.ai/v1/actions/translations_list","playground":"simple","href":"/api-reference/actions/translations/translations-list"},{"title":"Translate an existing project","api":"POST https://api.voicecheap.ai/v1/actions/translations_start","playground":"simple","href":"/api-reference/actions/translations/translations-start"},{"title":"Update proofreading state","api":"POST https://api.voicecheap.ai/v1/actions/translations_update","playground":"simple","href":"/api-reference/actions/translations/translations-update"}]},{"group":"Transcripts and editing","pages":[{"title":"Export Project Transcript","api":"POST https://api.voicecheap.ai/v1/projects/{projectId}/transcript","playground":"none","href":"/api-reference/project-transcript"},{"title":"Cancel a queued segment action","api":"POST https://api.voicecheap.ai/v1/actions/segment_actions_cancel","playground":"simple","href":"/api-reference/actions/editing/segment-actions-cancel"},{"title":"Get queued segment actions","api":"POST https://api.voicecheap.ai/v1/actions/segment_actions_list","playground":"simple","href":"/api-reference/actions/editing/segment-actions-list"},{"title":"Delete a segment","api":"POST https://api.voicecheap.ai/v1/actions/segments_delete","playground":"simple","href":"/api-reference/actions/editing/segments-delete"},{"title":"Merge adjacent segments","api":"POST https://api.voicecheap.ai/v1/actions/segments_merge","playground":"simple","href":"/api-reference/actions/editing/segments-merge"},{"title":"Regenerate segment speech","api":"POST https://api.voicecheap.ai/v1/actions/segments_regenerate","playground":"simple","href":"/api-reference/actions/editing/segments-regenerate"},{"title":"Assign a segment speaker","api":"POST https://api.voicecheap.ai/v1/actions/segments_speaker_update","playground":"simple","href":"/api-reference/actions/editing/segments-speaker-update"},{"title":"Edit a transcript segment","api":"POST https://api.voicecheap.ai/v1/actions/segments_text_update","playground":"simple","href":"/api-reference/actions/editing/segments-text-update"},{"title":"Edit segment timing","api":"POST https://api.voicecheap.ai/v1/actions/segments_timestamps_update","playground":"simple","href":"/api-reference/actions/editing/segments-timestamps-update"},{"title":"Remove a speaker","api":"POST https://api.voicecheap.ai/v1/actions/speakers_remove","playground":"simple","href":"/api-reference/actions/editing/speakers-remove"},{"title":"Get or export a project transcript","api":"POST https://api.voicecheap.ai/v1/actions/transcripts_get","playground":"simple","href":"/api-reference/actions/editing/transcripts-get"}]},{"group":"Text to speech","pages":[{"title":"Align speech words","api":"POST https://api.voicecheap.ai/v1/actions/tts_align","playground":"simple","href":"/api-reference/actions/tts/tts-align"},{"title":"Complete a speech preview","api":"POST https://api.voicecheap.ai/v1/actions/tts_continue","playground":"simple","href":"/api-reference/actions/tts/tts-continue"},{"title":"Download generated speech","api":"POST https://api.voicecheap.ai/v1/actions/tts_download","playground":"simple","href":"/api-reference/actions/tts/tts-download"},{"title":"Generate speech","api":"POST https://api.voicecheap.ai/v1/actions/tts_generate","playground":"simple","href":"/api-reference/actions/tts/tts-generate"},{"title":"Get generated speech","api":"POST https://api.voicecheap.ai/v1/actions/tts_get","playground":"simple","href":"/api-reference/actions/tts/tts-get"},{"title":"List generated speech","api":"POST https://api.voicecheap.ai/v1/actions/tts_list","playground":"simple","href":"/api-reference/actions/tts/tts-list"}]},{"group":"Speech voices","pages":[{"title":"Clone and save a voice","api":"POST https://api.voicecheap.ai/v1/actions/voices_clone","playground":"simple","href":"/api-reference/actions/voices/voices-clone"},{"title":"Delete a saved voice","api":"POST https://api.voicecheap.ai/v1/actions/voices_delete","playground":"simple","href":"/api-reference/actions/voices/voices-delete"},{"title":"Design a voice","api":"POST https://api.voicecheap.ai/v1/actions/voices_design","playground":"simple","href":"/api-reference/actions/voices/voices-design"},{"title":"List voices and voice previews","api":"POST https://api.voicecheap.ai/v1/actions/voices_list","playground":"simple","href":"/api-reference/actions/voices/voices-list"},{"title":"Preview a cloned voice","description":"Create a temporary voice clone preview from 1–3 owned audio uploads with explicit permission. Uses the app’s clone trial allowance. Save the selected preview before its expiry to retain it.","api":"POST https://api.voicecheap.ai/v1/actions/voices_preview_clone","playground":"simple","href":"/api-reference/actions/voices/voices-preview-clone"},{"title":"Get a voice preview","api":"POST https://api.voicecheap.ai/v1/actions/voices_preview_get","playground":"simple","href":"/api-reference/actions/voices/voices-preview-get"},{"title":"Save a voice preview","description":"Save an owned, unexpired cloned or designed voice preview as a reusable voice. Repeated saves of the same preview reuse the saved voice.","api":"POST https://api.voicecheap.ai/v1/actions/voices_save_preview","playground":"simple","href":"/api-reference/actions/voices/voices-save-preview"},{"title":"Abort a media upload for voice samples","api":"POST https://api.voicecheap.ai/v1/actions/voices_upload_abort","playground":"simple","href":"/api-reference/actions/voices/voices-upload-abort"},{"title":"Complete a media upload for voice samples","api":"POST https://api.voicecheap.ai/v1/actions/voices_upload_complete","playground":"simple","href":"/api-reference/actions/voices/voices-upload-complete"},{"title":"Initialize a media upload for voice samples","api":"POST https://api.voicecheap.ai/v1/actions/voices_upload_initialize","playground":"simple","href":"/api-reference/actions/voices/voices-upload-initialize"},{"title":"Sign upload parts for voice samples","api":"POST https://api.voicecheap.ai/v1/actions/voices_upload_sign_parts","playground":"simple","href":"/api-reference/actions/voices/voices-upload-sign-parts"}]},{"group":"Dubbing voices","pages":[{"title":"Clone a dubbing voice","api":"POST https://api.voicecheap.ai/v1/actions/dubbing_voices_clone","playground":"simple","href":"/api-reference/actions/dubbing-voices/dubbing-voices-clone"},{"title":"Delete a custom dubbing voice","api":"POST https://api.voicecheap.ai/v1/actions/dubbing_voices_delete","playground":"simple","href":"/api-reference/actions/dubbing-voices/dubbing-voices-delete"},{"title":"Get a dubbing voice","api":"POST https://api.voicecheap.ai/v1/actions/dubbing_voices_get","playground":"simple","href":"/api-reference/actions/dubbing-voices/dubbing-voices-get"},{"title":"List dubbing voices","api":"POST https://api.voicecheap.ai/v1/actions/dubbing_voices_list","playground":"simple","href":"/api-reference/actions/dubbing-voices/dubbing-voices-list"}]},{"group":"Transcription","pages":[{"title":"Transcribe Media","api":"POST https://api.voicecheap.ai/v1/transcribe","playground":"none","href":"/api-reference/transcribe"},{"title":"Abort a media upload for transcription","api":"POST https://api.voicecheap.ai/v1/actions/tools_upload_abort","playground":"simple","href":"/api-reference/actions/transcription/tools-upload-abort"},{"title":"Complete a media upload for transcription","api":"POST https://api.voicecheap.ai/v1/actions/tools_upload_complete","playground":"simple","href":"/api-reference/actions/transcription/tools-upload-complete"},{"title":"Import media from a URL for transcription","api":"POST https://api.voicecheap.ai/v1/actions/tools_upload_import","playground":"simple","href":"/api-reference/actions/transcription/tools-upload-import"},{"title":"Initialize a media upload for transcription","api":"POST https://api.voicecheap.ai/v1/actions/tools_upload_initialize","playground":"simple","href":"/api-reference/actions/transcription/tools-upload-initialize"},{"title":"Sign upload parts for transcription","api":"POST https://api.voicecheap.ai/v1/actions/tools_upload_sign_parts","playground":"simple","href":"/api-reference/actions/transcription/tools-upload-sign-parts"},{"title":"Transcribe media","api":"POST https://api.voicecheap.ai/v1/actions/transcription_create","playground":"simple","href":"/api-reference/actions/transcription/transcription-create"},{"title":"Export a transcript","api":"POST https://api.voicecheap.ai/v1/actions/transcription_export","playground":"simple","href":"/api-reference/actions/transcription/transcription-export"},{"title":"Get transcription result","api":"POST https://api.voicecheap.ai/v1/actions/transcription_history_get","playground":"simple","href":"/api-reference/actions/transcription/transcription-history-get"},{"title":"List transcription history","api":"POST https://api.voicecheap.ai/v1/actions/transcription_history_list","playground":"simple","href":"/api-reference/actions/transcription/transcription-history-list"},{"title":"Export a saved transcription action result","api":"POST https://api.voicecheap.ai/v1/actions/transcription_result_download","playground":"simple","href":"/api-reference/actions/transcription/transcription-result-download"},{"title":"Read a saved transcription action result","api":"POST https://api.voicecheap.ai/v1/actions/transcription_result_get","playground":"simple","href":"/api-reference/actions/transcription/transcription-result-get"},{"title":"List saved transcription action results","api":"POST https://api.voicecheap.ai/v1/actions/transcription_result_list","playground":"simple","href":"/api-reference/actions/transcription/transcription-result-list"},{"title":"Create YouTube chapters","api":"POST https://api.voicecheap.ai/v1/actions/youtube_chapters_create","playground":"simple","href":"/api-reference/actions/transcription/youtube-chapters-create"},{"title":"Export YouTube chapters","api":"POST https://api.voicecheap.ai/v1/actions/youtube_chapters_export","playground":"simple","href":"/api-reference/actions/transcription/youtube-chapters-export"},{"title":"Get YouTube chapters result","api":"POST https://api.voicecheap.ai/v1/actions/youtube_chapters_history_get","playground":"simple","href":"/api-reference/actions/transcription/youtube-chapters-history-get"},{"title":"List YouTube chapters history","api":"POST https://api.voicecheap.ai/v1/actions/youtube_chapters_history_list","playground":"simple","href":"/api-reference/actions/transcription/youtube-chapters-history-list"},{"title":"Transcribe a YouTube video","api":"POST https://api.voicecheap.ai/v1/actions/youtube_transcript_create","playground":"simple","href":"/api-reference/actions/transcription/youtube-transcript-create"},{"title":"Export a YouTube transcript","api":"POST https://api.voicecheap.ai/v1/actions/youtube_transcript_export","playground":"simple","href":"/api-reference/actions/transcription/youtube-transcript-export"},{"title":"Get YouTube transcript result","api":"POST https://api.voicecheap.ai/v1/actions/youtube_transcript_history_get","playground":"simple","href":"/api-reference/actions/transcription/youtube-transcript-history-get"},{"title":"List YouTube transcript history","api":"POST https://api.voicecheap.ai/v1/actions/youtube_transcript_history_list","playground":"simple","href":"/api-reference/actions/transcription/youtube-transcript-history-list"}]},{"group":"Subtitles and captions","pages":[{"title":"Create timed caption words","api":"POST https://api.voicecheap.ai/v1/actions/captions_transcribe","playground":"simple","href":"/api-reference/actions/subtitles/captions-transcribe"},{"title":"Add subtitles to a video","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_burn","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-burn"},{"title":"Download a subtitled video","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_burn_download","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-burn-download"},{"title":"Get subtitled video result","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_burn_history_get","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-burn-history-get"},{"title":"List subtitled video history","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_burn_history_list","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-burn-history-list"},{"title":"Add subtitles to a YouTube video","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_burn_youtube","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-burn-youtube"},{"title":"Create SRT subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_create","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-create"},{"title":"Add dynamic subtitles to a translation","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_dynamic_create","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-dynamic-create"},{"title":"Export saved SRT subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_export","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-export"},{"title":"Duplicate saved subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_history_duplicate","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-history-duplicate"},{"title":"Get subtitle result","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_history_get","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-history-get"},{"title":"List subtitle history","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_history_list","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-history-list"},{"title":"Edit saved subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_history_update","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-history-update"},{"title":"Export a saved subtitles action result","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_result_download","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-result-download"},{"title":"Read a saved subtitles action result","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_result_get","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-result-get"},{"title":"List saved subtitles action results","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_result_list","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-result-list"},{"title":"Translate subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_translate","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-translate"},{"title":"Export translated subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_translation_export","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-translation-export"},{"title":"Get subtitle translation result","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_translation_history_get","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-translation-history-get"},{"title":"List subtitle translation history","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_translation_history_list","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-translation-history-list"},{"title":"Abort a media upload for subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_upload_abort","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-upload-abort"},{"title":"Complete a media upload for subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_upload_complete","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-upload-complete"},{"title":"Import media from a URL for subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_upload_import","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-upload-import"},{"title":"Initialize a media upload for subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_upload_initialize","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-upload-initialize"},{"title":"Sign upload parts for subtitles","api":"POST https://api.voicecheap.ai/v1/actions/subtitles_upload_sign_parts","playground":"simple","href":"/api-reference/actions/subtitles/subtitles-upload-sign-parts"}]},{"group":"Images","pages":[{"title":"Download a generated image","api":"POST https://api.voicecheap.ai/v1/actions/images_download","playground":"simple","href":"/api-reference/actions/images/images-download"},{"title":"Generate an image","api":"POST https://api.voicecheap.ai/v1/actions/images_generate","playground":"simple","href":"/api-reference/actions/images/images-generate"},{"title":"Get an image generation","api":"POST https://api.voicecheap.ai/v1/actions/images_get","playground":"simple","href":"/api-reference/actions/images/images-get"},{"title":"List generated images","api":"POST https://api.voicecheap.ai/v1/actions/images_list","playground":"simple","href":"/api-reference/actions/images/images-list"},{"title":"Cancel a image reference upload","api":"POST https://api.voicecheap.ai/v1/actions/images_upload_abort","playground":"simple","href":"/api-reference/actions/images/images-upload-abort"},{"title":"Complete a image reference upload","api":"POST https://api.voicecheap.ai/v1/actions/images_upload_complete","playground":"simple","href":"/api-reference/actions/images/images-upload-complete"},{"title":"Initialize a image reference upload","api":"POST https://api.voicecheap.ai/v1/actions/images_upload_initialize","playground":"simple","href":"/api-reference/actions/images/images-upload-initialize"},{"title":"Get image reference upload URLs","api":"POST https://api.voicecheap.ai/v1/actions/images_upload_sign_parts","playground":"simple","href":"/api-reference/actions/images/images-upload-sign-parts"}]},{"group":"Thumbnails","pages":[{"title":"Download a generated thumbnail","api":"POST https://api.voicecheap.ai/v1/actions/thumbnails_download","playground":"simple","href":"/api-reference/actions/thumbnails/thumbnails-download"},{"title":"Generate a YouTube thumbnail","api":"POST https://api.voicecheap.ai/v1/actions/thumbnails_generate","playground":"simple","href":"/api-reference/actions/thumbnails/thumbnails-generate"},{"title":"Get a thumbnail generation","api":"POST https://api.voicecheap.ai/v1/actions/thumbnails_get","playground":"simple","href":"/api-reference/actions/thumbnails/thumbnails-get"},{"title":"List generated thumbnails","api":"POST https://api.voicecheap.ai/v1/actions/thumbnails_list","playground":"simple","href":"/api-reference/actions/thumbnails/thumbnails-list"},{"title":"Cancel a thumbnail reference upload","api":"POST https://api.voicecheap.ai/v1/actions/thumbnails_upload_abort","playground":"simple","href":"/api-reference/actions/thumbnails/thumbnails-upload-abort"},{"title":"Complete a thumbnail reference upload","api":"POST https://api.voicecheap.ai/v1/actions/thumbnails_upload_complete","playground":"simple","href":"/api-reference/actions/thumbnails/thumbnails-upload-complete"},{"title":"Initialize a thumbnail reference upload","api":"POST https://api.voicecheap.ai/v1/actions/thumbnails_upload_initialize","playground":"simple","href":"/api-reference/actions/thumbnails/thumbnails-upload-initialize"},{"title":"Get thumbnail reference upload URLs","api":"POST https://api.voicecheap.ai/v1/actions/thumbnails_upload_sign_parts","playground":"simple","href":"/api-reference/actions/thumbnails/thumbnails-upload-sign-parts"}]},{"group":"Folders","pages":[{"title":"Create a folder","api":"POST https://api.voicecheap.ai/v1/actions/folders_create","playground":"simple","href":"/api-reference/actions/folders/folders-create"},{"title":"Delete a folder","api":"POST https://api.voicecheap.ai/v1/actions/folders_delete","playground":"simple","href":"/api-reference/actions/folders/folders-delete"},{"title":"Get a folder","api":"POST https://api.voicecheap.ai/v1/actions/folders_get","playground":"simple","href":"/api-reference/actions/folders/folders-get"},{"title":"List folders","api":"POST https://api.voicecheap.ai/v1/actions/folders_list","playground":"simple","href":"/api-reference/actions/folders/folders-list"},{"title":"Add a project to a folder","api":"POST https://api.voicecheap.ai/v1/actions/folders_project_add","playground":"simple","href":"/api-reference/actions/folders/folders-project-add"},{"title":"Remove a project from a folder","api":"POST https://api.voicecheap.ai/v1/actions/folders_project_remove","playground":"simple","href":"/api-reference/actions/folders/folders-project-remove"},{"title":"Update a folder","api":"POST https://api.voicecheap.ai/v1/actions/folders_update","playground":"simple","href":"/api-reference/actions/folders/folders-update"}]},{"group":"Glossary","pages":[{"title":"Delete a glossary entry","api":"POST https://api.voicecheap.ai/v1/actions/glossary_entry_delete","playground":"simple","href":"/api-reference/actions/glossary/glossary-entry-delete"},{"title":"Update a glossary entry","api":"POST https://api.voicecheap.ai/v1/actions/glossary_entry_update","playground":"simple","href":"/api-reference/actions/glossary/glossary-entry-update"},{"title":"Create or update a glossary entry","api":"POST https://api.voicecheap.ai/v1/actions/glossary_entry_upsert","playground":"simple","href":"/api-reference/actions/glossary/glossary-entry-upsert"},{"title":"Get a glossary","api":"POST https://api.voicecheap.ai/v1/actions/glossary_get","playground":"simple","href":"/api-reference/actions/glossary/glossary-get"},{"title":"Import glossary entries","api":"POST https://api.voicecheap.ai/v1/actions/glossary_import","playground":"simple","href":"/api-reference/actions/glossary/glossary-import"},{"title":"List glossary languages","api":"POST https://api.voicecheap.ai/v1/actions/glossary_languages_list","playground":"simple","href":"/api-reference/actions/glossary/glossary-languages-list"},{"title":"Set glossary application mode","api":"POST https://api.voicecheap.ai/v1/actions/glossary_mode_update","playground":"simple","href":"/api-reference/actions/glossary/glossary-mode-update"}]},{"group":"Webhooks","pages":[{"title":"Webhooks","href":"/api-reference/webhooks"},{"title":"Create or rotate a webhook signing secret","api":"POST https://api.voicecheap.ai/v1/actions/webhooks_create_secret","playground":"simple","href":"/api-reference/actions/webhooks/webhooks-create-secret"},{"title":"Delete webhook configuration","api":"POST https://api.voicecheap.ai/v1/actions/webhooks_delete","playground":"simple","href":"/api-reference/actions/webhooks/webhooks-delete"},{"title":"Get webhook settings","api":"POST https://api.voicecheap.ai/v1/actions/webhooks_get","playground":"simple","href":"/api-reference/actions/webhooks/webhooks-get"},{"title":"Update webhook URL","api":"POST https://api.voicecheap.ai/v1/actions/webhooks_update","playground":"simple","href":"/api-reference/actions/webhooks/webhooks-update"}]},{"group":"Publishing","pages":[{"title":"List connected publishing channels","api":"POST https://api.voicecheap.ai/v1/actions/publishing_channels_list","playground":"simple","href":"/api-reference/actions/publishing/publishing-channels-list"},{"title":"Get project publication state","api":"POST https://api.voicecheap.ai/v1/actions/publishing_list","playground":"simple","href":"/api-reference/actions/publishing/publishing-list"},{"title":"Publish original video","api":"POST https://api.voicecheap.ai/v1/actions/publishing_original_create","playground":"simple","href":"/api-reference/actions/publishing/publishing-original-create"},{"title":"Publish a translated video","api":"POST https://api.voicecheap.ai/v1/actions/publishing_translation_create","playground":"simple","href":"/api-reference/actions/publishing/publishing-translation-create"}]},{"group":"Request status","pages":[{"title":"Get action request status","api":"POST https://api.voicecheap.ai/v1/actions/action_request_get","playground":"simple","href":"/api-reference/actions/requests/action-request-get"}]},{"group":"OAuth and MCP protocol","pages":[{"title":"Get protected-resource metadata","api":"GET https://api.voicecheap.ai/.well-known/oauth-protected-resource","playground":"simple","href":"/api-reference/oauth/oauth-protected-resource-get"},{"title":"Get MCP protected-resource metadata","api":"GET https://api.voicecheap.ai/.well-known/oauth-protected-resource/mcp","playground":"simple","href":"/api-reference/oauth/oauth-protected-resource-mcp-get"},{"title":"Get authorization-server metadata","api":"GET https://api.voicecheap.ai/.well-known/oauth-authorization-server","playground":"simple","href":"/api-reference/oauth/oauth-authorization-server-get"},{"title":"Register an MCP OAuth client","api":"POST https://api.voicecheap.ai/oauth/register","playground":"simple","href":"/api-reference/oauth/oauth-client-register"},{"title":"Start MCP account authorization","api":"GET https://api.voicecheap.ai/oauth/authorize","playground":"simple","href":"/api-reference/oauth/oauth-authorize"},{"title":"Exchange an authorization code or rotate a refresh token","api":"POST https://api.voicecheap.ai/oauth/token","playground":"simple","href":"/api-reference/oauth/oauth-token-exchange"},{"title":"Revoke an MCP OAuth connection","api":"POST https://api.voicecheap.ai/oauth/revoke","playground":"simple","href":"/api-reference/oauth/oauth-token-revoke"},{"title":"Send a stateless MCP message","api":"POST https://api.voicecheap.ai/mcp","playground":"simple","href":"/api-reference/oauth/mcp-message-post"},{"title":"Get OpenID Connect discovery metadata","api":"GET https://api.voicecheap.ai/.well-known/openid-configuration","playground":"simple","href":"/api-reference/oauth/oidc-discovery-get"},{"title":"Get ID-token verification keys","api":"GET https://api.voicecheap.ai/oauth/jwks","playground":"simple","href":"/api-reference/oauth/oidc-jwks-get"},{"title":"Get the connected user identity","api":"GET https://api.voicecheap.ai/oauth/userinfo","playground":"simple","href":"/api-reference/oauth/oidc-userinfo-get"},{"title":"Get the connected user identity (POST)","api":"POST https://api.voicecheap.ai/oauth/userinfo","playground":"simple","href":"/api-reference/oauth/oidc-userinfo-post"}]}]}]},{"language":"de","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Webseite"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Gemeinschaft"},{"href":"mailto:contact@voicecheap.ai","label":"Hilfe"}],"primary":{"type":"button","label":"App öffnen","href":"https://app.voicecheap.ai"}},"pages":[{"title":"de","href":"/de/api-reference/actions/voices/voices-preview-get"}]},{"language":"es","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Sitio web"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Comunidad"},{"href":"mailto:contact@voicecheap.ai","label":"Soporte"}],"primary":{"type":"button","label":"Abrir la aplicación","href":"https://app.voicecheap.ai"}},"pages":[{"title":"es","href":"/es/api-reference/actions/voices/voices-preview-get"}]},{"language":"fr","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Site web"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Communauté"},{"href":"mailto:contact@voicecheap.ai","label":"Assistance"}],"primary":{"type":"button","label":"Ouvrir l’application","href":"https://app.voicecheap.ai"}},"pages":[{"title":"fr","href":"/fr/api-reference/actions/voices/voices-preview-get"}]},{"language":"it","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Sito web"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Comunità"},{"href":"mailto:contact@voicecheap.ai","label":"Assistenza"}],"primary":{"type":"button","label":"Apri l’app","href":"https://app.voicecheap.ai"}},"pages":[{"title":"it","href":"/it/api-reference/actions/voices/voices-preview-get"}]},{"language":"ja","navbar":{"links":[{"href":"https://voicecheap.ai","label":"ウェブサイト"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"コミュニティ"},{"href":"mailto:contact@voicecheap.ai","label":"サポート"}],"primary":{"type":"button","label":"アプリを開く","href":"https://app.voicecheap.ai"}},"pages":[{"title":"ja","href":"/ja/api-reference/actions/voices/voices-preview-get"}]},{"language":"ko","navbar":{"links":[{"href":"https://voicecheap.ai","label":"웹사이트"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"커뮤니티"},{"href":"mailto:contact@voicecheap.ai","label":"지원"}],"primary":{"type":"button","label":"앱 열기","href":"https://app.voicecheap.ai"}},"pages":[{"title":"ko","href":"/ko/api-reference/actions/voices/voices-preview-get"}]},{"language":"nl","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Website"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Gemeenschap"},{"href":"mailto:contact@voicecheap.ai","label":"Ondersteuning"}],"primary":{"type":"button","label":"App openen","href":"https://app.voicecheap.ai"}},"pages":[{"title":"nl","href":"/nl/api-reference/actions/voices/voices-preview-get"}]},{"language":"pl","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Strona internetowa"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Społeczność"},{"href":"mailto:contact@voicecheap.ai","label":"Pomoc"}],"primary":{"type":"button","label":"Otwórz aplikację","href":"https://app.voicecheap.ai"}},"pages":[{"title":"pl","href":"/pl/api-reference/actions/voices/voices-preview-get"}]},{"language":"pt","navbar":{"links":[{"href":"https://voicecheap.ai","label":"Site"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"Comunidade"},{"href":"mailto:contact@voicecheap.ai","label":"Suporte"}],"primary":{"type":"button","label":"Abrir o aplicativo","href":"https://app.voicecheap.ai"}},"pages":[{"title":"pt","href":"/pt/api-reference/actions/voices/voices-preview-get"}]},{"language":"zh","navbar":{"links":[{"href":"https://voicecheap.ai","label":"网站"},{"href":"https://discord.gg/Bg2eDM9MR5","label":"社区"},{"href":"mailto:contact@voicecheap.ai","label":"支持"}],"primary":{"type":"button","label":"打开应用","href":"https://app.voicecheap.ai"}},"pages":[{"title":"zh","href":"/zh/api-reference/actions/voices/voices-preview-get"}]}]},"basePath":"","title":"Get a voice preview - VoiceCheap Documentation","deploymentId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","buildId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-tiVafkWW.js","utils-CURQcKis.js","cloneDeep-D7WNbvHt.js","_Uint8Array-BY_XlfVz.js","isObject-FP1Yky1u.js","utils-CdFTKPRO.js","addUniqueKeysToSchema-BSfwE63N.js","snippetPresets-BHyg8yZ0.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CQdVXSju.js","isEqual-ft5OxoSH.js","usePlaygroundInputsStore-BILH4rrw.js","shallow-DterCiSU.js","getApiPlaygroundDisplay-uFtORr6j.js","CodeSnippet-BeuhEvUS.js","CodeSnippets-laCoJsvn.js","Page-CTsmHnLF.js","getPastedJson-DOT1n5Lt.js","icon-COH-nmcZ.js","MethodPill-BbAWkCf6.js","DuplicateIcon-CpagiAFQ.js","createIcon-Bw2Dnowf.js","DynamicMarkdown-DzuINhDe.js","SectionHeading-B3H20qI6.js","axios-vUo_bRtp.js"]}