transcript

文字起こし

TranscriptAPI.com 経由で動画の文字起こしを取得します。

セットアップ

$TRANSCRIPT_API_KEY が設定されていない場合は、references/auth-setup.md を読み、そこに記載された手順に従ってキーを取得して保存してください。

必須ヘッダー

すべてのリクエストに、次の2つのヘッダーが必要です。

• Authorization: Bearer $TRANSCRIPT_API_KEY
• User-Agent: エージェントの名前と、分かる場合はバージョン（例：HermesAgent/0.11.0、ClaudeCode/1.0）。バージョンは省略可能です。エージェント名だけでも問題ありません。このヘッダーを省略したり、既定値のまま送信したりしないでください。Cloudflare は 403（エラーコード 1010）を返し、リクエストをブロックします。

GET /api/v2/youtube/transcript

GET https://transcriptapi.com/api/v2/youtube/transcript?video_url=VIDEO_URL&format=text&include_timestamp=true&send_metadata=true
Authorization: Bearer $TRANSCRIPT_API_KEY
User-Agent: YourAgent/1.0

パラメーター	必須	デフォルト	値
video_url	はい	—	YouTube URL または11文字の動画 ID
format	いいえ	json	json、text
include_timestamp	いいえ	true	true、false
send_metadata	いいえ	false	true、false

完全な URL（youtube.com/watch?v=ID）、短縮 URL（youtu.be/ID）、ショート動画（youtube.com/shorts/ID）、または動画 ID のみを指定できます。

デフォルト： ユーザーから別の指定がない限り、常に format=text&include_timestamp=true&send_metadata=true を使用してください。

レスポンス（format=json）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": [
    { "text": "We're no strangers to love", "start": 18.0, "duration": 3.5 },
    { "text": "You know the rules and so do I", "start": 21.5, "duration": 2.8 }
  ],
  "metadata": {
    "title": "Rick Astley - Never Gonna Give You Up",
    "author_name": "Rick Astley",
    "author_url": "https://www.youtube.com/@RickAstley",
    "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
  }
}

レスポンス（format=text）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules...",
  "metadata": {...}
}

エラー

コード	意味	対応
401	API キーが無効	キーを確認するか、再セットアップしてください
402	クレジット不足	transcriptapi.com/billing でチャージしてください
403/1010	Cloudflare によるブロック	User-Agent ヘッダーを追加または修正してください
404	文字起こしなし	動画で字幕が有効になっていない可能性があります
408	タイムアウト	2秒後に1回再試行してください
429	レート制限	待ってから再試行してください

ヒント

• 長い動画の場合は、まず要点を要約し、リクエストがあれば全文の文字起こしを提示してください。
• 特定の場面を引用するために正確なタイムスタンプが必要な場合は、format=json を使用してください。
• 翻訳や分析に適した読みやすいテキストが必要な場合は、include_timestamp=false を使用してください。
• リクエストが成功するごとに1クレジットを消費します。エラーではクレジットを消費しません。
• 無料プラン：100クレジット、毎分300リクエスト。

コピー＆ペースト用の例

このファイル内のすべてのリクエストを、すぐに実行できる1行コマンドとしてまとめています：references/curl-examples.md