Skip to main content
POST
/
models
/
voices
음성 모델 생성
curl --request POST \
  --url https://client-api.tryvox.co/v3/models/voices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form clip='@example-file' \
  --form 'name=<string>' \
  --form 'language=<string>' \
  --form 'description=<string>' \
  --form enhance=false
{
  "provider": "<string>",
  "id": "<string>",
  "name": "<string>",
  "language": "<string>",
  "sample_url": "<string>",
  "description": "<string>",
  "model": "<string>",
  "capabilities": {}
}

Authorizations

​
Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Body

multipart/form-data

이 엔드포인트가 받는 multipart 폼 데이터입니다.

​
clip
file
required

복제할 오디오 파일입니다. audio/wav, audio/x-wav, audio/mpeg, audio/mp3, audio/mp4, audio/x-m4a 형식을 지원하며 6MB 이하여야 합니다.

​
name
string
required

보이스 이름입니다. 비워 둘 수 없습니다.

​
language
string
required

보이스 언어입니다. 허용 값: ko, en, ja, zh, es, fr, de, id, th, vi.

​
description
string | null

보이스를 구분하기 위한 설명입니다. 선택 사항입니다.

​
enhance
boolean
default:false

배경 소음 줄이기를 적용할지 여부입니다. 소음이 있는 샘플에만 권장하며, 음색 유사도가 낮아질 수 있습니다.

Response

성공 응답

단일 Voice 모델 엔트리.

​
provider
string
required

TTS 공급사.

​
id
string
required

공급사 내 음성 식별자. 에이전트 설정의 data.voice.id에 지정하는 값입니다.

​
name
string
required

사람이 읽는 음성 이름.

​
language
string
required

BCP-47 locale code입니다. 음성 선택 시 agent.data.voice.language에 이 값을 사용합니다.

​
gender
enum<string> | null

provider가 제공하는 경우 포함되는 음성 gender 메타데이터입니다.

Available options:
male,
female
​
sample_url
string | null

사용 가능한 경우 제공되는 sample audio clip URL입니다.

​
description
string | null

사람이 읽을 수 있는 설명입니다.

​
model
string | null

TTS 공급사 내 모델명 (예: eleven_turbo_v2_5).

​
capabilities
Capabilities · object

지원되는 속도나 볼륨 범위 같은 voice parameter capability hint입니다.