음성 에이전트

여기에는 두 가지가 있습니다. 에이전트의 동작을 정하는 설정과, 에이전트가 말할 때 쓰는 음성·공급자 목록입니다.

동작	Route
설정 목록	`GET /agents/configs`
설정 조회	`GET /agents/configs/{documentId}`
생성	`POST /agents/configs`
교체	`PUT /agents/configs/{documentId}`
삭제	`DELETE /agents/configs/{documentId}`
공급자 목록	`GET /voice/providers`
음성 목록	`GET /voice/providers/{provider}/voices`

설정

설정은 하나의 문서입니다. 에이전트 기능이 늘어나면 studio가 필드를 추가하므로, 모르는 키는 버리지 말고 그대로 전달하세요.

공급자와 음성 목록

사용 가능한 공급자는 배포 환경마다 다릅니다. 고정값이 아니라 그 환경에 설정된 vendor key에 따라 정해집니다. 공급자 이름을 코드에 넣지 말고 실행 시점에 목록을 읽으세요.

json

{
  "data": [
    {
      "id": "voice_abc",
      "name": "Mali",
      "gender": "female",
      "language": "th-TH",
      "preview": true
    }
  ]
}

preview 값을 따르세요

preview는 vendor key에 따라 달라지므로 요청마다 계산됩니다. false면 재생 버튼을 비활성화하세요. 다른 음성으로 대체하면 에이전트가 실제로 쓰지 않는 목소리를 들려주게 됩니다.

음성 에이전트 ​

설정 ​

공급자와 음성 목록 ​

음성 에이전트

설정

공급자와 음성 목록