APIリファレンス
数行のコードでMorlivoの翻訳と文字起こしをアプリケーションに統合できます。
https://api.morlivo.ai
認証: Authorization: Bearer mrl_...
認証
すべてのAPIリクエストにはBearerトークンが必要です。設定のダッシュボードからAPIキーを取得してください。
Authorization: Bearer mrl_your_api_key_here
APIキーは以下で始まります mrl_. 秘密にしてください。漏洩した場合はダッシュボードからローテーションしてください。
/v1/translate
テキストをある言語から別の言語に翻訳します。ソース言語は省略時に自動検出されます。
リクエストボディ JSON
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
text | string | はい | 翻訳するテキスト |
target_language | string | はい | ISO 639-1コード(例:es、fr、de) |
source_language | string | いいえ | 省略時は自動検出 |
project_id | integer | いいえ | プロジェクトの用語集とスタイルを適用 |
formality | string | いいえ | Register: formal, informal, or default |
レスポンス 200
| フィールド | タイプ | 説明 |
|---|---|---|
translated_text | string | 翻訳されたテキスト |
source_language | string | 検出または指定されたソース言語 |
target_language | string | ターゲット言語コード |
confidence | float | 品質スコア 0.0 - 1.0 |
validation | object | 品質検証結果 |
例
curl -X POST https://api.morlivo.ai/api/v1/translate \
-H "Authorization: Bearer mrl_your_key" \
-H "Content-Type: application/json" \
-d '{
"text": "Hello, world!",
"target_language": "es"
}'
import httpx
resp = httpx.post(
"https://api.morlivo.ai/api/v1/translate",
headers={"Authorization": "Bearer mrl_your_key"},
json={
"text": "Hello, world!",
"target_language": "es",
},
)
data = resp.json()
print(data["translated_text"])
# → "¡Hola, mundo!"
const resp = await fetch(
"https://api.morlivo.ai/api/v1/translate",
{
method: "POST",
headers: {
"Authorization": "Bearer mrl_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
text: "Hello, world!",
target_language: "es",
}),
}
);
const data = await resp.json();
console.log(data.translated_text);
// → "¡Hola, mundo!"
{
"translated_text": "¡Hola, mundo!",
"source_language": "en",
"target_language": "es",
"confidence": 0.98,
"validation": {
"length_ratio": 1.08,
"language_match": true,
"passed": true
}
}
/v1/transcribe
音声または動画ファイルをテキストに文字起こし。最大100MBまで対応。
リクエストボディ multipart/form-data
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
file | file | はい | 音声/動画ファイル(mp3、wav、mp4、webm等) |
language | string | いいえ | ISOコード、省略時は自動検出 |
project_id | integer | いいえ | 追跡用のプロジェクトにリンク |
response_format | string | いいえ | Output format: json, verbose_json, text, srt, vtt |
punctuate | boolean | いいえ | Include punctuation (default true) |
レスポンス 200
| フィールド | タイプ | 説明 |
|---|---|---|
text | string | 完全な文字起こしテキスト |
language | string | 検出された言語 |
duration_seconds | float | 音声の長さ |
confidence | float | 品質スコア 0.0 - 1.0 |
language_confidence | float | Confidence of auto-detected language (null if language was specified) |
segments | array | タイムスタンプ付きセグメント |
validation | object | 品質チェック |
例
curl -X POST https://api.morlivo.ai/api/v1/transcribe \
-H "Authorization: Bearer mrl_your_key" \
-F "file=@meeting.mp3" \
-F "language=en"
import httpx
with open("meeting.mp3", "rb") as f:
resp = httpx.post(
"https://api.morlivo.ai/api/v1/transcribe",
headers={"Authorization": "Bearer mrl_your_key"},
files={"file": ("meeting.mp3", f, "audio/mpeg")},
data={"language": "en"},
)
data = resp.json()
print(data["text"])
{
"text": "Welcome everyone to today's meeting...",
"language": "en",
"duration_seconds": 342.5,
"confidence": 0.95,
"language_confidence": 0.95,
"segments": [
{"start": 0.0, "end": 3.2, "text": "Welcome everyone"},
{"start": 3.2, "end": 6.8, "text": "to today's meeting."}
],
"validation": {
"words_per_minute": 148,
"repetition_detected": false,
"passed": true
}
}
/v1/live/transcribe
リアルタイムでオーディオをストリーミングし、ライブ文字起こし結果を受信します。
接続
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
token | string | はい | クエリパラメータとしてのAPIキー |
language | string | いいえ | ソース言語のヒント(例:en、fr)。省略した場合は自動検出されます。 |
プロトコル
バイナリPCMオーディオフレーム(16ビット、16kHzモノラル)
typeフィールドを含むJSONメッセージ:transcript(部分/最終テキスト)、status(セッションイベント)、error
受信メッセージ
| フィールド | タイプ | 説明 |
|---|---|---|
type | string | "transcript" | "status" | "error" |
text | string | 文字起こしテキスト(トランスクリプトメッセージ上) |
is_final | boolean | セグメントが完了した場合にtrue |
language | string | 検出された言語コード |
例
const ws = new WebSocket(
"wss://live.morlivo.ai/v1/live/transcribe?token=mrl_your_key&language=en"
);
navigator.mediaDevices.getUserMedia({ audio: true })
.then(stream => {
const ctx = new AudioContext({ sampleRate: 16000 });
const source = ctx.createMediaStreamSource(stream);
const processor = ctx.createScriptProcessor(4096, 1, 1);
source.connect(processor);
processor.connect(ctx.destination);
processor.onaudioprocess = (e) => {
const pcm = e.inputBuffer.getChannelData(0);
const int16 = new Int16Array(pcm.length);
for (let i = 0; i < pcm.length; i++)
int16[i] = Math.max(-1, Math.min(1, pcm[i])) * 0x7FFF;
ws.send(int16.buffer);
};
});
ws.onmessage = (event) => {
const msg = JSON.parse(event.data);
if (msg.type === "transcript") {
console.log(msg.is_final ? "FINAL:" : "partial:", msg.text);
}
};
import asyncio, json, websockets
async def live_transcribe():
uri = "wss://live.morlivo.ai/v1/live/transcribe?token=mrl_your_key"
async with websockets.connect(uri) as ws:
# Send audio chunks (PCM 16-bit 16kHz mono)
with open("audio.pcm", "rb") as f:
while chunk := f.read(4096):
await ws.send(chunk)
msg = json.loads(await ws.recv())
if msg["type"] == "transcript":
print(msg["text"], end="\r" if not msg["is_final"] else "\n")
asyncio.run(live_transcribe())
// Session started
{"type": "status", "message": "session_started"}
// Partial transcript (still speaking)
{"type": "transcript", "text": "Hello every", "is_final": false}
// Final transcript (segment complete)
{"type": "transcript", "text": "Hello everyone, welcome to the meeting.",
"is_final": true, "language": "en"}
// Session ended
{"type": "status", "message": "session_ended",
"duration_seconds": 45.2}
/v1/live/translate
ある言語でオーディオをストリーミングし、別の言語で翻訳テキストをリアルタイムに受信します。自動言語検出による音声テキスト変換翻訳に対応。
接続
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
token | string | はい | クエリパラメータとしてのAPIキー |
target_language | string | はい | 出力テキストの言語(例:en、es、fr) |
source_language | string | いいえ | ソースの音声言語。省略した場合は自動検出されます。 |
プロトコル
バイナリPCMオーディオフレーム(16ビット、16kHzモノラル)
target_languageでの翻訳テキストを含むJSONメッセージ。元の音声のトランスクリプトと翻訳出力の両方を含みます。
受信メッセージ
| フィールド | タイプ | 説明 |
|---|---|---|
type | string | "transcript" | "status" | "error" |
text | string | 対象言語での翻訳テキスト |
is_final | boolean | セグメントが完了した場合にtrue |
source_language | string | 検出されたソース言語 |
target_language | string | ターゲット言語コード |
例
const ws = new WebSocket(
"wss://live.morlivo.ai/v1/live/translate" +
"?token=mrl_your_key&target_language=es&source_language=en"
);
// Stream microphone audio (same setup as live transcribe)
// ...
ws.onmessage = (event) => {
const msg = JSON.parse(event.data);
if (msg.type === "transcript" && msg.is_final) {
console.log(`[${msg.source_language} → ${msg.target_language}]`);
console.log(msg.text);
}
};
import asyncio, json, websockets
async def live_translate():
uri = (
"wss://live.morlivo.ai/v1/live/translate"
"?token=mrl_your_key"
"&source_language=fr&target_language=en"
)
async with websockets.connect(uri) as ws:
with open("french_audio.pcm", "rb") as f:
while chunk := f.read(4096):
await ws.send(chunk)
msg = json.loads(await ws.recv())
if msg["type"] == "transcript" and msg["is_final"]:
print(f"Translation: {msg['text']}")
asyncio.run(live_translate())
// Partial translation
{"type": "transcript", "text": "Hello every",
"is_final": false, "source_language": "fr", "target_language": "en"}
// Final translated segment
{"type": "transcript",
"text": "Hello everyone, welcome to the meeting.",
"is_final": true,
"source_language": "fr", "target_language": "en"}
// Session summary
{"type": "status", "message": "session_ended",
"duration_seconds": 120.5}
/v1/live/rooms
Create a multi-participant translation room. Each participant speaks their own language and receives translated text from other participants.
リクエストボディ JSON
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
languages | object | はい | Participant ID to language mapping |
bridge_language | string | いいえ | Hub language, default en |
max_participants | int | いいえ | Max participants 2-10, default 10 |
mode | string | いいえ | interpreter or inline |
レスポンス 200
| フィールド | タイプ | 説明 |
|---|---|---|
room_id | string | Unique room identifier |
status | string | Room status |
languages | object | Participant ID to language mapping |
bridge_language | string | Hub language used for translation |
mode | string | Translation mode |
max_participants | int | Maximum number of participants |
例
curl -X POST https://api.morlivo.ai/api/v1/live/rooms \
-H "Authorization: Bearer mrl_your_key" \
-H "Content-Type: application/json" \
-d '{
"languages": {"alice": "en", "bob": "fr", "carlos": "es"},
"bridge_language": "en",
"mode": "interpreter"
}'
{
"room_id": "room_abc123",
"status": "active",
"languages": {"alice": "en", "bob": "fr", "carlos": "es"},
"bridge_language": "en",
"mode": "interpreter",
"max_participants": 10
}
/v1/live/speech/{room_id}
Connect a participant to a room for real-time speech translation.
接続
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
room_id | string | はい | Room ID from create room response (path param) |
participant | string | はい | Participant ID (query param) |
token | string | はい | クエリパラメータとしてのAPIキー |
例
const ws = new WebSocket(
"wss://live.morlivo.ai/v1/live/speech/room_abc123" +
"?token=mrl_your_key&participant=alice"
);
ws.onmessage = (event) => {
const msg = JSON.parse(event.data);
if (msg.type === "transcript" && msg.is_final) {
console.log(`[${msg.source_language} → ${msg.target_language}]`);
console.log(msg.text);
}
};
/v1/live/rooms/{room_id}/participants
Add a participant to an existing room after creation.
リクエストボディ JSON
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
participant_id | string | はい | Unique participant identifier |
language | string | はい | Participant's language code |
例
curl -X POST https://api.morlivo.ai/api/v1/live/rooms/room_abc123/participants \
-H "Authorization: Bearer mrl_your_key" \
-H "Content-Type: application/json" \
-d '{
"participant_id": "diana",
"language": "de"
}'
/v1/languages
List all supported languages with locale, name, and availability status.
レスポンス 200
| フィールド | タイプ | 説明 |
|---|---|---|
languages | array | List of supported languages |
languages[].locale | string | Locale code e.g. fr-CA |
languages[].name | string | English name |
languages[].native_name | string | Native name |
languages[].country | string | Country/region |
languages[].status | string | ga or beta |
例
curl https://api.morlivo.ai/api/v1/languages \
-H "Authorization: Bearer mrl_your_key"
{
"languages": [
{"locale": "en-US", "name": "English", "native_name": "English", "country": "United States", "status": "ga"},
{"locale": "fr-CA", "name": "French", "native_name": "Français", "country": "Canada", "status": "ga"},
{"locale": "sw-KE", "name": "Swahili", "native_name": "Kiswahili", "country": "Kenya", "status": "beta"}
]
}
/v1/health
Check API status and database health. No authentication required.
レスポンス 200
| フィールド | タイプ | 説明 |
|---|---|---|
status | string | 正常または劣化 |
例
curl https://api.morlivo.ai/api/v1/health
{
"status": "healthy"
}
互換エンドポイント
既に他のプロバイダーをご利用ですか?URLを1つ変更するだけで既存のコードをそのまま使えます。これらのエンドポイントは主要な翻訳・文字起こしAPIのリクエストとレスポンスの形式をミラーリングしています。
DeepL
翻訳POST /api/compat/deepl/v2/translate
ドロップイン置き換え対象 api-free.deepl.com
Google Cloud Translation
翻訳POST /api/compat/google/v3/projects/{"{p}"}/locations/{"{l}"}:translateText
ドロップイン置き換え対象 translation.googleapis.com
AWS Translate
翻訳POST /api/compat/aws/translate
ドロップイン置き換え対象 translate.amazonaws.com
OpenAI Whisper
文字起こしPOST /api/compat/openai/v1/audio/transcriptions
ドロップイン置き換え対象 api.openai.com
Deepgram
文字起こしPOST /api/compat/deepgram/v1/listen
ドロップイン置き換え対象 api.deepgram.com
互換エンドポイントは元のプロバイダーと同じリクエスト形式を受け入れ、同じレスポンス構造を返します。各プロバイダーのリクエスト/レスポンススキーマについては、各プロバイダーのドキュメントを参照してください。
エラー
すべてのエラーはdetailフィールドを含むJSONオブジェクトを返します。
| コード | 意味 | 発生時期 |
|---|---|---|
| 400 | 不正なリクエスト | 必須フィールドの欠落、空のテキスト、サポートされていないファイルタイプ |
| 401 | 認証エラー | APIキーが見つからないか無効です |
| 403 | 禁止 | APIキーは有効ですが、権限不足またはクォータ超過です |
| 413 | ペイロードが大きすぎます | ファイルが100MBのアップロード制限を超えています |
| 429 | レート制限 | リクエストが多すぎます。指数バックオフで再試行してください。 |
| 500 | 内部エラー | 予期しないサーバーエラー。問題が続く場合はサポートにお問い合わせください。 |
| 503 | サービス利用不可 | AIモデルが一時的に利用できません(サーキットブレーカーが開いています)。しばらくしてから再試行してください。 |
{
"detail": "Field 'text' must not be empty."
}
PII墨消し
翻訳または文字起こしリクエストにPII墨消しを追加します。検出・墨消しするエンティティタイプを指定してください。
リクエストボディ JSON
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
text | string | はい | 翻訳するテキスト |
source_language | string | いいえ | 省略時は自動検出 |
target_language | string | はい | ISO 639-1コード(例:es、fr、de) |
redact | string[] | いいえ | 墨消しするエンティティタイプ(例:email、phone、name) |
レスポンス 200
| フィールド | タイプ | 説明 |
|---|---|---|
translated_text | string | PII墨消し済みの翻訳テキスト |
source_language | string | 検出または指定されたソース言語 |
target_language | string | ターゲット言語コード |
confidence | float | 品質スコア 0.0 - 1.0 |
redactions | array | 適用された墨消しのリスト(タイプと置換内容) |
例
curl -X POST https://api.morlivo.ai/api/v1/translate \
-H "Authorization: Bearer mrl_your_key" \
-H "Content-Type: application/json" \
-d '{
"text": "Contact John Smith at john@example.com or 555-123-4567",
"source_language": "en",
"target_language": "fr",
"redact": ["email", "phone", "name"]
}'
import httpx
resp = httpx.post(
"https://api.morlivo.ai/api/v1/translate",
headers={"Authorization": "Bearer mrl_your_key"},
json={
"text": "Contact John Smith at john@example.com or 555-123-4567",
"source_language": "en",
"target_language": "fr",
"redact": ["email", "phone", "name"],
},
)
data = resp.json()
print(data["translated_text"])
# → "Contactez [NAME_REDACTED] à [EMAIL_REDACTED] ou [PHONE_REDACTED]"
const resp = await fetch(
"https://api.morlivo.ai/api/v1/translate",
{
method: "POST",
headers: {
"Authorization": "Bearer mrl_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
text: "Contact John Smith at john@example.com or 555-123-4567",
source_language: "en",
target_language: "fr",
redact: ["email", "phone", "name"],
}),
}
);
const data = await resp.json();
console.log(data.translated_text);
// → "Contactez [NAME_REDACTED] à [EMAIL_REDACTED] ou [PHONE_REDACTED]"
{
"translated_text": "Contactez [NAME_REDACTED] à [EMAIL_REDACTED] ou [PHONE_REDACTED]",
"source_language": "en",
"target_language": "fr",
"confidence": 0.95,
"redactions": [
{"type": "name", "replacement": "[NAME_REDACTED]"},
{"type": "email", "replacement": "[EMAIL_REDACTED]"},
{"type": "phone", "replacement": "[PHONE_REDACTED]"}
]
}
サポートされるエンティティタイプ
| エンティティ | 説明 | 検出 |
|---|---|---|
email |
メールアドレス | パターンベース(含む) |
phone |
電話番号 | パターンベース(含む) |
ssn |
社会保障番号 | パターンベース(含む) |
credit_card |
クレジットカード番号 | パターンベース(含む) |
ip_address |
IPアドレス | パターンベース(含む) |
name |
人名 | AI搭載(追加費用) |
address |
住所 | AI搭載(追加費用) |
medical |
医療情報 | AI搭載(追加費用) |
フォーマットベースのエンティティ(メール、電話、SSN、クレジットカード、IP)はパターンマッチングで追加費用なく検出されます。コンテキストベースのエンティティ(氏名、住所、医療情報)はAI搭載の検出を使用し、リクエストごとに少額の追加料金が発生します。