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でのリアルタイムアバター。

7つのツール、1つのキー

スタジオ内のすべてのツールはRESTエンドポイントでもあります。同じ認証、同じアカウント、同じキー。

API

POST/api/app/fm/generate

ワンショットLoqalFMエピソードをキューに入れます。すぐにjobIdを返します: GET /api/app/fm/jobs/{jobId}をstatus=completedまでポーリングし、その後オーディオをダウンロードします。

認証。 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

短い音声クリップとターゲット言語を送信します。1つの応答でトランスクリプト、翻訳、合成音声を受け取ります。

認証。 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出力言語。デフォルトは英語です。
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"}'

次のステップ