Gemini Notebook / NotebookLM: podcast, Video Overview, slides (useapi.net)
Turn web pages, YouTube videos, pasted text or local files (PDF, Word, PowerPoint, EPUB, audio) into a Gemini Notebook (NotebookLM) Audio Overview podcast (.m4a), Video Overview (.mp4) or slide deck (.pdf and .pptx) on your own Google account, through the useapi.net Gemini Notebook API (NotebookLM API), a third-party paid API not affiliated with Google. Google renamed NotebookLM to Gemini Notebook. Use when the user asks for a NotebookLM or Gemini Notebook podcast, Audio Overview, Video Overview, explainer video or slides, or to turn articles or documents into a podcast or deck. Needs bash, curl, jq and USEAPI_TOKEN.
Gemini Notebook (NotebookLM): podcasts, Video Overviews and slides with the useapi.net API
These scripts call the useapi.net Gemini Notebook API (NotebookLM API), a third-party REST API (not affiliated with Google) that runs Gemini Notebook (NotebookLM) on the user's own Google account. Every script is in {baseDir}/scripts/ ({baseDir} is this skill's folder). Run them with bash.
What the user needs (tell them if something is missing)
A Google account connected to useapi.net once, on the useapi.net side: https://useapi.net/docs/start-here/setup-gemini-notebook. The setup guide recommends a dedicated Gmail account for this, not the user's personal one. The free Google plan works; cinematic Video Overviews need Google AI Pro or Ultra.
bash, curl and jq installed.
USEAPI_EMAIL is optional: if the user connected more than one Google account, it names the one to use.
This skill does not sign in to Google, read browser cookies or use Google OAuth tokens on the user's machine. It only sends HTTPS requests to api.useapi.net with the useapi.net token. Nothing runs locally besides curl, so a job keeps going on the server if the agent stops.
Fastest path: one command
bash
bash {baseDir}/scripts/studio.sh audio|video|slides "<title>" <URL or local file> [more ...] [-- key=value ...]
It creates a notebook, adds the sources (existing local files are uploaded, everything else is added as a URL), waits until Google has read them, generates, waits and downloads. It prints progress on stderr and the saved paths on stdout (OUT_DIR sets the folder).
bash
# A podcast (Audio Overview), short brief
bash {baseDir}/scripts/studio.sh audio "Apollo 11" https://en.wikipedia.org/wiki/Apollo_11 ./notes.pdf -- format=brief length=short
# A Video Overview in the whiteboard style
bash {baseDir}/scripts/studio.sh video "Apollo 11" https://en.wikipedia.org/wiki/Apollo_11 -- format=explainer style=whiteboard
# A slide deck (saves .pdf and .pptx)
bash {baseDir}/scripts/studio.sh slides "Q3 report" ./q3-report.pdf -- format=presenter length=short
podcast.sh "<title>" ... is the same as studio.sh audio "<title>" ....
Typical times: a short podcast about 3 to 10 minutes, slides about 7, a Video Overview 10 minutes or more. Run it in the background or with a timeout of at least 15 minutes (30 for video). Tell the user it is running and wait; do not start a second copy.
style (explainer and brief only): auto, classic, whiteboard, heritage, paper_craft, watercolor, anime, retro_print, kawaii, or custom with stylePrompt="..."; language, instructions (not cinematic). cinematic takes no style, language or instructions, and needs Google AI Pro or Ultra
Wait until Google has processed every source (polls every 10 s, gives up after 10 minutes). A YouTube video without captions ends as error and is skipped.
bash
bash {baseDir}/scripts/wait-sources.sh "$NB"
Start a generation. It prints the job id (and logs it on stderr). Run it again on the same notebook for more outputs.
bash
Download the file(s). Prints the saved paths:
bash
bash {baseDir}/scripts/download.sh job.json ./out
Timeouts and resuming
If a run is interrupted after the generation started, do not run it again: that spends the user's Gemini Notebook usage twice. generate.sh logs the job id on stderr (job job:...). Resume with it:
HTTP 429 from generate.sh: the account is busy (maxJobs jobs already running) or Google's usage window is used up. retryAt in the body says when it resets. Tell the user and retry then. Do not loop on it.
HTTP 409 from generate.sh: no source is ready yet. Run wait-sources.sh first.
A failed job prints its error. A job still running after 40 minutes is failed by the API with timeout.
After it finishes
Tell the user the file path(s) and the title (result.title in job.json; audio and video also carry result.duration in seconds). The notebook stays in their Gemini Notebook (NotebookLM) account, so they can open it there or generate more from it with generate.sh "$NB" ....
About
Third-party service by useapi.net, not affiliated with or endorsed by Google. Gemini Notebook and NotebookLM are Google's names for its product.