보이스 1건을 조회합니다. options에는 이 보이스에 쓸 수 있는 language·model 조합이 모두 들어 있으며, 조합 하나가 GET /v3/models/voices 응답 항목 하나에 해당합니다. 다른 워크스페이스의 비공개 보이스나 워크스페이스에서 허용하지 않은 provider의 보이스처럼 이 워크스페이스에서 볼 수 없는 보이스는 존재하지 않는 보이스와 동일하게 404를 반환합니다.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"vox.ai 문서","colors":{"primary":"#7c3aed","light":"#8b5cf6","dark":"#7c3aed"},"logo":{"light":"https://mintcdn.com/fleek/QLXPdp5do4SgNyXm/logo/light.svg?fit=max\u0026auto=format\u0026n=QLXPdp5do4SgNyXm\u0026q=85\u0026s=ca85e066068138abac22f638eed5dad0","dark":"https://mintcdn.com/fleek/QLXPdp5do4SgNyXm/logo/dark.svg?fit=max\u0026auto=format\u0026n=QLXPdp5do4SgNyXm\u0026q=85\u0026s=1daf9753a36ae7f1823e7ad11a0c2ddd","href":"https://www.tryvox.co"},"favicon":"https://mintcdn.com/fleek/QLXPdp5do4SgNyXm/favicon.svg?fit=max\u0026auto=format\u0026n=QLXPdp5do4SgNyXm\u0026q=85\u0026s=5342cc9f9f6f14f773e41f5a78a1fb84","background":{"decoration":"gradient"},"navbar":{"links":[],"primary":{"type":"button","label":"대시보드","href":"https://www.tryvox.co/dashboard/"}},"footer":{"socials":{"discord":"https://discord.gg/GKxHxG97u5","youtube":"https://www.youtube.com/@try-vox-ai?ref=docs","linkedin":"https://www.linkedin.com/company/try-vox-ai?ref=docs"},"links":[{"header":"회사","items":[{"label":"채용","href":"https://tryvox.notion.site/vox-ai-1dc5249049c8803caf96f8074ae4ecce"},{"label":"블로그","href":"https://blog.tryvox.co/?ref=docs"},{"label":"서비스 소개서","href":"https://featpaper.com/l/cURVGDZK"},{"label":"도입 문의","href":"https://www.tryvox.co/request-demo?ref=docs"},{"label":"온보딩","href":"https://cal.com/busking/vox-onboarding"}]},{"header":"정책","items":[{"label":"이용약관","href":"https://tryvox.co/legal/terms-of-service"},{"label":"개인정보처리방침","href":"https://tryvox.co/legal/privacy-policy"}]}]},"seo":{"metatags":{"description":"vox.ai로 AI 음성 에이전트를 만들고, 테스트하고, 배포하고, 모니터링할 수 있어요.","keywords":"AICC, AI 음성 에이전트, SDK, 음성 AI","language":"ko"},"indexing":"all"},"fonts":{"heading":{"family":"Pretendard Variable","weight":600,"source":"fonts/PretendardVariable.woff2","format":"woff2"},"body":{"family":"Pretendard Variable","weight":400,"source":"fonts/PretendardVariable.woff2","format":"woff2"}},"banner":{"content":"vox.ai 디스코드 커뮤니티가 열렸어요. [커뮤니티 참여](https://discord.gg/GKxHxG97u5)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fleek","hasAudioNarration":false,"actualSubdomain":"fleek","customDomains":["docs.tryvox.co"],"gitSource":{"type":"github","owner":"fleek-fitness","repo":"vox-mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeb4516a60f76c94453519e","collectionId":"f04aefd4-f849-4ae9-a389-b417a86e2c5a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb4516a60f76c94453519e"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6aec1641acbd2ab7a2e61263","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API 참조","count":163},{"language":"default","tag":"가이드","count":112},{"language":"default","tag":"구축","count":53},{"language":"default","tag":"변경 내역","count":40},{"language":"default","tag":"평가","count":22},{"language":"default","tag":"배포","count":20},{"language":"default","tag":"모니터링","count":17},{"language":"default","tag":"플로우 에이전트","count":15},{"language":"default","tag":"도구","count":15},{"language":"default","tag":"알림","count":15}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#content-area{max-width:896px}"}],"page":{"pagePath":"api-reference/v3/models/음성-모델-조회","slug":"/api-reference/v3/models/음성-모델-조회","pageMetadata":{"title":"음성 모델 조회","description":"보이스 1건을 조회합니다. `options`에는 이 보이스에 쓸 수 있는 `language`·`model` 조합이 모두 들어 있으며, 조합 하나가 `GET /v3/models/voices` 응답 항목 하나에 해당합니다. 다른 워크스페이스의 비공개 보이스나 워크스페이스에서 허용하지 않은 provider의 보이스처럼 이 워크스페이스에서 볼 수 없는 보이스는 존재하지 않는 보이스와 동일하게 `404`를 반환합니다.","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /models/voices/{voice_id}","href":"/api-reference/v3/models/음성-모델-조회","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"보이스 1건을 조회합니다. \", _jsx(_components.code, {\n children: \"options\"\n }), \"에는 이 보이스에 쓸 수 있는 \", _jsx(_components.code, {\n children: \"language\"\n }), \"·\", _jsx(_components.code, {\n children: \"model\"\n }), \" 조합이 모두 들어 있으며, 조합 하나가 \", _jsx(_components.code, {\n children: \"GET /v3/models/voices\"\n }), \" 응답 항목 하나에 해당합니다. 다른 워크스페이스의 비공개 보이스나 워크스페이스에서 허용하지 않은 provider의 보이스처럼 이 워크스페이스에서 볼 수 없는 보이스는 존재하지 않는 보이스와 동일하게 \", _jsx(_components.code, {\n children: \"404\"\n }), \"를 반환합니다.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"음성 모델 조회","description":"보이스 1건을 조회합니다. `options`에는 이 보이스에 쓸 수 있는 `language`·`model` 조합이 모두 들어 있으며, 조합 하나가 `GET /v3/models/voices` 응답 항목 하나에 해당합니다. 다른 워크스페이스의 비공개 보이스나 워크스페이스에서 허용하지 않은 provider의 보이스처럼 이 워크스페이스에서 볼 수 없는 보이스는 존재하지 않는 보이스와 동일하게 `404`를 반환합니다.","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /models/voices/{voice_id}","href":"/api-reference/v3/models/음성-모델-조회","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Models"],"summary":"음성 모델 조회","description":"보이스 1건을 조회합니다. `options`에는 이 보이스에 쓸 수 있는 `language`·`model` 조합이 모두 들어 있으며, 조합 하나가 `GET /v3/models/voices` 응답 항목 하나에 해당합니다. 다른 워크스페이스의 비공개 보이스나 워크스페이스에서 허용하지 않은 provider의 보이스처럼 이 워크스페이스에서 볼 수 없는 보이스는 존재하지 않는 보이스와 동일하게 `404`를 반환합니다.","operationId":"getVoiceModel","security":["c7e6ccbe-8173-4d77-9f44-e39bbba99c41"],"parameters":["5217ddd3-61be-4714-8ee0-b7ed89f6c9e6"],"responses":{"200":"ad9430e4-4009-439b-a2bd-ff81126769cc","400":"f61783a6-1a43-479c-bcce-60e82b80058b","401":"4c9b5842-d712-4800-a45d-074d02b077e5","403":"52e18c41-e0fa-4677-9837-7231cd2699c7","404":"b5c528c9-576d-4ff6-8219-1b25109c0d54","409":"c51c3314-c7c5-47da-bf26-c647cbe3e0a8","429":"257a0003-9205-4117-bc86-d93a1d6cbca5","500":"7f423049-592f-4b26-b31a-1a346b04c616","503":"a1f6d854-4202-4525-8a7c-814be488f254"},"x-error-codes":["CONFLICT","FORBIDDEN","INTERNAL_ERROR","INVALID_CURSOR","ORGANIZATION_ACCESS_DENIED","RATE_LIMIT_EXCEEDED","RESOURCE_NOT_FOUND","SERVICE_UNAVAILABLE","UNAUTHORIZED","VALIDATION_ERROR","VOICE_NOT_FOUND"],"method":"get","type":"path","servers":["9c70699b-2b40-4355-ac65-4a0d6639f86f"],"path":"/models/voices/{voice_id}","baseUrlOptions":["https://client-api.tryvox.co/v3"],"title":"음성 모델 조회","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5217ddd3-61be-4714-8ee0-b7ed89f6c9e6":{"name":"voice_id","in":"path","required":true,"schema":{"type":"string","description":"음성 식별자입니다. `GET /v3/models/voices` 응답 항목의 `id` 값을 사용합니다.","title":"Voice Id","isRequired":true,"uniqueKey":"","typeLabel":"string"},"description":"음성 식별자입니다. `GET /v3/models/voices` 응답 항목의 `id` 값을 사용합니다."}},"responses":{"ad9430e4-4009-439b-a2bd-ff81126769cc":{"description":"성공 응답","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","title":"Id","description":"공급사 내 음성 식별자. 에이전트 설정의 `data.voice.id`에 지정하는 값입니다.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"사람이 읽는 음성 이름.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"provider":{"type":"string","title":"Provider","description":"TTS 공급사.","isRequired":true,"uniqueKey":"provider","typeLabel":"string"},"is_public":{"type":"boolean","title":"Is Public","description":"공개 카탈로그 보이스 여부입니다.","isRequired":true,"uniqueKey":"is_public","typeLabel":"boolean"},"options":{"items":{"properties":{"language":{"type":"string","title":"Language","description":"BCP-47 locale code입니다. 이 조합을 고를 때 `agent.data.voice.language`에 이 값을 사용합니다.","isRequired":true,"uniqueKey":"options.items.[INDEX].language","typeLabel":"string"},"model":{"oneOf":[{"type":"string","title":"Model","description":"TTS 공급사 내 모델명입니다. 이 조합을 고를 때 `agent.data.voice.model`에 이 값을 사용합니다.","uniqueKey":"options.items.[INDEX].model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model","description":"TTS 공급사 내 모델명입니다. 이 조합을 고를 때 `agent.data.voice.model`에 이 값을 사용합니다.","uniqueKey":"options.items.[INDEX].model.oneOf.1","typeLabel":"null"}],"uniqueKey":"options.items.[INDEX].model","typeLabel":"string | null"},"capabilities":{"oneOf":[{"type":"object","title":"Capabilities","description":"지원되는 속도나 볼륨 범위 같은 voice parameter capability hint입니다.","additionalProperties":true,"uniqueKey":"options.items.[INDEX].capabilities.oneOf.0","typeLabel":"Capabilities · object"},{"type":"null","title":"Capabilities","description":"지원되는 속도나 볼륨 범위 같은 voice parameter capability hint입니다.","uniqueKey":"options.items.[INDEX].capabilities.oneOf.1","typeLabel":"null"}],"uniqueKey":"options.items.[INDEX].capabilities","typeLabel":"Capabilities · object | null"}},"type":"object","required":["language"],"title":"VoiceModelOption","description":"보이스 하나의 카탈로그 항목(`language`·`model` 조합 하나)입니다.","uniqueKey":"options.items.[INDEX]","typeLabel":"VoiceModelOption · object"},"type":"array","title":"Options","description":"이 보이스에서 고를 수 있는 `language`·`model` 조합 목록입니다. 조합 하나가 `GET /v3/models/voices` 응답 항목 하나에 해당합니다.","isRequired":true,"uniqueKey":"options","typeLabel":"VoiceModelOption · object[]"},"gender":{"oneOf":[{"type":"string","title":"Gender","description":"provider가 제공하는 경우 포함되는 음성 gender 메타데이터입니다.","enum":["male","female"],"uniqueKey":"gender.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Gender","description":"provider가 제공하는 경우 포함되는 음성 gender 메타데이터입니다.","uniqueKey":"gender.oneOf.1","typeLabel":"null"}],"uniqueKey":"gender","typeLabel":"enum\u003cstring> | null"},"description":{"oneOf":[{"type":"string","title":"Description","description":"사람이 읽을 수 있는 설명입니다.","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","description":"사람이 읽을 수 있는 설명입니다.","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"sample_url":{"oneOf":[{"type":"string","title":"Sample Url","description":"사용 가능한 경우 제공되는 sample audio clip URL입니다.","uniqueKey":"sample_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sample Url","description":"사용 가능한 경우 제공되는 sample audio clip URL입니다.","uniqueKey":"sample_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"sample_url","typeLabel":"string | null"}},"type":"object","required":["id","name","provider","is_public","options"],"title":"VoiceModelDetailResponse","description":"보이스 1건과 이 보이스에서 고를 수 있는 `language`·`model` 조합입니다.","uniqueKey":"","typeLabel":"VoiceModelDetailResponse · object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","name":"\u003cstring>","provider":"\u003cstring>","is_public":true,"options":[{"language":"\u003cstring>","model":"\u003cstring>","capabilities":{}}],"gender":"male","description":"\u003cstring>","sample_url":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"f61783a6-1a43-479c-bcce-60e82b80058b":{"description":"요청 검증 오류","content":{"application/json":{"schema":{"type":"object","required":["error"],"title":"ErrorResponse","description":"모든 실패 응답에서 사용하는 v3 error envelope입니다.","examples":[{"error":{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}}],"properties":{"error":{"type":"object","required":["code","message","details"],"title":"ErrorDetail","description":"오류 payload입니다.","examples":[{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}],"properties":{"code":{"type":"string","title":"Code","description":"기계가 읽을 수 있는 오류 code입니다. message parsing 대신 이 값을 사용합니다.","examples":["VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"사용자에게 표시할 수 있는 오류 메시지입니다. 프로그램 처리는 `code`를 사용합니다.","examples":["Request validation failed."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","title":"Details","additionalProperties":true,"description":"구조화된 context입니다. 주로 `field`, `reason`, `allowed_values`를 포함합니다.","isRequired":true,"uniqueKey":"error.details","typeLabel":"Details · object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"validationError":{"title":"validationError","value":{"error":{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"4c9b5842-d712-4800-a45d-074d02b077e5":{"description":"인증이 필요합니다.","content":{"application/json":{"schema":{"type":"object","required":["error"],"title":"ErrorResponse","description":"모든 실패 응답에서 사용하는 v3 error envelope입니다.","examples":[{"error":{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}}],"properties":{"error":{"type":"object","required":["code","message","details"],"title":"ErrorDetail","description":"오류 payload입니다.","examples":[{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}],"properties":{"code":{"type":"string","title":"Code","description":"기계가 읽을 수 있는 오류 code입니다. message parsing 대신 이 값을 사용합니다.","examples":["VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"사용자에게 표시할 수 있는 오류 메시지입니다. 프로그램 처리는 `code`를 사용합니다.","examples":["Request validation failed."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","title":"Details","additionalProperties":true,"description":"구조화된 context입니다. 주로 `field`, `reason`, `allowed_values`를 포함합니다.","isRequired":true,"uniqueKey":"error.details","typeLabel":"Details · object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"unauthorized":{"title":"unauthorized","value":{"error":{"code":"UNAUTHORIZED","message":"Authentication is required.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"52e18c41-e0fa-4677-9837-7231cd2699c7":{"description":"권한이 없습니다.","content":{"application/json":{"schema":{"type":"object","required":["error"],"title":"ErrorResponse","description":"모든 실패 응답에서 사용하는 v3 error envelope입니다.","examples":[{"error":{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}}],"properties":{"error":{"type":"object","required":["code","message","details"],"title":"ErrorDetail","description":"오류 payload입니다.","examples":[{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}],"properties":{"code":{"type":"string","title":"Code","description":"기계가 읽을 수 있는 오류 code입니다. message parsing 대신 이 값을 사용합니다.","examples":["VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"사용자에게 표시할 수 있는 오류 메시지입니다. 프로그램 처리는 `code`를 사용합니다.","examples":["Request validation failed."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","title":"Details","additionalProperties":true,"description":"구조화된 context입니다. 주로 `field`, `reason`, `allowed_values`를 포함합니다.","isRequired":true,"uniqueKey":"error.details","typeLabel":"Details · object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"forbidden":{"title":"forbidden","value":{"error":{"code":"FORBIDDEN","message":"Permission denied.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"b5c528c9-576d-4ff6-8219-1b25109c0d54":{"description":"리소스를 찾을 수 없습니다.","content":{"application/json":{"schema":{"type":"object","required":["error"],"title":"ErrorResponse","description":"모든 실패 응답에서 사용하는 v3 error envelope입니다.","examples":[{"error":{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}}],"properties":{"error":{"type":"object","required":["code","message","details"],"title":"ErrorDetail","description":"오류 payload입니다.","examples":[{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}],"properties":{"code":{"type":"string","title":"Code","description":"기계가 읽을 수 있는 오류 code입니다. message parsing 대신 이 값을 사용합니다.","examples":["VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"사용자에게 표시할 수 있는 오류 메시지입니다. 프로그램 처리는 `code`를 사용합니다.","examples":["Request validation failed."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","title":"Details","additionalProperties":true,"description":"구조화된 context입니다. 주로 `field`, `reason`, `allowed_values`를 포함합니다.","isRequired":true,"uniqueKey":"error.details","typeLabel":"Details · object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"notFound":{"title":"notFound","value":{"error":{"code":"VOICE_NOT_FOUND","message":"Voice 모델을 찾을 수 없습니다.","details":{"voice_id":"a0e99841-438c-4a64-b679-ae501e7d6091"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"c51c3314-c7c5-47da-bf26-c647cbe3e0a8":{"description":"충돌이 발생했습니다.","content":{"application/json":{"schema":{"type":"object","required":["error"],"title":"ErrorResponse","description":"모든 실패 응답에서 사용하는 v3 error envelope입니다.","examples":[{"error":{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}}],"properties":{"error":{"type":"object","required":["code","message","details"],"title":"ErrorDetail","description":"오류 payload입니다.","examples":[{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}],"properties":{"code":{"type":"string","title":"Code","description":"기계가 읽을 수 있는 오류 code입니다. message parsing 대신 이 값을 사용합니다.","examples":["VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"사용자에게 표시할 수 있는 오류 메시지입니다. 프로그램 처리는 `code`를 사용합니다.","examples":["Request validation failed."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","title":"Details","additionalProperties":true,"description":"구조화된 context입니다. 주로 `field`, `reason`, `allowed_values`를 포함합니다.","isRequired":true,"uniqueKey":"error.details","typeLabel":"Details · object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"conflict":{"title":"conflict","value":{"error":{"code":"CONFLICT","message":"The requested operation conflicts with current state.","details":{"current_status":"draft"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"257a0003-9205-4117-bc86-d93a1d6cbca5":{"description":"요청 한도를 초과했습니다. API 키 트래픽은 기본값으로 워크스페이스당 초당 5회·분당 120회, Supabase JWT 트래픽은 기본값으로 사용자당 초당 10회·분당 240회로 제한되며, 워크스페이스 대시보드에는 기본 분당 2,400회의 백스톱 한도가 적용됩니다. 한도는 운영자가 조정할 수 있고, 초과한 버킷의 실제 한도와 윈도우는 429 응답의 X-RateLimit-Limit·X-RateLimit-Window 헤더로 알려 줍니다. 개별 경로 자체 리미터가 만든 429 응답에는 이 헤더가 없을 수 있습니다.","headers":{"Retry-After":{"description":"초과한 공용 v3 인증 주체(auth-principal) 리미터 윈도우가 초기화될 때까지 남은 시간입니다. 단위는 초입니다. 개별 경로 자체 리미터가 만든 429 응답에는 이 헤더가 없을 수 있습니다.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Limit":{"description":"초과한 공용 v3 인증 주체(auth-principal) 리미터 윈도우의 최대 요청 수입니다. 개별 경로 자체 리미터가 만든 429 응답에는 이 헤더가 없을 수 있습니다.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Window":{"description":"초과한 공용 v3 인증 주체(auth-principal) 리미터 윈도우의 길이입니다. 단위는 초입니다. 개별 경로 자체 리미터가 만든 429 응답에는 이 헤더가 없을 수 있습니다.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"title":"ErrorResponse","description":"모든 실패 응답에서 사용하는 v3 error envelope입니다.","examples":[{"error":{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}}],"properties":{"error":{"type":"object","required":["code","message","details"],"title":"ErrorDetail","description":"오류 payload입니다.","examples":[{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}],"properties":{"code":{"type":"string","title":"Code","description":"기계가 읽을 수 있는 오류 code입니다. message parsing 대신 이 값을 사용합니다.","examples":["VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"사용자에게 표시할 수 있는 오류 메시지입니다. 프로그램 처리는 `code`를 사용합니다.","examples":["Request validation failed."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","title":"Details","additionalProperties":true,"description":"구조화된 context입니다. 주로 `field`, `reason`, `allowed_values`를 포함합니다.","isRequired":true,"uniqueKey":"error.details","typeLabel":"Details · object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"rateLimited":{"title":"rateLimited","value":{"error":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests.","details":{"limit":10,"window_seconds":1,"scope":"user"}}}}},"exampleType":"examples"}},"exampleType":"examples"},"7f423049-592f-4b26-b31a-1a346b04c616":{"description":"서버 내부 오류가 발생했습니다.","content":{"application/json":{"schema":{"type":"object","required":["error"],"title":"ErrorResponse","description":"모든 실패 응답에서 사용하는 v3 error envelope입니다.","examples":[{"error":{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}}],"properties":{"error":{"type":"object","required":["code","message","details"],"title":"ErrorDetail","description":"오류 payload입니다.","examples":[{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}],"properties":{"code":{"type":"string","title":"Code","description":"기계가 읽을 수 있는 오류 code입니다. message parsing 대신 이 값을 사용합니다.","examples":["VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"사용자에게 표시할 수 있는 오류 메시지입니다. 프로그램 처리는 `code`를 사용합니다.","examples":["Request validation failed."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","title":"Details","additionalProperties":true,"description":"구조화된 context입니다. 주로 `field`, `reason`, `allowed_values`를 포함합니다.","isRequired":true,"uniqueKey":"error.details","typeLabel":"Details · object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"internalError":{"title":"internalError","value":{"error":{"code":"INTERNAL_ERROR","message":"Internal server error.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"a1f6d854-4202-4525-8a7c-814be488f254":{"description":"서비스를 일시적으로 사용할 수 없습니다.","content":{"application/json":{"schema":{"type":"object","required":["error"],"title":"ErrorResponse","description":"모든 실패 응답에서 사용하는 v3 error envelope입니다.","examples":[{"error":{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}}],"properties":{"error":{"type":"object","required":["code","message","details"],"title":"ErrorDetail","description":"오류 payload입니다.","examples":[{"code":"VALIDATION_ERROR","message":"Request validation failed.","details":{"field":"name","reason":"must not be blank"}}],"properties":{"code":{"type":"string","title":"Code","description":"기계가 읽을 수 있는 오류 code입니다. message parsing 대신 이 값을 사용합니다.","examples":["VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"사용자에게 표시할 수 있는 오류 메시지입니다. 프로그램 처리는 `code`를 사용합니다.","examples":["Request validation failed."],"isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","title":"Details","additionalProperties":true,"description":"구조화된 context입니다. 주로 `field`, `reason`, `allowed_values`를 포함합니다.","isRequired":true,"uniqueKey":"error.details","typeLabel":"Details · object"}},"isRequired":true,"uniqueKey":"error","typeLabel":"ErrorDetail · object"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"serviceUnavailable":{"title":"serviceUnavailable","value":{"error":{"code":"SERVICE_UNAVAILABLE","message":"Service temporarily unavailable.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c7e6ccbe-8173-4d77-9f44-e39bbba99c41":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Organization API key","description":"워크스페이스 API 키를 `Authorization: Bearer \u003ctoken>` 형식으로 보냅니다.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"9c70699b-2b40-4355-ac65-4a0d6639f86f":{"url":"https://client-api.tryvox.co/v3","description":"운영"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"Organization API key","description":"워크스페이스 API 키를 `Authorization: Bearer \u003ctoken>` 형식으로 보냅니다.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"워크스페이스 API 키를 `Authorization: Bearer \u003ctoken>` 형식으로 보냅니다.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/v3/openapi.json"},"subdomain":"fleek","siteName":"vox.ai 문서","title":"음성 모델 조회 - vox.ai 문서","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T05:38:30.254Z","originalFileLocation":"api-reference/v3/models/음성-모델-조회.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"보이스 1건을 조회합니다. options에는 이 보이스에 쓸 수 있는 language·model 조합이 모두 들어 있으며, 조합 하나가 GET /v3/models/voices 응답 항목 하나에 해당합니다. 다른 워크스페이스의 비공개 보이스나 워크스페이스에서 허용하지 않은 provider의 보이스처럼 이 워크스페이스에서 볼 수 없는 보이스는 존재하지 않는 보이스와 동일하게 404를 반환합니다.\">\u003cmeta data-mint-head name=\"keywords\" content=\"AICC, AI 음성 에이전트, SDK, 음성 AI\">\u003cmeta data-mint-head name=\"application-name\" content=\"vox.ai 문서\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fleek/XpEwBvGNmdT3TMnG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/fleek/XpEwBvGNmdT3TMnG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fleek/XpEwBvGNmdT3TMnG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fleek/XpEwBvGNmdT3TMnG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fleek/XpEwBvGNmdT3TMnG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fleek/XpEwBvGNmdT3TMnG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fleek/XpEwBvGNmdT3TMnG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fleek/XpEwBvGNmdT3TMnG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fleek/XpEwBvGNmdT3TMnG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"음성 모델 조회 - vox.ai 문서\">\u003cmeta data-mint-head property=\"og:description\" content=\"보이스 1건을 조회합니다. options에는 이 보이스에 쓸 수 있는 language·model 조합이 모두 들어 있으며, 조합 하나가 GET /v3/models/voices 응답 항목 하나에 해당합니다. 다른 워크스페이스의 비공개 보이스나 워크스페이스에서 허용하지 않은 provider의 보이스처럼 이 워크스페이스에서 볼 수 없는 보이스는 존재하지 않는 보이스와 동일하게 404를 반환합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"vox.ai 문서\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tryvox.co/api-reference/v3/models/음성-모델-조회\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fleek.mintlify.app/_mintlify/api/og/v2?division=%EB%AA%A8%EB%8D%B8\u0026amp;title=%EC%9D%8C%EC%84%B1+%EB%AA%A8%EB%8D%B8+%EC%A1%B0%ED%9A%8C\u0026amp;description=%EB%B3%B4%EC%9D%B4%EC%8A%A4+1%EA%B1%B4%EC%9D%84+%EC%A1%B0%ED%9A%8C%ED%95%A9%EB%8B%88%EB%8B%A4.+%60options%60%EC%97%90%EB%8A%94+%EC%9D%B4+%EB%B3%B4%EC%9D%B4%EC%8A%A4%EC%97%90+%EC%93%B8+%EC%88%98+%EC%9E%88%EB%8A%94+%60language%60%C2%B7%60model%60+%EC%A1%B0%ED%95%A9%EC%9D%B4+%EB%AA%A8%EB%91%90+%EB%93%A4%EC%96%B4+%EC%9E%88%EC%9C%BC%EB%A9%B0%2C+%EC%A1%B0%ED%95%A9+%ED%95%98%EB%82%98%EA%B0%80+%60GET+%2Fv3%2Fmodels%2Fvoices%60+%EC%9D%91%EB%8B%B5+%ED%95%AD%EB%AA%A9+%ED%95%98%EB%82%98%EC%97%90+%ED%95%B4%EB%8B%B9%ED%95%A9%EB%8B%88%EB%8B%A4.+%EB%8B%A4%EB%A5%B8+%EC%9B%8C%ED%81%AC%EC%8A%A4%ED%8E%98%EC%9D%B4%EC%8A%A4%EC%9D%98+%EB%B9%84%EA%B3%B5%EA%B0%9C+%EB%B3%B4%EC%9D%B4%EC%8A%A4%EB%82%98+%EC%9B%8C%ED%81%AC%EC%8A%A4%ED%8E%98%EC%9D%B4%EC%8A%A4%EC%97%90%EC%84%9C+%ED%97%88%EC%9A%A9%ED%95%98%EC%A7%80+%EC%95%8A%EC%9D%80+\u0026amp;theme=f046f2cf51eedf974162c63d\u0026amp;signature=a9e32b7a28ea40bbb341b5f92db097f2fe633ebc340437aefe65c7ff363b3c05\">\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=\"음성 모델 조회 - vox.ai 문서\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"보이스 1건을 조회합니다. options에는 이 보이스에 쓸 수 있는 language·model 조합이 모두 들어 있으며, 조합 하나가 GET /v3/models/voices 응답 항목 하나에 해당합니다. 다른 워크스페이스의 비공개 보이스나 워크스페이스에서 허용하지 않은 provider의 보이스처럼 이 워크스페이스에서 볼 수 없는 보이스는 존재하지 않는 보이스와 동일하게 404를 반환합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fleek.mintlify.app/_mintlify/api/og/v2?division=%EB%AA%A8%EB%8D%B8\u0026amp;title=%EC%9D%8C%EC%84%B1+%EB%AA%A8%EB%8D%B8+%EC%A1%B0%ED%9A%8C\u0026amp;description=%EB%B3%B4%EC%9D%B4%EC%8A%A4+1%EA%B1%B4%EC%9D%84+%EC%A1%B0%ED%9A%8C%ED%95%A9%EB%8B%88%EB%8B%A4.+%60options%60%EC%97%90%EB%8A%94+%EC%9D%B4+%EB%B3%B4%EC%9D%B4%EC%8A%A4%EC%97%90+%EC%93%B8+%EC%88%98+%EC%9E%88%EB%8A%94+%60language%60%C2%B7%60model%60+%EC%A1%B0%ED%95%A9%EC%9D%B4+%EB%AA%A8%EB%91%90+%EB%93%A4%EC%96%B4+%EC%9E%88%EC%9C%BC%EB%A9%B0%2C+%EC%A1%B0%ED%95%A9+%ED%95%98%EB%82%98%EA%B0%80+%60GET+%2Fv3%2Fmodels%2Fvoices%60+%EC%9D%91%EB%8B%B5+%ED%95%AD%EB%AA%A9+%ED%95%98%EB%82%98%EC%97%90+%ED%95%B4%EB%8B%B9%ED%95%A9%EB%8B%88%EB%8B%A4.+%EB%8B%A4%EB%A5%B8+%EC%9B%8C%ED%81%AC%EC%8A%A4%ED%8E%98%EC%9D%B4%EC%8A%A4%EC%9D%98+%EB%B9%84%EA%B3%B5%EA%B0%9C+%EB%B3%B4%EC%9D%B4%EC%8A%A4%EB%82%98+%EC%9B%8C%ED%81%AC%EC%8A%A4%ED%8E%98%EC%9D%B4%EC%8A%A4%EC%97%90%EC%84%9C+%ED%97%88%EC%9A%A9%ED%95%98%EC%A7%80+%EC%95%8A%EC%9D%80+\u0026amp;theme=f046f2cf51eedf974162c63d\u0026amp;signature=a9e32b7a28ea40bbb341b5f92db097f2fe633ebc340437aefe65c7ff363b3c05\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/fleek/XpEwBvGNmdT3TMnG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"vox.ai 문서\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7c3aed\">\u003cmeta data-mint-head name=\"language\" content=\"ko\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tryvox.co/api-reference/v3/models/음성-모델-조회\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v3/models/%EC%9D%8C%EC%84%B1-%EB%AA%A8%EB%8D%B8-%EC%A1%B0%ED%9A%8C.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tryvox.co/#organization\",\"name\":\"vox.ai 문서\",\"url\":\"https://docs.tryvox.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fleek/QLXPdp5do4SgNyXm/logo/light.svg?fit=max\u0026auto=format\u0026n=QLXPdp5do4SgNyXm\u0026q=85\u0026s=ca85e066068138abac22f638eed5dad0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tryvox.co#website\",\"name\":\"vox.ai 문서\",\"url\":\"https://docs.tryvox.co\",\"publisher\":{\"@id\":\"https://docs.tryvox.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tryvox.co/api-reference/v3/models/%EC%9D%8C%EC%84%B1-%EB%AA%A8%EB%8D%B8-%EC%A1%B0%ED%9A%8C#webpage\",\"url\":\"https://docs.tryvox.co/api-reference/v3/models/%EC%9D%8C%EC%84%B1-%EB%AA%A8%EB%8D%B8-%EC%A1%B0%ED%9A%8C\",\"name\":\"음성 모델 조회\",\"description\":\"보이스 1건을 조회합니다. options에는 이 보이스에 쓸 수 있는 language·model 조합이 모두 들어 있으며, 조합 하나가 GET /v3/models/voices 응답 항목 하나에 해당합니다. 다른 워크스페이스의 비공개 보이스나 워크스페이스에서 허용하지 않은 provider의 보이스처럼 이 워크스페이스에서 볼 수 없는 보이스는 존재하지 않는 보이스와 동일하게 404를 반환합니다.\",\"dateModified\":\"2026-11-05T05:38:30.254Z\",\"isPartOf\":{\"@id\":\"https://docs.tryvox.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tryvox.co/api-reference/v3/models/%EC%9D%8C%EC%84%B1-%EB%AA%A8%EB%8D%B8-%EC%A1%B0%ED%9A%8C#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tryvox.co/api-reference/v3/models/%EC%9D%8C%EC%84%B1-%EB%AA%A8%EB%8D%B8-%EC%A1%B0%ED%9A%8C#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"모델\",\"item\":\"https://docs.tryvox.co/api-reference/v3/models/llm-%EB%AA%A8%EB%8D%B8-%EB%AA%A9%EB%A1%9D-%EC%A1%B0%ED%9A%8C\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"음성 모델 조회\",\"item\":\"https://docs.tryvox.co/api-reference/v3/models/%EC%9D%8C%EC%84%B1-%EB%AA%A8%EB%8D%B8-%EC%A1%B0%ED%9A%8C\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tryvox.co/api-reference/v3/models/%EC%9D%8C%EC%84%B1-%EB%AA%A8%EB%8D%B8-%EC%A1%B0%ED%9A%8C#apireference\",\"headline\":\"음성 모델 조회\",\"name\":\"음성 모델 조회\",\"description\":\"보이스 1건을 조회합니다. options에는 이 보이스에 쓸 수 있는 language·model 조합이 모두 들어 있으며, 조합 하나가 GET /v3/models/voices 응답 항목 하나에 해당합니다. 다른 워크스페이스의 비공개 보이스나 워크스페이스에서 허용하지 않은 provider의 보이스처럼 이 워크스페이스에서 볼 수 없는 보이스는 존재하지 않는 보이스와 동일하게 404를 반환합니다.\",\"url\":\"https://docs.tryvox.co/api-reference/v3/models/%EC%9D%8C%EC%84%B1-%EB%AA%A8%EB%8D%B8-%EC%A1%B0%ED%9A%8C\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tryvox.co/api-reference/v3/models/%EC%9D%8C%EC%84%B1-%EB%AA%A8%EB%8D%B8-%EC%A1%B0%ED%9A%8C#webpage\"},\"dateModified\":\"2026-11-05T05:38:30.254Z\",\"publisher\":{\"@id\":\"https://docs.tryvox.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tryvox.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"vox.ai 문서\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"vox.ai 문서","nav":{"global":null,"tabs":[{"tab":"가이드","icon":"book-open","pages":[{"title":"가이드","href":"/docs/start/overview"}]},{"tab":"AI","icon":"microchip-ai","pages":[{"title":"AI","href":"/docs/ai/overview"}]},{"tab":"SDK","icon":"code","pages":[{"title":"SDK","href":"/docs/sdk/javascript"}]},{"tab":"API 참조","icon":"brackets-curly","pages":[{"title":"소개","href":"/api-reference/v3/introduction"},{"group":"통화","pages":[{"title":"통화 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /calls","href":"/api-reference/v3/calls/통화-생성"},{"title":"통화 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /calls","href":"/api-reference/v3/calls/통화-목록-조회"},{"title":"통화 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /calls/{call_id}","href":"/api-reference/v3/calls/통화-조회"},{"title":"진행 중 통화 전환 요청","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /calls/{call_id}/transfer","href":"/api-reference/v3/calls/진행-중-통화-전환-요청"},{"title":"진행 중 통화에 맥락 주입","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /calls/{call_id}/context","href":"/api-reference/v3/calls/진행-중-통화에-맥락-주입"}]},{"group":"상담사 통화","pages":[{"title":"상담사 통화 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /operator-calls","href":"/api-reference/v3/operator-calls/상담사-통화-목록-조회"},{"title":"상담사 통화 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /operator-calls/{operator_call_id}","href":"/api-reference/v3/operator-calls/상담사-통화-조회"}]},{"group":"에이전트","pages":[{"title":"에이전트 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /agents","href":"/api-reference/v3/agents/에이전트-생성"},{"title":"에이전트 목록","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /agents","href":"/api-reference/v3/agents/에이전트-목록"},{"title":"에이전트 단건 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /agents/{agent_id}","href":"/api-reference/v3/agents/에이전트-단건-조회"},{"title":"에이전트 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /agents/{agent_id}","href":"/api-reference/v3/agents/에이전트-수정"},{"title":"에이전트 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /agents/{agent_id}","href":"/api-reference/v3/agents/에이전트-삭제"},{"title":"플로우 검증","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /agents/validate-flow","href":"/api-reference/v3/agents/플로우-검증"}]},{"group":"에이전트 버전","pages":[{"title":"에이전트 버전 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /agents/{agent_id}/versions","href":"/api-reference/v3/agentversions/에이전트-버전-생성"},{"title":"에이전트 버전 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /agents/{agent_id}/versions","href":"/api-reference/v3/agentversions/에이전트-버전-목록-조회"},{"title":"에이전트 버전 프로덕션 게시","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /agents/{agent_id}/versions/{version}/publish","href":"/api-reference/v3/agentversions/에이전트-버전-프로덕션-게시"}]},{"group":"도구","pages":[{"title":"도구 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /tools","href":"/api-reference/v3/tools/도구-생성"},{"title":"도구 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /tools","href":"/api-reference/v3/tools/도구-목록-조회"},{"title":"도구 상세 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /tools/{tool_id}","href":"/api-reference/v3/tools/도구-상세-조회"},{"title":"도구 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /tools/{tool_id}","href":"/api-reference/v3/tools/도구-수정"},{"title":"도구 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /tools/{tool_id}","href":"/api-reference/v3/tools/도구-삭제"}]},{"group":"지식 베이스","pages":[{"title":"지식 베이스 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /knowledges","href":"/api-reference/v3/knowledges/지식-베이스-생성"},{"title":"지식 베이스 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /knowledges","href":"/api-reference/v3/knowledges/지식-베이스-목록-조회"},{"title":"지식 베이스 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /knowledges/{knowledge_id}","href":"/api-reference/v3/knowledges/지식-베이스-삭제"},{"title":"지식 베이스 문서 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /knowledges/{knowledge_id}/documents","href":"/api-reference/v3/knowledge-documents/지식-베이스-문서-생성"},{"title":"지식 베이스 문서 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /knowledges/{knowledge_id}/documents","href":"/api-reference/v3/knowledge-documents/지식-베이스-문서-목록-조회"},{"title":"지식 베이스 문서 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /knowledges/{knowledge_id}/documents/{document_id}","href":"/api-reference/v3/knowledge-documents/지식-베이스-문서-조회"},{"title":"지식 베이스 문서 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /knowledges/{knowledge_id}/documents/{document_id}","href":"/api-reference/v3/knowledge-documents/지식-베이스-문서-삭제"}]},{"group":"메뉴얼","pages":[{"title":"에이전트 메뉴얼 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /agents/{agent_id}/manuals","href":"/api-reference/v3/agentmanuals/에이전트-메뉴얼-생성"},{"title":"에이전트 메뉴얼 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /agents/{agent_id}/manuals","href":"/api-reference/v3/agentmanuals/에이전트-메뉴얼-목록-조회"},{"title":"에이전트 메뉴얼 단건 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /agents/{agent_id}/manuals/{manual_id}","href":"/api-reference/v3/agentmanuals/에이전트-메뉴얼-단건-조회"},{"title":"에이전트 메뉴얼 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /agents/{agent_id}/manuals/{manual_id}","href":"/api-reference/v3/agentmanuals/에이전트-메뉴얼-수정"},{"title":"에이전트 메뉴얼 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /agents/{agent_id}/manuals/{manual_id}","href":"/api-reference/v3/agentmanuals/에이전트-메뉴얼-삭제"}]},{"group":"평가","pages":[{"group":"유닛 테스트","pages":[{"title":"유닛 테스트 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /evals/unit","href":"/api-reference/v3/evals/유닛-테스트-생성"},{"title":"유닛 테스트 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/unit","href":"/api-reference/v3/evals/유닛-테스트-목록-조회"},{"title":"유닛 테스트 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/unit/{test_id}","href":"/api-reference/v3/evals/유닛-테스트-조회"},{"title":"유닛 테스트 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /evals/unit/{test_id}","href":"/api-reference/v3/evals/유닛-테스트-수정"},{"title":"유닛 테스트 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /evals/unit/{test_id}","href":"/api-reference/v3/evals/유닛-테스트-삭제"},{"title":"유닛 테스트 실행","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /evals/unit/batches","href":"/api-reference/v3/evals/유닛-테스트-실행"},{"title":"유닛 테스트 배치 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/unit/batches","href":"/api-reference/v3/evals/유닛-테스트-배치-목록-조회"},{"title":"유닛 테스트 배치 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/unit/batches/{batch_id}","href":"/api-reference/v3/evals/유닛-테스트-배치-조회"},{"title":"유닛 테스트 실행 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/unit/runs","href":"/api-reference/v3/evals/유닛-테스트-실행-목록-조회"},{"title":"유닛 테스트 실행 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/unit/runs/{run_id}","href":"/api-reference/v3/evals/유닛-테스트-실행-조회"}]},{"group":"시나리오 테스트","pages":[{"title":"시나리오 테스트 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /evals/scenario","href":"/api-reference/v3/evals/시나리오-테스트-생성"},{"title":"시나리오 테스트 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/scenario","href":"/api-reference/v3/evals/시나리오-테스트-목록-조회"},{"title":"시나리오 테스트 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/scenario/{test_id}","href":"/api-reference/v3/evals/시나리오-테스트-조회"},{"title":"시나리오 테스트 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /evals/scenario/{test_id}","href":"/api-reference/v3/evals/시나리오-테스트-수정"},{"title":"시나리오 테스트 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /evals/scenario/{test_id}","href":"/api-reference/v3/evals/시나리오-테스트-삭제"},{"title":"시나리오 테스트 실행","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /evals/scenario/batches","href":"/api-reference/v3/evals/시나리오-테스트-실행"},{"title":"시나리오 테스트 배치 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/scenario/batches","href":"/api-reference/v3/evals/시나리오-테스트-배치-목록-조회"},{"title":"시나리오 테스트 배치 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/scenario/batches/{batch_id}","href":"/api-reference/v3/evals/시나리오-테스트-배치-조회"},{"title":"시나리오 테스트 실행 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/scenario/runs","href":"/api-reference/v3/evals/시나리오-테스트-실행-목록-조회"},{"title":"시나리오 테스트 실행 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /evals/scenario/runs/{run_id}","href":"/api-reference/v3/evals/시나리오-테스트-실행-조회"}]}]},{"group":"모델","pages":[{"title":"LLM 모델 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /models/llms","href":"/api-reference/v3/models/llm-모델-목록-조회"},{"title":"음성 모델 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /models/voices","href":"/api-reference/v3/models/음성-모델-생성"},{"title":"음성 모델 목록 조회","description":"`agent.data.voice`에 사용할 수 있는 음성 모델 목록을 조회합니다. 워크스페이스(`organization_id`) 전용 보이스도 포함합니다. 다음 페이지는 `next_cursor`를 `cursor`로 다시 전달해 조회합니다.","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /models/voices","href":"/api-reference/v3/models/음성-모델-목록-조회"},{"title":"음성 모델 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /models/voices/{voice_id}","href":"/api-reference/v3/models/음성-모델-조회"},{"title":"음성 모델 삭제","description":"워크스페이스(`organization_id`) 전용으로 생성한 보이스 클론을 삭제합니다. 공개 카탈로그 보이스는 삭제할 수 없으며 `403`을 반환합니다. 다른 워크스페이스의 보이스와 존재하지 않는 보이스는 동일하게 `404`를 반환합니다.","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /models/voices/{voice_id}","href":"/api-reference/v3/models/음성-모델-삭제"}]},{"group":"스키마","pages":[{"title":"스키마 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /schemas","href":"/api-reference/v3/schemas/스키마-목록-조회"},{"title":"스키마 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /schemas/{namespace}/{schema_type}","href":"/api-reference/v3/schemas/스키마-조회"}]},{"group":"보유 전화번호","pages":[{"title":"보유 전화번호 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /organization-telephone-numbers","href":"/api-reference/v3/organization-telephone-numbers/보유-전화번호-목록-조회"},{"title":"보유 전화번호 상세 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /organization-telephone-numbers/{organization_telephone_number_id}","href":"/api-reference/v3/organization-telephone-numbers/보유-전화번호-상세-조회"},{"title":"보유 전화번호 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /organization-telephone-numbers/{organization_telephone_number_id}","href":"/api-reference/v3/organization-telephone-numbers/보유-전화번호-수정"},{"title":"보유 전화번호 에이전트 설정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /organization-telephone-numbers/{organization_telephone_number_id}/agent","href":"/api-reference/v3/organization-telephone-numbers/보유-전화번호-에이전트-설정"},{"title":"보유 전화번호 SIP 설정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /organization-telephone-numbers/{organization_telephone_number_id}/sip","href":"/api-reference/v3/organization-telephone-numbers/보유-전화번호-sip-설정"},{"title":"보유 전화번호 해지","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /organization-telephone-numbers/{organization_telephone_number_id}","href":"/api-reference/v3/organization-telephone-numbers/보유-전화번호-해지"},{"title":"보유 전화번호 해지 취소","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /organization-telephone-numbers/{organization_telephone_number_id}/revoke-cancel","href":"/api-reference/v3/organization-telephone-numbers/보유-전화번호-해지-취소"},{"title":"보유 전화번호 통신서비스 이용증명원 발급 요청","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /organization-telephone-numbers/{organization_telephone_number_id}/certificate","href":"/api-reference/v3/organization-telephone-numbers/보유-전화번호-통신서비스-이용증명원-발급-요청"}]},{"group":"전화번호 자원","pages":[{"title":"전화번호 자원 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /telephone-numbers/available","href":"/api-reference/v3/telephone-numbers/전화번호-자원-목록-조회"},{"title":"전화번호 구매","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /telephone-numbers/purchase","href":"/api-reference/v3/telephone-numbers/전화번호-구매"},{"title":"SIP 연동","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /telephone-numbers/register","href":"/api-reference/v3/telephone-numbers/sip-연동"}]},{"group":"발신표기번호","pages":[{"title":"발신표기번호 등록 신청","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /telephone-presentation-numbers","href":"/api-reference/v3/telephone-presentation-numbers/발신표기번호-등록-신청"},{"title":"발신표기번호 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /telephone-presentation-numbers","href":"/api-reference/v3/telephone-presentation-numbers/발신표기번호-목록-조회"},{"title":"발신표기번호 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /telephone-presentation-numbers/{telephone_presentation_number_id}","href":"/api-reference/v3/telephone-presentation-numbers/발신표기번호-삭제"}]},{"group":"차단 번호","pages":[{"title":"차단 번호 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /blocked-numbers","href":"/api-reference/v3/blocked-numbers/차단-번호-생성"},{"title":"차단 번호 일괄 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /blocked-numbers/bulk","href":"/api-reference/v3/blocked-numbers/차단-번호-일괄-생성"},{"title":"차단 번호 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /blocked-numbers","href":"/api-reference/v3/blocked-numbers/차단-번호-목록-조회"},{"title":"차단 번호 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /blocked-numbers/{blocked_number_id}","href":"/api-reference/v3/blocked-numbers/차단-번호-수정"},{"title":"차단 번호 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /blocked-numbers/{blocked_number_id}","href":"/api-reference/v3/blocked-numbers/차단-번호-삭제"}]},{"group":"대량 발신","pages":[{"title":"대량 발신 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /campaigns","href":"/api-reference/v3/campaigns/대량-발신-생성"},{"title":"대량 발신 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /campaigns","href":"/api-reference/v3/campaigns/대량-발신-목록-조회"},{"title":"대량 발신 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /campaigns/{campaign_id}","href":"/api-reference/v3/campaigns/대량-발신-조회"},{"title":"대량 발신 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /campaigns/{campaign_id}","href":"/api-reference/v3/campaigns/대량-발신-수정"},{"title":"대량 발신 일시정지","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /campaigns/{campaign_id}/pause","href":"/api-reference/v3/campaigns/대량-발신-일시정지"},{"title":"대량 발신 재개","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /campaigns/{campaign_id}/resume","href":"/api-reference/v3/campaigns/대량-발신-재개"},{"title":"대량 발신 취소","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /campaigns/{campaign_id}/cancel","href":"/api-reference/v3/campaigns/대량-발신-취소"}]},{"group":"시트","pages":[{"title":"시트 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /sheets","href":"/api-reference/v3/sheets/시트-생성"},{"title":"시트 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /sheets","href":"/api-reference/v3/sheets/시트-목록-조회"},{"title":"시트 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /sheets/{sheet_id}","href":"/api-reference/v3/sheets/시트-조회"}]},{"group":"위젯","pages":[{"title":"위젯 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /widgets","href":"/api-reference/v3/widgets/위젯-생성"},{"title":"위젯 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /widgets","href":"/api-reference/v3/widgets/위젯-목록-조회"},{"title":"위젯 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /widgets/{widget_id}","href":"/api-reference/v3/widgets/위젯-조회"},{"title":"위젯 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /widgets/{widget_id}","href":"/api-reference/v3/widgets/위젯-수정"},{"title":"위젯 게시","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /widgets/{widget_id}/publish","href":"/api-reference/v3/widgets/위젯-게시"},{"title":"위젯 게시 해제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /widgets/{widget_id}/unpublish","href":"/api-reference/v3/widgets/위젯-게시-해제"},{"title":"위젯 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /widgets/{widget_id}","href":"/api-reference/v3/widgets/위젯-삭제"}]},{"group":"문자","pages":[{"title":"문자 발신","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /sms","href":"/api-reference/v3/sms/문자-발신"},{"title":"발신 문자 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /sms","href":"/api-reference/v3/sms/발신-문자-목록-조회"},{"title":"발신 문자 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /sms/{sms_id}","href":"/api-reference/v3/sms/발신-문자-조회"},{"title":"수신 문자 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /sms/received","href":"/api-reference/v3/sms/수신-문자-목록-조회"}]},{"group":"대량 문자 발신","pages":[{"title":"대량 문자 발신 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /sms-batches","href":"/api-reference/v3/sms/대량-문자-발신-생성"},{"title":"대량 문자 발신 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /sms-batches","href":"/api-reference/v3/sms/대량-문자-발신-목록-조회"},{"title":"대량 문자 발신 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /sms-batches/{batch_id}","href":"/api-reference/v3/sms/대량-문자-발신-조회"},{"title":"대량 문자 발신 일시정지","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /sms-batches/{batch_id}/pause","href":"/api-reference/v3/sms/대량-문자-발신-일시정지"},{"title":"대량 문자 발신 재개","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /sms-batches/{batch_id}/resume","href":"/api-reference/v3/sms/대량-문자-발신-재개"},{"title":"대량 문자 발신 취소","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /sms-batches/{batch_id}/cancel","href":"/api-reference/v3/sms/대량-문자-발신-취소"}]},{"group":"파일","pages":[{"title":"파일 업로드","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /files","href":"/api-reference/v3/files/파일-업로드"},{"title":"파일 다운로드","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /files/{file_key}/content","href":"/api-reference/v3/files/파일-다운로드"}]},{"group":"고객","pages":[{"title":"고객 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /customers","href":"/api-reference/v3/customers/고객-생성"},{"title":"고객 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /customers","href":"/api-reference/v3/customers/고객-목록-조회"},{"title":"고객 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /customers/{customer_id}","href":"/api-reference/v3/customers/고객-조회"},{"title":"식별자로 고객 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /customers/find","href":"/api-reference/v3/customers/식별자로-고객-조회"},{"title":"식별자로 고객 조회 또는 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /customers/resolve","href":"/api-reference/v3/customers/식별자로-고객-조회-또는-생성"},{"title":"고객 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /customers/{customer_id}","href":"/api-reference/v3/customers/고객-수정"},{"title":"고객 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /customers/{customer_id}","href":"/api-reference/v3/customers/고객-삭제"},{"title":"중복 고객 병합","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /customers/merge","href":"/api-reference/v3/customers/중복-고객-병합"},{"title":"고객 식별자 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /customers/{customer_id}/identifiers/{identifier_id}","href":"/api-reference/v3/customers/고객-식별자-삭제"}]},{"group":"고객 속성 정의","pages":[{"title":"고객 속성 정의 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /customer-attribute-definitions","href":"/api-reference/v3/customer-attribute-definitions/고객-속성-정의-생성"},{"title":"고객 속성 정의 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /customer-attribute-definitions","href":"/api-reference/v3/customer-attribute-definitions/고객-속성-정의-목록-조회"},{"title":"고객 속성 정의 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /customer-attribute-definitions/{definition_id}","href":"/api-reference/v3/customer-attribute-definitions/고객-속성-정의-조회"},{"title":"고객 속성 정의 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /customer-attribute-definitions/{definition_id}","href":"/api-reference/v3/customer-attribute-definitions/고객-속성-정의-수정"},{"title":"고객 속성 정의 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /customer-attribute-definitions/{definition_id}","href":"/api-reference/v3/customer-attribute-definitions/고객-속성-정의-삭제"}]},{"group":"메모리","pages":[{"title":"메모리 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /memories","href":"/api-reference/v3/memories/메모리-생성"},{"title":"메모리 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /memories","href":"/api-reference/v3/memories/메모리-목록-조회"},{"title":"메모리 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /memories/{memory_id}","href":"/api-reference/v3/memories/메모리-조회"},{"title":"메모리 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /memories/{memory_id}","href":"/api-reference/v3/memories/메모리-삭제"},{"title":"메모리 일괄 만료","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /memories/reset","href":"/api-reference/v3/memories/메모리-일괄-만료"}]},{"group":"알림","pages":[{"title":"알림 규칙 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /alert-rules","href":"/api-reference/v3/alerts/알림-규칙-생성"},{"title":"알림 규칙 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /alert-rules","href":"/api-reference/v3/alerts/알림-규칙-목록-조회"},{"title":"알림 규칙 상세 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /alert-rules/{alert_rule_id}","href":"/api-reference/v3/alerts/알림-규칙-상세-조회"},{"title":"알림 규칙 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /alert-rules/{alert_rule_id}","href":"/api-reference/v3/alerts/알림-규칙-수정"},{"title":"알림 규칙 채널 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /alert-rules/{alert_rule_id}/channels","href":"/api-reference/v3/alerts/알림-규칙-채널-수정"},{"title":"알림 규칙 조건 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /alert-rules/{alert_rule_id}/condition","href":"/api-reference/v3/alerts/알림-규칙-조건-수정"},{"title":"알림 규칙 스케줄 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /alert-rules/{alert_rule_id}/schedule","href":"/api-reference/v3/alerts/알림-규칙-스케줄-수정"},{"title":"알림 규칙 활성화","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /alert-rules/{alert_rule_id}/enable","href":"/api-reference/v3/alerts/알림-규칙-활성화"},{"title":"알림 규칙 비활성화","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /alert-rules/{alert_rule_id}/disable","href":"/api-reference/v3/alerts/알림-규칙-비활성화"},{"title":"알림 규칙 일시정지","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /alert-rules/{alert_rule_id}/pause","href":"/api-reference/v3/alerts/알림-규칙-일시정지"},{"title":"알림 규칙 일시정지 해제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /alert-rules/{alert_rule_id}/resume","href":"/api-reference/v3/alerts/알림-규칙-일시정지-해제"},{"title":"알림 규칙 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /alert-rules/{alert_rule_id}","href":"/api-reference/v3/alerts/알림-규칙-삭제"},{"title":"알림 규칙 테스트 알림 발송","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /alert-rules/{alert_rule_id}/test-notification","href":"/api-reference/v3/alerts/알림-규칙-테스트-알림-발송"},{"title":"알림 규칙 인시던트 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /alert-rules/{alert_rule_id}/incidents","href":"/api-reference/v3/alerts/알림-규칙-인시던트-목록-조회"},{"title":"인시던트 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /incidents","href":"/api-reference/v3/incidents/인시던트-목록-조회"}]},{"group":"워크스페이스","pages":[{"title":"하위 워크스페이스 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /organizations","href":"/api-reference/v3/organizations/하위-워크스페이스-생성"},{"title":"워크스페이스 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /organizations","href":"/api-reference/v3/organizations/워크스페이스-목록-조회"},{"title":"워크스페이스 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /organizations/{organization_id}","href":"/api-reference/v3/organizations/워크스페이스-조회"},{"title":"워크스페이스 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /organizations/{organization_id}","href":"/api-reference/v3/organizations/워크스페이스-수정"},{"title":"하위 워크스페이스 삭제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /organizations/{organization_id}","href":"/api-reference/v3/organizations/하위-워크스페이스-삭제"}]},{"group":"워크스페이스 API 키","pages":[{"title":"API 키 발급","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /organizations/{organization_id}/api-keys","href":"/api-reference/v3/organizations/api-키-발급"},{"title":"API 키 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /organizations/{organization_id}/api-keys","href":"/api-reference/v3/organizations/api-키-목록-조회"},{"title":"API 키 폐기","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /organizations/{organization_id}/api-keys","href":"/api-reference/v3/organizations/api-키-폐기"}]},{"group":"워크스페이스 인증","pages":[{"title":"워크스페이스 인증 신청","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /organizations/{organization_id}/verification","href":"/api-reference/v3/organizations/워크스페이스-인증-신청"},{"title":"워크스페이스 인증 상태 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /organizations/{organization_id}/verification","href":"/api-reference/v3/organizations/워크스페이스-인증-상태-조회"}]},{"group":"네이버톡톡","pages":[{"title":"네이버톡톡 연동 생성","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /navertalk-connections","href":"/api-reference/v3/navertalk/네이버톡톡-연동-생성"},{"title":"네이버톡톡 연동 목록 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /navertalk-connections","href":"/api-reference/v3/navertalk/네이버톡톡-연동-목록-조회"},{"title":"네이버톡톡 연동 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /navertalk-connections/{connection_id}","href":"/api-reference/v3/navertalk/네이버톡톡-연동-조회"},{"title":"네이버톡톡 연동 수정","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json patch /navertalk-connections/{connection_id}","href":"/api-reference/v3/navertalk/네이버톡톡-연동-수정"},{"title":"네이버톡톡 확인 코드 재발급","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /navertalk-connections/{connection_id}/verification","href":"/api-reference/v3/navertalk/네이버톡톡-확인-코드-재발급"},{"title":"네이버톡톡 연동 활성화","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /navertalk-connections/{connection_id}/enable","href":"/api-reference/v3/navertalk/네이버톡톡-연동-활성화"},{"title":"네이버톡톡 연동 중지","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /navertalk-connections/{connection_id}/disable","href":"/api-reference/v3/navertalk/네이버톡톡-연동-중지"},{"title":"네이버톡톡 연동 해제","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json delete /navertalk-connections/{connection_id}","href":"/api-reference/v3/navertalk/네이버톡톡-연동-해제"},{"title":"네이버톡톡 응대권 조회","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json get /chats/{chat_id}/navertalk","href":"/api-reference/v3/chats/네이버톡톡-응대권-조회"},{"title":"네이버톡톡 응대권 전환","deprecated":null,"version":null,"openapi":"/api-reference/v3/openapi.json post /chats/{chat_id}/navertalk/handover","href":"/api-reference/v3/chats/네이버톡톡-응대권-전환"}]}]},{"tab":"변경 내역","icon":"list-timeline","pages":[{"title":"변경 내역","href":"/changelog/2026/10"}]}]},"basePath":"","title":"음성 모델 조회 - vox.ai 문서","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["10e4515597","c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["BannerMarkdown-DicSZcaX.js","dist-CIQkMg3R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-ClVdStUn.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BAvA99GL.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","AssistantPageLink-ImrFS4Fy.js"]}