Moknah ドキュメント
無料で始める
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.