API Bilibili Sottotitoli

Q: Posso fidarmi del codice language?

Usalo come indicazione. language è il codice assegnato da Bilibili, ad esempio zh o en, e la piattaforma può assegnarlo in modo errato. Se instradi le trascrizioni verso la traduzione o verso analisi specifiche per lingua, esegui un tuo rilevamento della lingua su text e conserva il codice di Bilibili accanto al risultato.

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: Normale

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

Ottieni il testo dei sottotitoli di un video Bilibili. Ricevi segmenti temporizzati, un codice lingua, il titolo, l'uploader e la durata in secondi. Copre ciò che viene detto nel video, non i commenti degli spettatori. L'etichetta language può essere errata.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su bilibili e action impostato su subtitles. Prezzo $0.56 per 1.000 richieste ($0.000556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

Bilibili Subtitles legge la trascrizione di ciò che viene detto in un video e la restituisce in text, con BV ID, titolo, nome dell'uploader, durata in secondi e un codice lingua. Trasforma il parlato di un video in testo ricercabile, che ricercatori, traduttori e team di contenuti usano per riassumere tutorial e recensioni, verificare cosa ha affermato un uploader su un prodotto o costruire un corpus per l'analisi degli argomenti senza guardare ogni video.

In url inserisci l'indirizzo completo del video, ad esempio https://www.bilibili.com/video/<BV ID>. Leggi text insieme a duration_seconds: una trascrizione breve su un video lungo indica poco parlato. language proviene da Bilibili e può essere errato. I commenti degli spettatori non fanno parte di questo testo; la discussione sotto il video e i commenti a schermo si leggono con funzionalità separate.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Bilibili Sottotitoli di EveryInfra (bilibili/subtitles).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su bilibili e action su subtitles, e inserisci i parametri in params.
- Parametri obbligatori:
  - url: Specifica l'URL completo di un video Bilibili, nel formato https://www.bilibili.com/video/<BVID>.
- Restituisce un oggetto. Campi principali: video_id, title, author_name, duration_seconds, duration_sec, language, text, segments.
- Esempio di corpo della richiesta:
{
  "platform": "bilibili",
  "action": "subtitles",
  "params": {
    "url": "https://www.bilibili.com/video/BV1o84y1V7EY"
  }
}
- Prezzo: $0.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

Nome	Posizione	Tipo	Obbligatorio	Predefinito	Descrizione
`Authorization`	header	`string`	Sì	-	Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
`platform`	body	`string`	Sì	`bilibili`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`subtitles`	Identificativo della funzionalità, valore fisso.
`url`	body.params	`string`	Sì	-	Specifica l'URL completo di un video Bilibili, nel formato https://www.bilibili.com/video/<BVID>. Il parametro url recupera i commenti del video con comments, i commenti temporizzati della prima parte con danmaku e la trascrizione audio con subtitles, trattandoli come fonti di testo distinte. L'azione danmaku deve poter estrarre un BV ID valido dal percorso fornito.

Esempi di codice

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"
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

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": { … }}

Campi della risposta

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

Campo	Significato
`video_id`	Mantiene il significato attribuito dalla piattaforma
`title`	Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo).
`author_name`	Nome visualizzato dell'autore.
`duration_seconds`	Durata in secondi. null per i contenuti che non sono video o audio.
`duration_sec`	Mantiene il significato attribuito dalla piattaforma
`language`	Codice della lingua del contenuto (ad esempio zh, en) secondo la piattaforma; può essere errato.
`text`	Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma).
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).
`segments`	Mantiene il significato attribuito dalla piattaforma

FAQ

`text` contiene l'intera trascrizione?

Sì. La trascrizione viene restituita per intero, senza HTML e senza essere ridotta a un estratto, quindi con una sola chiamata ottieni il testo completo. Per i video lunghi, dividi text in blocchi prima di riassumerlo o di eseguire il topic modeling, e conserva video_id su ogni blocco, così ogni passaggio resta riconducibile al suo video.

Posso fidarmi del codice `language`?

Usalo come indicazione. language è il codice assegnato da Bilibili, ad esempio zh o en, e la piattaforma può assegnarlo in modo errato. Se instradi le trascrizioni verso la traduzione o verso analisi specifiche per lingua, esegui un tuo rilevamento della lingua su text e conserva il codice di Bilibili accanto al risultato.

Come ottengo visualizzazioni e like dello stesso video?

Passa lo stesso link alla funzionalità Bilibili Video details, che restituisce il numero di visualizzazioni, like, coin e preferiti del video. video_id, il BV ID, è la chiave per unire la trascrizione a quei numeri e ai commenti a schermo, le cui righe riportano il BV ID nel proprio campo dell'ID video.

Errori e addebiti

401: Chiave mancante o non valida.
402: Saldo insufficiente. Effettua prima una ricarica.
422: Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429: Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503: Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota: Nessun dato. Nessun addebito.

Errori

Riferimenti ufficiali

Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.

Bilibili: l'annuncio ufficiale sul passaggio dai numeri AV agli identificatori BV ↗
L'annuncio di Bilibili del 2020 definisce gli identificatori BV come ID dei video caricati, composti da numeri e lettere con distinzione tra maiuscole e minuscole, e li distingue dai numeri AV solo numerici. Questo riferimento spiega solo i tipi di identificatori video; questa API accetta link nel formato indicato sopra e non garantisce il parsing di tutti i link legacy o dei video divisi in più parti.
Verificato il 2026-09-04