APIリファレンス
音声テキスト変換(STT)による文字起こし
録音済みの音声ファイルをアップロードし、タイムスタンプ付きの正確な文字起こしを非同期で取得します。
大きな音声ファイルの処理には数分かかる場合があるため、このAPIでは堅牢な「Submit & Poll(送信とポーリング)」アーキテクチャを採用しています。まずファイルを送信して `job_id` を取得し、その後、文字起こしが完了するまでステータスエンドポイントへのポーリングを行います。
1. 音声ジョブを送信する
投稿
/api/v1/stt/submit/
| パラメータ | 必須 | タイプ | 説明 |
|---|---|---|---|
| audio | 必須 | ファイル | 文字起こし対象の音声ファイル。mp3、wav、m4aなどに対応。最大50MB。 |
| language | 任意 | 文字列 | デフォルトは ar-JO です。 |
| output_format | 任意 | 文字列 | json または srt を受け付けます。デフォルトは json です。 |
2. ジョブの状態を確認する
取得する
/api/v1/stt/status/{job_id}/
本番環境への統合例 (Python)
import requests
import time
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1. 音声ファイルを提出してください。
submit_url = "https://moknah.io/api/v1/stt/submit/"
files = {"audio": ("audio.mp3", open("long_audio.mp3", "rb"), "audio/mpeg")}
data = {"language": "ar-JO", "output_format": "json"}
print("音声を送信中...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"ジョブをキューに追加しました! ID: {job_id}")
# 2. 結果をポーリングする
status_url = f"https://moknah.io/api/v1/stt/status/{job_id}/"
while True:
res = requests.get(status_url, headers=HEADERS)
result = res.json()
if result.get("status") in ["queued", "processing"]:
print("処理中... 5秒後に再確認します。")
time.sleep(5)
elif result.get("status") == "completed":
print("文字起こしが完了しました!")
print(result["result"]["subtitles"])
break
else:
print("ジョブが失敗しました:", result)
break
APIサポート
APIに関するご質問や問題については、こちらまでお問い合わせください。 api@moknah.io.