video-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 形式：

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://youtube.com/shorts/VIDEO_ID
• 動画 ID のみ：dQw4w9WgXcQ

レスポンス（format=text&send_metadata=true）：

{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": "[00:00:18] We're no strangers to love\n[00:00:21] You know the rules...",
  "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=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 }
  ]
}

ヒント

• 長い文字起こしは、まず要点にまとめ、リクエストがあれば全文を提示してください。
• 特定の場面を引用するために正確なタイムスタンプが必要な場合は、format=json を使用してください。
• 動画のタイトルとチャンネル情報を取得するには、send_metadata=true を使用してください。
• YouTube Shorts にも対応しています。

エラー

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

リクエストが成功すると、1クレジットを消費します。エラーではクレジットを消費しません。無料枠：100クレジット、300 req/min。

コピーして貼り付けられる例

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