文字起こしと同時に動画を翻訳する
文字起こしを作成するリクエストに、2文字のISO 639-1コードであるtranslate_toを加えます。waitは翻訳の完了も待ちます。アップロードとMCPについては翻訳ガイドをご覧ください。
文字起こしは、音声またはプラットフォームの字幕から通常どおり作られます。翻訳はそのテキストに対して後から実行されるので、翻訳がまだ終わっていなくても元の文字起こしはいつでも読めます。
1回のリクエストで指定できる翻訳先は1言語だけです。別の言語も欲しいときは、完了後に同じ文字起こしをもう一度翻訳してください。
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"}'すでにある文字起こしを翻訳する
文字起こしに対して言語をPOSTします。APIは翻訳のステータスとともに202を返します。文字起こしをポーリングするか、Webhookを使ってください。ステータスコードは翻訳にまとめています。
文字起こしが完了していないと、APIはtranscript_not_readyを返します。同じリクエストを繰り返しても安全です。処理中または完了済みの翻訳はそのまま返り、失敗した翻訳は再試行されます。
Webhookではtranscription.translation.completedまたはtranscription.translation.failedが送られるため、アプリ側でポーリングを続ける必要はありません。
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"}'二か国語、翻訳のみ、原文のみを選ぶ
GET /v1/transcriptions/:idや、テキスト・SRT・VTTのダウンロードに、translation=both、only、noneのいずれかを付けます。デフォルトはbothです。
bothでは、JSONのセグメントにtranslationフィールドが付き、テキストでは翻訳の行が原文の下に入り、SRTとVTTの各キューは2行になります。onlyでは翻訳が原文に置き換わり、タイムスタンプと話者は変わりません。
レスポンスには、言語とステータス（processing、completed、failed）を持つtranslationオブジェクトも含まれます。完了済みの文字起こしを別の形式で読み出しても、追加の分数はかかりません。
| translation | 得られるもの |
|---|---|
| both | 原文と翻訳をセットで。セグメントやキューごとに1組です。 |
| only | 原文の代わりに翻訳。タイミングは同じです。 |
| none | 原文の文字起こしのみ。 |
翻訳でできること、できないこと
これは文字起こしテキストの機械翻訳です。公開する前に、固有名詞、専門用語、引用を確認し、比較のために元の文字起こしも残しておいてください。
transcript1は動画の吹き替えや音声の翻訳は行いません。翻訳された音声はなく、字幕を動画に焼き付けることもしません。お使いの編集ソフトやプレーヤーで使えるテキストと字幕ファイルをお渡しします。
翻訳に分数はかかりません。文字起こしの分数はこれまでどおり差し引かれ、翻訳が失敗しても文字起こしが失敗したり返金されたりすることはありません。