翻訳

transcript1はまずメディアを文字起こしし、続いて文字起こしのテキストをお好きな言語へ翻訳します。翻訳はセグメントごとに対応づけられ、元のタイムスタンプと話者がそのまま保たれます。翻訳するのはテキストだけで、吹き替えや翻訳音声はありません。

翻訳は無料です。使う分数は0分で、使用履歴には無料の「Translation」項目として表示されます。文字起こしの分数はこれまでどおり差し引かれ、翻訳が失敗しても文字起こしが失敗したり返金されたりすることはありません。

文字起こしと同時に翻訳する

文字起こしを作成するリクエストにtranslate_toを加えます。esやenのような、小文字2文字のISO 639-1コードです。POST /v1/transcriptionsのJSON本文にある動画リンク、チャンクアップロードの予約、1回で済むmultipartアップロードのいずれでも使えます。

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "translate_to": "es"}'

ファイルをアップロードするときは、translate_toをフォームフィールドとして送ります。

curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -F [email protected] \
  -F translate_to=en

MCPのtranscribeツールもtranslate_toを受け取ります。1回のリクエストで指定できる翻訳先は1言語です。

すでにある文字起こしを翻訳する

完了した文字起こしの翻訳を依頼します。

curl -X POST "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD/translations" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language": "en"}'

APIは202を返します。

{
  "transcription_id": "tr_8fK2Lm0PqRsTuVwXyZaBcD",
  "language": "en",
  "status": "processing"
}

この呼び出しは冪等です。processingまたはcompletedの翻訳はそのまま返り、failedの翻訳は再試行されます。MCPツールtranslate_transcriptionはidとlanguageを受け取ります。

翻訳を読み出す

GET /v1/transcriptions/:idと、テキスト・SRT・VTTのダウンロードはtranslationを受け付けます。

レスポンスにはtranslationオブジェクトが入ります。翻訳を依頼していない場合はnullです。

{
  "translation": { "language": "es", "status": "completed" }
}

statusはprocessing、completed、failedのいずれかです。翻訳が失敗した場合はerrorメッセージも付きます。waitは依頼した翻訳の完了も待ち、待機時間を超えるとステータスはprocessingになります。MCPのget_transcriptionツールにも同じ値を取るtranslationパラメーターがあります。

Webhook

変更のないtranscription.completedとtranscription.failedに加え、翻訳の結果を知らせるイベントが2つあります。

dataは文字起こしオブジェクトにtranslation: { language, status, error }を加えたものです。署名と配信ルールはWebhooksをご覧ください。