POST/api/app/voice200 OK · audio/mpeg
curl -X POST https://sorato.group/api/app/voice \
  -H "Authorization: Bearer mk_live_..." \
  -F "text=Hello, this is my cloned voice." \
  -F "target_language=es-ES"

자신의 코드에서 Loqal 도구를 호출하세요.

음성 복제, 번역, 필사 및 회의 에이전트를 위한 REST 엔드포인트와 LiveKit의 실시간 아바타.

일곱 개의 도구, 하나의 키

스튜디오의 모든 도구는 REST 엔드포인트이기도 합니다. 동일한 인증, 동일한 계정, 동일한 키.

API

POST/api/app/fm/generate

단발 LoqalFM 에피소드를 큐에 넣습니다. 즉시 jobId를 반환합니다: GET /api/app/fm/jobs/{jobId}를 상태가 완료될 때까지 폴링한 후 오디오를 다운로드하세요.

인증. Loqal API 키를 Authorization: Bearer mk_live_…로 보내세요. 브라우저에서는 로그인된 세션 쿠키가 자동으로 사용됩니다.

요청

genrestring필수방송 형식: 광고, 인터뷰, 날씨, 교통, 전화, psa, 토크쇼, 뉴스 속보.
languagestring선택 사항BCP-47 방송 언어. 기본값 en-US.
world_infostring선택 사항주제 / 세계 시드. 놀라움을 위해 비워 두세요.
durationnumber선택 사항형식 기본 길이(초)를 재정의합니다.

예시

curl -X POST https://sorato.group/api/app/fm/generate \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"genre": "interview", "world_info": "the history of tea"}'

API

POST/api/app/voice

오디오 샘플에서 음성을 복제하고 텍스트를 합성하며, 선택적으로 먼저 번역합니다. 기존 복제를 재사용하려면 voice_id를 전달하세요.

인증. Loqal API 키를 Authorization: Bearer mk_live_…로 보내세요. 브라우저에서는 로그인된 세션 쿠키가 자동으로 사용됩니다.

요청

audiofile선택 사항음성 샘플 (voice_id를 재사용할 때 생략).
textstring필수복제된 음성이 말해야 할 내용.
target_languagestring선택 사항출력 언어, 예: es-ES. 기본값 en-US.
translateboolean선택 사항합성 전에 텍스트를 target_language로 번역합니다.
voice_idstring선택 사항이전 호출에서 복제를 재사용합니다.

예시

curl -X POST https://sorato.group/api/app/voice \
  -H "Authorization: Bearer mk_live_..." \
  -F "[email protected]" \
  -F "text=Hello, this is my cloned voice." \
  -F "target_language=es-ES"

API

POST/api/app/translate

짧은 음성 클립과 대상 언어를 보내세요. 하나의 응답으로 전사, 번역 및 합성된 음성을 받으세요.

인증. Loqal API 키를 Authorization: Bearer mk_live_…로 보내세요. 브라우저에서는 로그인된 세션 쿠키가 자동으로 사용됩니다.

요청

audiofile필수짧은 음성 녹음.
target_langstring필수BCP-47 대상 언어, 예: es-ES.

예시

curl -X POST https://sorato.group/api/app/translate \
  -H "Authorization: Bearer mk_live_..." \
  -F "[email protected]" \
  -F "target_lang=es-ES"

API

POST/api/app/transcribe

녹음을 업로드하고 전사 JSON 또는 형식 매개변수를 설정하여 스타일이 지정된 HTML/PDF 문서를 받습니다.

인증. Loqal API 키를 Authorization: Bearer mk_live_…로 보내세요. 브라우저에서는 로그인된 세션 쿠키가 자동으로 사용됩니다.

요청

audiofile필수오디오 또는 비디오 파일.
targetstring선택 사항번역을 위한 BCP-47 출력 언어입니다. 기본값은 en입니다.
titlestring선택 사항html/pdf 출력용 문서 제목.
formatquery: json|html|pdf선택 사항응답 형식. 기본값 json.

예시

curl -X POST "https://sorato.group/api/app/transcribe?format=json" \
  -H "Authorization: Bearer mk_live_..." \
  -F "[email protected]"

API

POST/api/app/meet/launch

Zoom, Meet 또는 Teams에 봇을 시작합니다. bot_id와 sid를 반환합니다: 실시간 전사를 폴링한 후 통화가 끝나면 회의록을 렌더링하세요.

인증. Loqal API 키를 Authorization: Bearer mk_live_…로 보내세요. 브라우저에서는 로그인된 세션 쿠키가 자동으로 사용됩니다.

요청

meeting_urlstring필수Google Meet / Zoom / Teams 링크.
modestring선택 사항conference | bilingual | monolingual. Default conference.
user_languagestring선택 사항이중 언어(통역사) 모드를 위한 두 번째 언어.
avatar_idstring선택 사항렌더링할 아바타, GET /api/app/meet/characters에서 가져오기.

예시

curl -X POST https://sorato.group/api/app/meet/launch \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"meeting_url": "https://meet.google.com/xyz-abcd-efg", "mode": "bilingual", "user_language": "es-ES"}'

API

POST/api/app/learn

오디오/비디오 수업을 업로드합니다. 이를 전사한 후 요약, 용어 및 이해 질문을 user_language로 추출합니다.

인증. Loqal API 키를 Authorization: Bearer mk_live_…로 보내세요. 브라우저에서는 로그인된 세션 쿠키가 자동으로 사용됩니다.

요청

mediafile필수오디오 또는 비디오 수업.
user_languagestring선택 사항용어/질문 지원 언어. 기본값 en.
glosses_onlyboolean선택 사항질문을 건너뛰고 용어만 반환합니다.

예시

curl -X POST https://sorato.group/api/app/learn \
  -H "Authorization: Bearer mk_live_..." \
  -F "[email protected]" \
  -F "user_language=es"

API

POST/api/app/voqal/token

라이브 아바타 에이전트에 클라이언트를 연결하기 위한 LiveKit 토큰과 URL을 반환합니다. 먼저 GET /api/app/voqal/avatars로 아바타를 나열하세요.

인증. Loqal API 키를 Authorization: Bearer mk_live_…로 보내세요. 브라우저에서는 로그인된 세션 쿠키가 자동으로 사용됩니다.

요청

avatar_idstring필수GET /api/app/voqal/avatars에서 아바타 UUID.
languagestring선택 사항음성 언어. 기본값 en.
namestring선택 사항세션 참가자의 표시 이름입니다.

예시

curl -X POST https://sorato.group/api/app/voqal/token \
  -H "Authorization: Bearer mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"avatar_id": "...", "language": "es"}'

다음 단계