Bilibili字幕API

Q: languageのコードは信頼できますか？

目安として使ってください。languageはBilibiliが付与するzhやenなどのコードで、誤っている場合があります。書き起こしを翻訳や言語別の分析に振り分ける場合は、textに対して独自に言語判定を行い、その結果とあわせてBilibiliのコードも保持してください。

POST

APIの稼働状況

24時間の稼働状況: 正常
24時間の平均応答時間: —

良好／正常
利用可能
制限あり
ほぼ停止

正常

過去24時間

過去30日間

Bilibili動画の字幕テキストを取得します。タイムスタンプ付きのセグメント、言語コード、タイトル、投稿者、秒単位の動画の長さが返されます。対象は動画内で話されている内容で、視聴者コメントは含まれません。languageラベルは誤っている場合があります。

「Bilibili字幕」は、1本の動画内の発話の書き起こしを取得してtextで返します。あわせてBV ID、タイトル、投稿者名、秒単位の長さ、言語コードも返します。動画の発話内容を検索可能なテキストに変換できるため、研究者、翻訳者、コンテンツチームが、すべての動画を視聴することなく、チュートリアルやレビューの要約、投稿者が製品について述べた内容の確認、トピック分析用のコーパス作成に利用しています。

urlには動画の完全なアドレス（例：https://www.bilibili.com/video/<BV ID>）を指定してください。textはduration_secondsとあわせて確認してください。長い動画で書き起こしが短い場合は、発話が少ないと考えられます。languageはBilibiliが付与したもので、誤っている場合があります。視聴者のコメントはこのテキストに含まれません。動画下のコメント欄と弾幕は、それぞれ別の機能で取得します。

料金は1,000リクエストあたり$0.56（1回あたり$0.000556）です。失敗した呼び出しと空の結果には課金されません。同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのBilibili 字幕エンドポイント（bilibili/subtitles）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにbilibili、actionにsubtitlesを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - url: Bilibili動画の完全なURLを、https://www.bilibili.com/video/<BVID>の形式で指定します。urlパラメータは、commentsでは動画のコメントを、danmakuでは最初のパートの弾幕（タイムコメント）を、subtitlesでは音声の文字起こしを取得し、それぞれを別のテキストソースとして扱います。danmakuアクションでは、指定したパスから有効なBV IDを抽出できる必要があります。
- 1つのオブジェクトを返します。主なフィールド: video_id、title、author_name、duration_seconds、duration_sec、language、text、segments.
- リクエストボディの例：
{
  "platform": "bilibili",
  "action": "subtitles",
  "params": {
    "url": "https://www.bilibili.com/video/BV1o84y1V7EY"
  }
}
- 料金：1,000リクエストあたり$0.56。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`platform`	body	`string`	はい	`bilibili`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`subtitles`	機能の識別子です。値は固定です。
`url`	body.params	`string`	はい	-	Bilibili動画の完全なURLを、https://www.bilibili.com/video/<BVID>の形式で指定します。urlパラメータは、commentsでは動画のコメントを、danmakuでは最初のパートの弾幕（タイムコメント）を、subtitlesでは音声の文字起こしを取得し、それぞれを別のテキストソースとして扱います。danmakuアクションでは、指定したパスから有効なBV IDを抽出できる必要があります。

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "bilibili",
  "action": "subtitles",
  "params": {
    "url": "https://www.bilibili.com/video/BV1o84y1V7EY"
  }
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

September 26, 2026 at 08:56（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "platform": "bilibili",
  "action": "subtitles",
  "results": {
    "title": "【60集】儿童英文演讲视频，34个主题，小作文绝佳素材，每集30s短小精悍！主题包括：介绍自己、介绍家庭成员、介绍朋友、天气、梦想的工作、学校生活、学习计划、房 p01 English Speech _ All About Me",
    "author_name": "•••",
    "duration_seconds": 20,
    "language": "English",
    "text": "Everyone, nice to meet you. Let me introduce myself. My name is Julie Anderson. I'm nine years old. I'm from South Africa. I like pancakes and hot dogs. I like yellow. I like cats. Now you know more about me. I hope we can be friends.",
    "platform": "bilibili",
    "segments": [
      {
        "start": "00:00:00.830",
        "end": "00:00:10.660",
        "text": "Everyone, nice to meet you. Let me introduce myself. My name is Julie Anderson. I'm nine years old. I'm from South Africa."
      },
      {
        "start": "00:00:11.359",
        "end": "00:00:19.910",
        "text": "I like pancakes and hot dogs. I like yellow. I like cats. Now you know more about me. I hope we can be friends."
      }
    ]
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド	意味
`video_id`	プラットフォーム上の意味のまま
`title`	タイトルです。プラットフォームにタイトルがない場合（テキストのみの投稿など）はnullになります。
`author_name`	投稿者の表示名です。
`duration_seconds`	再生時間（秒）です。動画または音声ではないコンテンツの場合はnullです。
`duration_sec`	プラットフォーム上の意味のまま
`language`	プラットフォームが判定したコンテンツの言語コードです（例：zh、en）。誤っている場合があります。
`text`	HTMLを除去した本文です。省略されることなく全文が返されます（一部のプラットフォームでは一覧結果自体に抜粋しか含まれません。その場合は各プラットフォームのフィールドの注記に記載しています）。
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。
`segments`	プラットフォーム上の意味のまま

FAQ

`text`には書き起こし全体が含まれますか？

はい。書き起こしはHTMLを除去したうえで全文が返され、抜粋に切り詰められることはないため、1回の呼び出しで完全なテキストを取得できます。長い動画の場合は、要約やトピックモデルにかける前にtextをチャンクに分割し、各チャンクにvideo_idを付けておくと、どの部分もどの動画のものか追跡できます。

`language`のコードは信頼できますか？

目安として使ってください。languageはBilibiliが付与するzhやenなどのコードで、誤っている場合があります。書き起こしを翻訳や言語別の分析に振り分ける場合は、textに対して独自に言語判定を行い、その結果とあわせてBilibiliのコードも保持してください。

同じ動画の再生数やいいね数を取得するには？

同じリンクを「Bilibili動画詳細」機能に渡すと、動画の再生数、いいね数、コイン数、お気に入り数が返されます。BV IDであるvideo_idが、書き起こしをこれらの数値や弾幕と結合するためのキーになります。弾幕の各行にも、それぞれの動画IDフィールドにBV IDが入っています。

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー

公式リファレンス

対象と用語の確認にのみ使用しています。プラットフォームによるEveryInfraの承認や推奨を意味するものではありません。

Bilibili：AV番号からBV IDへの移行に関する公式告知 ↗
Bilibiliの2020年の告知では、BV IDを数字と大文字・小文字が区別される英字からなる動画投稿IDと定義し、数字のみのAV番号と区別しています。このリファレンスは動画IDの種類のみを説明するものです。このAPIは上記の形式に沿ったリンクを受け付けますが、すべての旧形式のリンクや複数パートの動画の解析を保証するものではありません。
確認日：2026-09-04