Como usar a Gemini Notebook API (NotebookLM API) para transformar páginas web, PDFs e vídeos do YouTube em podcasts em português

6 min de leitura • 4 de outubro de 2026 (18 de outubro de 2026)

A useapi.net é uma API de terceiros. Não tem afiliação com o Google nem é endossada por ele.

Sumário

  1. Introdução
  2. O que a Gemini Notebook API gera: podcasts, Video Overviews, slides, infográficos
  3. Preço da Gemini Notebook API (NotebookLM API)
  4. Preparação
  5. Como gerar um podcast do Gemini Notebook em português com uma única chamada de API
  6. Consultar o job e baixar
  7. O fluxo completo: notebook, fontes e geração
  8. Exemplo em Python
  9. Escala: várias contas e limites de taxa
  10. Automação do Gemini Notebook (NotebookLM): n8n, Colab e assistentes de código com IA
  11. Exemplos de resultado
  12. Perguntas frequentes
  13. Conclusão

Introdução

Com a Gemini Notebook API (NotebookLM API) da useapi.net, uma única chamada REST entrega uma página web ou um vídeo do YouTube à sua própria conta Google e devolve um podcast Audio Overview do Gemini Notebook como arquivo .m4a, e você pode pedir o podcast em português. Não precisa de projeto no Google Cloud nem de chave da Gemini API, e uma conta Google gratuita funciona.

O Google renomeou o NotebookLM para Gemini Notebook, e as funções continuam as mesmas. Contas Google comuns não têm API oficial. Tudo o que o site faz, esta API faz por código: criar notebooks, adicionar fontes, chat com citações, Deep Research e todas as gerações do Studio.

Este artigo foi escrito pelos mantenedores da useapi.net e fala da nossa própria API hospedada. O código de exemplo é aberto no GitHub.

O que a Gemini Notebook API gera: podcasts, Video Overviews, slides, infográficos

POST /artifacts escolhe o que gerar com o parâmetro type:

O que gera type Devolve
Audio Overview (podcast com duas vozes) audio, format pode ser deep_dive (padrão), brief, critique, debate áudio m4a
Video Overview video, format pode ser explainer (padrão), brief, cinematic, short vídeo mp4
Apresentação de slides slides pdf e pptx
Infográfico infographic imagem png
Relatório, relatório interativo, tabela de dados report, interactive_report, table texto em Markdown ou linhas de tabela
Quiz, flashcards, mapa mental quiz, flashcards, mindmap JSON

Áudio, vídeo (exceto cinematic), relatório, relatório interativo, tabela de dados, slides e infográfico aceitam language para definir o idioma da saída. Português do Brasil é pt_BR.

Preço da Gemini Notebook API (NotebookLM API)

Você paga à useapi.net um valor fixo de $15 por mês, e a mesma assinatura inclui todas as APIs da useapi.net, não só o Gemini Notebook. Cada assinatura conecta 3 contas Google, até 100 no total. A geração roda na sua própria conta Google, nós não cobramos por chamada nem por podcast, e o uso do lado do Google está incluído no plano que a conta já tem, inclusive o gratuito.

  Gemini Notebook API da useapi.net Gemini Notebook Enterprise API do Google
Conta A sua própria conta Google, plano gratuito ou pago Licenças Enterprise em um projeto Google Cloud
Preço $15 fixos por mês Licenças Enterprise compradas por usuário
Chat com citações Yes No
Deep Research Yes No
Audio Overview Yes Yes
Video Overviews, slides, infográficos, relatórios, quizzes, flashcards, mapas mentais Yes No
Status Experimental Preview (Pre-GA)

O Google define um orçamento de uso por conta, que se renova a cada 5 horas, além de um orçamento semanal. Pelas estimativas do próprio Google, uma janela completa de 5 horas inicia pelo menos 2 (plano gratuito), 9 (Google AI Pro) ou 181 (Google AI Ultra) Audio Overviews, e na prática, depois de prontos, eles costumam gastar menos que o estimado. Para produzir mais, conecte mais contas, veja Escala.

Comece a usar a API

Uma assinatura de US$ 15 por mês dá acesso a todas as APIs da useapi.net: um token, todos os serviços. Você conecta até 3 contas suas por serviço, e a useapi.net cuida da API REST, do balanceamento de carga e do polling. Precisa de mais contas? Cada assinatura extra custa US$ 10 por mês e acrescenta mais 3 contas por serviço.

Assinar — US$ 15/mês

Não tem cartão de crédito internacional? Você também pode assinar com criptomoedas (pagamentos em cripto não são reembolsáveis). Preços e planos de volume estão na página de assinatura. Pagando pelo Stripe, você recebe reembolso integral em até 14 dias após a primeira compra, se tiver menos de 50 gerações bem-sucedidas. Já é assinante? Altere a quantidade no portal do cliente Stripe em vez de comprar de novo.

Preparação

  1. Cadastre-se na useapi.net e pegue o seu token da API. Todos os exemplos abaixo supõem que ele está na variável de ambiente USEAPI_TOKEN.
  2. Conecte a conta Google pelo fluxo automatizado no navegador: informe o token e entre no Google em um navegador remoto, sem copiar cookies à mão. Recomendamos usar uma conta Gmail dedicada, não a sua conta pessoal principal.

As requisições de uma só chamada e a criação de notebooks abaixo podem omitir o email: com uma única conta conectada, a API usa essa conta, e com várias, escolhe uma que esteja livre. Chamadas sobre um notebook sempre rodam na conta dona desse notebook.

Como gerar um podcast do Gemini Notebook em português com uma única chamada de API

Não precisa criar um notebook antes. Mande urls (ou um text colado) direto para POST /artifacts, e a API cria um notebook em uma das suas contas, adiciona as fontes, espera o processamento e começa a gerar. Links de youtube.com e youtu.be entram como fontes do YouTube, até 50 links por vez.

JOBID=$(curl -s -X POST "https://api.useapi.net/v1/gemini-notebook/artifacts" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "audio",
    "format": "brief",
    "length": "short",
    "language": "pt_BR",
    "urls": ["https://pt.wikipedia.org/wiki/Apollo_11"],
    "title": "Podcast da Apollo 11",
    "mode": "async"
  }' | jq -r '.jobid')

mode: "async" devolve 201 e o jobid na hora. O padrão, mode: "sync", espera até 90 segundos, mas um podcast costuma levar alguns minutos, então ele devolve 202 primeiro e você consulta do mesmo jeito.

Consultar o job e baixar

Consulte GET /jobs/jobid até status virar completed ou failed. O jobid tem : e @, então codifique antes de colocá-lo em um caminho de URL. No job pronto, result.files[].url aponta para GET /artifacts/download, e o download também leva o token da API. Esta função é usada de novo mais adiante:

API=https://api.useapi.net/v1/gemini-notebook
enc() { jq -rn --arg v "$1" '$v|@uri'; }

wait_job() {
  [ -z "$1" ] || [ "$1" = "null" ] && { echo "Falha no envio, veja o error na resposta"; return 1; }
  until curl -s "$API/jobs/$(enc "$1")" -H "Authorization: Bearer $USEAPI_TOKEN" > job.json &&
        jq -e '.status == "completed" or .status == "failed"' job.json > /dev/null; do
    sleep 15
  done
  jq '{status, title: .result.title, duration: .result.duration, error}' job.json
  jq -r '.result.files[]?.url' job.json | while read -r url; do
    curl -s -OJ -H "Authorization: Bearer $USEAPI_TOKEN" "$url"
  done
}

wait_job "$JOBID"

Rodamos esta mesma requisição em 4 de outubro de 2026, em chinês (zh_Hans) e com a página da Wikipédia em chinês: o job terminou em cerca de 6 minutos, o Google gerou um podcast de 99 segundos, e o -OJ salvou o .m4a com o título que o Google deu.

  • Um job que falhou traz error.code, por exemplo quota (uso insuficiente), sources (nenhuma fonte pôde ser usada) ou generation_failed.
  • Para não consultar, passe replyUrl na requisição: quando o job terminar, você recebe um único POST com o registro completo do job.
  • Os arquivos gerados ficam no notebook, e os links de download continuam valendo enquanto o notebook e o resultado existirem.

O fluxo completo: notebook, fontes e geração

Para gerar vários tipos de conteúdo a partir das mesmas fontes, ou para enviar arquivos locais, crie um notebook antes. As fontes podem ser páginas web, vídeos do YouTube, texto colado, arquivos do Google Drive e arquivos enviados, como PDF, Word, PowerPoint, EPUB, áudio e vídeo.

# 1. Criar o notebook
NOTEBOOK=$(curl -s -X POST "$API/notebooks" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Apollo 11"}' | jq -r '.notebook')

# 2. Adicionar uma página web e um vídeo do YouTube
curl -s -X POST "$API/sources" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg nb "$NOTEBOOK" '{
    notebook: $nb,
    urls: ["https://pt.wikipedia.org/wiki/Apollo_11", "https://www.youtube.com/watch?v=xUcYQ7slmRw"]
  }')"

# 3. Enviar um PDF: o próprio arquivo é o corpo da requisição
curl -s -X POST "$API/sources/upload?notebook=$(enc "$NOTEBOOK")&name=report.pdf" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/pdf" \
  --data-binary @report.pdf

# 4. Esperar todas as fontes ficarem prontas
until curl -s "$API/notebooks/$(enc "$NOTEBOOK")" -H "Authorization: Bearer $USEAPI_TOKEN" > notebook.json &&
      jq -e '[.sources[].status] | all(. == "ready" or . == "error")' notebook.json > /dev/null; do
  sleep 10
done

# 5. Gerar um infográfico em português
JOBID=$(curl -s -X POST "$API/artifacts" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg nb "$NOTEBOOK" '{notebook: $nb, type: "infographic", orientation: "portrait", language: "pt_BR", mode: "async"}')" \
  | jq -r '.jobid')

wait_job "$JOBID"

No nosso teste (com saída em chinês), as três fontes ficaram prontas em cerca de 30 segundos, e o infográfico vertical levou cerca de 2 minutos, um png de 1536 × 2752. Troque o type do passo 5 por audio, video ou slides para gerar um podcast, um Video Overview ou slides no mesmo notebook. A demonstração completa em 19 passos (com chat, Deep Research e a revisão de um slide) está no artigo em inglês.

Exemplo em Python

Quase a mesma requisição de uma só chamada (sem length, então com a duração padrão), em Python com requests:

import os, time, requests
from urllib.parse import quote

API = 'https://api.useapi.net/v1/gemini-notebook'
H = {'Authorization': f"Bearer {os.environ['USEAPI_TOKEN']}"}

r = requests.post(f'{API}/artifacts', headers=H, json={
    'type': 'audio',
    'format': 'brief',
    'language': 'pt_BR',
    'urls': ['https://pt.wikipedia.org/wiki/Apollo_11'],
    'mode': 'async',
})
r.raise_for_status()
job = r.json()

while job['status'] in ('pending', 'processing'):
    time.sleep(15)
    r = requests.get(f"{API}/jobs/{quote(job['jobid'], safe='')}", headers=H)
    r.raise_for_status()
    job = r.json()

if job['status'] == 'failed':
    raise SystemExit(job['error'])

print(job['result']['title'], job['result']['duration'], 's')
for f in job['result']['files']:
    with open(f"podcast.{f['format']}", 'wb') as out:
        out.write(requests.get(f['url'], headers=H).content)

Quando rodamos este script em chinês, ele levou cerca de 6 minutos e meio e gerou um podcast.m4a de 70 segundos. Scripts em Node.js e Python que processam uma lista de links estão na pasta podcast/ do repositório de exemplos no GitHub.

Escala: várias contas e limites de taxa

Esta API pode rodar sem ninguém olhando:

  • Com várias contas Google conectadas, cada job novo vai para uma conta saudável, com vaga de job livre e uso suficiente para aquele tipo, sem você precisar acompanhar os orçamentos de 5 horas e semanal.
  • Cada conta roda até maxJobs jobs ao mesmo tempo (padrão 3, de 1 a 10, mude com POST /accounts). GET /jobs mostra os jobs rodando em cada conta.
  • Quando todas as contas estão ocupadas ou sem uso suficiente, a chamada devolve 429. Se o Google informou um horário de renovação, a resposta traz retryAt, e o seu código pode esperar até lá, mandar o próximo lote para outra conta com email, ou diminuir o ritmo.
  • GET /accounts/email devolve o uso da conta ao vivo, os horários de renovação das duas janelas e a estimativa atual para cada tipo de geração.

Automação do Gemini Notebook (NotebookLM): n8n, Colab e assistentes de código com IA

  • Template n8n (em inglês): transforma páginas web, vídeos do YouTube ou o feed RSS de um blog em podcasts do Gemini Notebook, é só importar.
  • Notebook do Google Colab: informe o token e os links no navegador, ouça e baixe o podcast ali mesmo.
  • Assistentes de código com IA, como Claude Code e Codex, podem instalar a skill notebooklm-podcast do repositório e gerar um podcast com uma frase: npx skills add useapi/notebooklm-api --skill notebooklm-podcast.

Tudo isso está no repositório useapi/notebooklm-api.

Exemplos de resultado

Abaixo, resultados reais da mesma Gemini Notebook API. As fontes são a página da Wikipédia em inglês sobre a Apollo 11, um vídeo da NASA no YouTube, um texto colado e um PDF, tirados do artigo em inglês, por isso o conteúdo está em inglês.

Audio Overview, formato brief, duração short, 1 min 31 s de áudio, gerado em 4 min 36 s:

Video Overview, formato explainer, estilo whiteboard, 11 min 50 s no total, aqui os primeiros 90 segundos:

Infográfico vertical, estilo sketch_note, 1536 × 2752, gerado em 1 min 45 s:

Infográfico da Apollo 11 gerado pela Gemini Notebook API

Perguntas frequentes

  • O NotebookLM (Gemini Notebook) tem API oficial? Com a useapi.net, contas comuns têm: a Gemini Notebook API da useapi.net é uma API REST de terceiros que roda na sua própria conta Google, em planos pessoais gratuitos ou pagos, e cobre todas as funções do site por $15 fixos por mês (em outubro de 2026). O Google só oferece API para o Gemini Notebook Enterprise, que exige licenças Enterprise em um projeto Google Cloud e se limita a gerenciar notebooks, adicionar fontes e gerar Audio Overviews, sem acesso para contas Google comuns. A comparação está em Preço.
  • Preciso de uma chave da Gemini API ou da NotebookLM API? Com a useapi.net, não. Você chama a API com o token da API da useapi.net e conecta a conta Google uma vez pelo fluxo automatizado, em poucos minutos, sem projeto no Google Cloud. O Google não emite chave da Gemini Notebook API para contas comuns.
  • Dá para gerar podcast em português? Com a useapi.net, sim. Passe language: "pt_BR" em POST /artifacts, como no exemplo acima. O language vale para áudio, vídeo (exceto cinematic), relatório, relatório interativo, tabela de dados, infográfico e slides, e o padrão é en. Você também pode definir o idioma de saída do Studio para a conta inteira com outputLanguage em POST /accounts.
  • Existe uma Gemini Notebook (NotebookLM) API grátis? Com a useapi.net, a Gemini Notebook API funciona em contas Google gratuitas, o Google não cobra nada do lado dele, e o Google não tem API para contas comuns. A assinatura da useapi.net custa $15 por mês (em outubro de 2026). Pagando pelo Stripe, você recebe reembolso integral em até 14 dias após a primeira compra, se tiver menos de 50 gerações bem-sucedidas, veja a política de reembolso.
  • Funciona com uma conta Google gratuita? Com a useapi.net, sim. O plano gratuito inicia cerca de 2 Audio Overviews por janela de 5 horas (em outubro de 2026), os planos Google AI pagos aumentam os limites, e os vídeos Cinematic exigem um plano pago.
  • Quanto tempo leva para gerar um podcast? Com a useapi.net, um Audio Overview costuma levar de 3 a 6 minutos, um Video Overview 10 minutos ou mais, infográficos e relatórios um ou dois minutos, um quiz cerca de um minuto e meio, e flashcards e tabelas de dados menos de um minuto.
  • NotebookLM e Gemini Notebook são o mesmo produto? Sim. Gemini Notebook é o nome novo do NotebookLM desde julho de 2026, e a API deste artigo é a NotebookLM API.

Mais perguntas e respostas nas perguntas frequentes da Gemini Notebook API (em inglês).

Conclusão

Se tiver dúvidas, fale com a gente no nosso servidor no Discord ou no canal no Telegram.

Todos os endpoints estão na documentação da Gemini Notebook API, e o código de exemplo no repositório no GitHub.