Gemini Notebook API（NotebookLM API）の使い方：curl で日本語ポッドキャスト

Gemini Notebook API（NotebookLM API）で Web ページ、PDF、YouTube 動画を日本語のポッドキャストにする方法

6分で読めます • 2026年10月4日（2026年10月18日更新）

useapi.net はサードパーティの API です。Google とは提携しておらず、Google の承認も受けていません。

はじめに
Gemini Notebook API で作れるもの：ポッドキャスト、動画解説、スライド、インフォグラフィック
Gemini Notebook API（NotebookLM API）の料金
準備
API 呼び出し1回で Gemini Notebook の日本語ポッドキャストを作る
ジョブをポーリングしてダウンロードする
全体の流れ：ノートブック、ソース、生成
Python の例
スケールさせる：複数アカウントとレート制限
Gemini Notebook（NotebookLM）の自動化：n8n、Colab、AI コーディングアシスタント
生成結果の例
よくある質問
おわりに

はじめに

useapi.net の Gemini Notebook API（NotebookLM API）を使うと、REST の呼び出し1回で Web ページや YouTube 動画をご自身の Google アカウントに渡し、Gemini Notebook の音声解説（Audio Overview）のポッドキャストを作って、.m4a ファイルでダウンロードできます。ポッドキャストの言語は日本語にも指定できます。Google Cloud プロジェクトも Gemini API キーも不要で、無料の Google アカウントでも使えます。

Google は NotebookLM の名前を Gemini Notebook に変更しましたが、機能は変わりません。通常の Google アカウントには公式の API がありません。Web 版でできることは、この API ですべてコードから実行できます。ノートブックの作成、ソースの追加、引用付きのチャット、Deep Research、そして Studio のすべての生成機能です。

この記事は useapi.net の運営者が、自社のホスト型 API について書いたものです。サンプルコードは GitHub で公開しています。

Gemini Notebook API で作れるもの：ポッドキャスト、動画解説、スライド、インフォグラフィック

POST /artifacts では、type パラメーターで作るものを選びます。

作るもの	`type`	出力
音声解説（2人のポッドキャスト）	`audio`。`format` は `deep_dive`（デフォルト）、`brief`、`critique`、`debate` から選択	`m4a` 音声
動画解説（Video Overview）	`video`。`format` は `explainer`（デフォルト）、`brief`、`cinematic`、`short` から選択	`mp4` 動画
スライド資料	`slides`	`pdf` と `pptx`
インフォグラフィック	`infographic`	`png` 画像
レポート、インタラクティブレポート、データテーブル	`report`、`interactive_report`、`table`	Markdown テキストまたは表の行
クイズ、フラッシュカード、マインドマップ	`quiz`、`flashcards`、`mindmap`	JSON

音声、動画（cinematic を除く）、レポート、インタラクティブレポート、データテーブル、スライド、インフォグラフィックは、language で出力言語を指定できます。日本語は ja です。

Gemini Notebook API（NotebookLM API）の料金

useapi.net には月 $15 の定額を支払います。同じサブスクリプションで、Gemini Notebook だけでなく useapi.net のすべての API を使えます。サブスクリプション1つにつき Google アカウントを3つ接続でき、合計で最大100アカウントまで増やせます。生成はご自身の Google アカウントで行われ、当社は回数や音声ごとに料金を取りません。Google 側の利用分はアカウントの既存のプランに含まれ、無料プランでも使えます。

	useapi.net Gemini Notebook API	Google の Gemini Notebook Enterprise API
アカウント	ご自身の Google アカウント（無料・有料プランどちらも可）	Google Cloud プロジェクトの Enterprise ライセンス
料金	月 $15 の定額	ユーザーごとに Enterprise ライセンスを購入
引用付きのチャット
Deep Research
音声解説
動画解説、スライド、インフォグラフィック、レポート、クイズ、フラッシュカード、マインドマップ
ステータス	試験的	プレビュー版（Pre-GA）

Google はアカウントごとに利用枠を設けています。利用枠は5時間ごとに回復し、さらに週間の上限もあります。Google 自身の見積もりでは、満タンの5時間の枠で開始できる音声解説は、少なくとも2本（無料プラン）、9本（Google AI Pro）、181本（Google AI Ultra）で、実際に完了すると見積もりより少ない消費で済むことがよくあります。もっと多く作りたい場合は、アカウントを追加で接続します。詳しくはスケールさせるを参照してください。

API を使い始める

月額15ドルのサブスクリプション1つで、useapi.net のすべての API を使えます。トークン1つで、すべてのサービスに対応します。各サービスにご自身のアカウントを最大3つまで接続でき、REST API、負荷分散、ポーリングは useapi.net が担当します。アカウントを増やしたい場合は、サブスクリプションを1つ追加するごとに月額10ドルで、各サービスのアカウントが3つずつ増えます。

登録する — 月額15ドル

海外で使えるクレジットカードがない場合は、暗号資産で登録することもできます（暗号資産での支払いは返金できません）。料金とボリュームプランはサブスクリプションのページをご覧ください。Stripe でお支払いの場合、初回購入から14日以内で、成功した生成が50回未満であれば全額返金されます。すでに登録済みの場合は、新たに購入せず Stripe カスタマーポータルで数量を変更してください。

準備

useapi.net に登録して API トークンを取得します。以下の例では、トークンが環境変数 USEAPI_TOKEN に入っているものとします。
自動化されたブラウザーの手順で Google アカウントを接続します。トークンを入力し、リモートのブラウザーで Google にログインするだけで、Cookie を手動でコピーする必要はありません。個人のメインアカウントではなく、専用の Gmail アカウントを使うことをおすすめします。

以下の単発リクエストとノートブックの新規作成では、email を省略できます。接続しているアカウントが1つならそれが使われ、複数なら API が空いているアカウントを選びます。ノートブックを指定する呼び出しは、常にそのノートブックを持つアカウントで実行されます。

API 呼び出し1回で Gemini Notebook の日本語ポッドキャストを作る

ノートブックを先に作る必要はありません。urls（または貼り付けた text）を POST /artifacts に直接送ると、API がアカウントの1つに新しいノートブックを作り、ソースを追加し、ソースの処理が終わるのを待ってから生成を始めます。youtube.com と youtu.be のリンクは YouTube のソースとして追加され、1回に最大50件のリンクを送れます。

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": "ja",
    "urls": ["https://ja.wikipedia.org/wiki/アポロ11号"],
    "title": "アポロ11号のポッドキャスト",
    "mode": "async"
  }' | jq -r '.jobid')

mode: "async" はすぐに 201 と jobid を返します。デフォルトの mode: "sync" は最大90秒待ちますが、ポッドキャストには通常数分かかるので、まず 202 が返り、その後は同じようにポーリングが必要です。

ジョブをポーリングしてダウンロードする

GET /jobs/jobid を、status が completed か failed になるまで呼びます。jobid には : と @ が含まれるので、URL パスに入れる前にエンコードします。完了後の result.files[].url は GET /artifacts/download を指しており、ダウンロードにも API トークンが必要です。次の関数は、このあとも使います。

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

wait_job() {
  [ -z "$1" ] || [ "$1" = "null" ] && { echo "送信に失敗しました。応答の error を確認してください"; 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"

2026年10月4日に、同じリクエストを中国語（zh_Hans）と中国語版 Wikipedia のページで実行しました。約6分でジョブが完了し、Google は99秒のポッドキャストを作りました。-OJ は、Google が付けたタイトルでファイルを .m4a として保存します。

失敗したジョブには error.code が付きます。たとえば quota（利用枠の不足）、sources（使えるソースがない）、generation_failed です。
ポーリングしたくない場合は、リクエストに replyUrl を渡します。ジョブが終わると、ジョブの記録全体が1回 POST されます。
生成したファイルはノートブックに残り、ダウンロードリンクはノートブックと生成結果が残っている限り有効です。

全体の流れ：ノートブック、ソース、生成

同じソースから複数の種類を作りたいときや、ローカルのファイルをアップロードしたいときは、先にノートブックを作ります。ソースには、Web ページ、YouTube 動画、貼り付けたテキスト、Google ドライブのファイル、アップロードした PDF、Word、PowerPoint、EPUB、音声、動画などのファイルを使えます。

# 1. ノートブックを新規作成
NOTEBOOK=$(curl -s -X POST "$API/notebooks" \
  -H "Authorization: Bearer $USEAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "アポロ11号"}' | jq -r '.notebook')

# 2. Web ページと 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://ja.wikipedia.org/wiki/アポロ11号", "https://www.youtube.com/watch?v=xUcYQ7slmRw"]
  }')"

# 3. PDF をアップロード（ファイル自体がリクエストボディ）
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. すべてのソースの処理が終わるまで待つ
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. 日本語のインフォグラフィックを生成
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: "ja", mode: "async"}')" \
  | jq -r '.jobid')

wait_job "$JOBID"

中国語で実行した実測では、3つのソースは約30秒ですべて準備でき、縦長のインフォグラフィックは約2分で生成され、1536 × 2752 の png になりました。ステップ5の type を audio、video、slides に変えれば、同じノートブックでポッドキャスト、動画解説、スライドも続けて作れます。チャット、Deep Research、スライドの1ページだけの修正を含む19ステップの完全なデモは、英語のチュートリアルにあります。

Python の例

上の単発リクエストとほぼ同じ内容（length は指定せず、デフォルトの長さ）を、Python と 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': 'ja',
    'urls': ['https://ja.wikipedia.org/wiki/アポロ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'], '秒')
for f in job['result']['files']:
    with open(f"podcast.{f['format']}", 'wb') as out:
        out.write(requests.get(f['url'], headers=H).content)

このスクリプトを中国語で実行したときは約6分半で終わり、70秒のポッドキャスト podcast.m4a ができました。リンクのリストを一括処理する Node.js と Python のスクリプトは、GitHub のサンプルリポジトリの podcast/ フォルダーにあります。

スケールさせる：複数アカウントとレート制限

この API は無人で動かせます。

複数の Google アカウントを接続すると、新しいジョブはそれぞれ、状態が正常で、空いているジョブ枠があり、その種類の利用枠が残っているアカウントに割り当てられます。5時間と週間の利用枠を自分で見張る必要はありません。
各アカウントで同時に実行できるジョブは最大 maxJobs 件です（デフォルトは3、1〜10に設定でき、POST /accounts で変更します）。GET /jobs で、各アカウントで実行中のジョブを確認できます。
すべてのアカウントが使用中か、利用枠が足りないときは 429 が返ります。Google がリセット時刻を示した場合は応答に retryAt が入るので、コードでその時刻まで待って再試行するか、email で次のバッチを別のアカウントに送るか、頻度を下げます。
GET /accounts/email は、アカウントのリアルタイムの利用状況、2つの枠のリセット時刻、生成の種類ごとの現在の見積もりを返します。

Gemini Notebook（NotebookLM）の自動化：n8n、Colab、AI コーディングアシスタント

n8n テンプレート（英語）：Web ページ、YouTube 動画、ブログの RSS フィードを Gemini Notebook のポッドキャストにします。インポートするだけで使えます。
Google Colab ノートブック：ブラウザーでトークンとリンクを入力し、ポッドキャストをその場で再生してダウンロードできます。
Claude Code や Codex などの AI コーディングアシスタントは、リポジトリの notebooklm-podcast スキルをインストールすれば、1文でポッドキャストを作れます：npx skills add useapi/notebooklm-api --skill notebooklm-podcast。

これらはすべて useapi/notebooklm-api リポジトリにあります。

生成結果の例

以下は、同じ Gemini Notebook API で作った実際の結果です。ソースは Apollo 11 の英語版 Wikipedia ページ、NASA の YouTube 動画、貼り付けたテキスト、PDF 1つです。英語のチュートリアルから転載しているため、内容は英語です。

音声解説、brief 形式、short の長さ、長さ1分31秒、生成時間4分36秒：

動画解説、explainer 形式、whiteboard スタイル、全体の長さ11分50秒のうち最初の90秒：

インフォグラフィック、縦長、sketch_note スタイル、1536 × 2752、生成時間1分45秒：

よくある質問

Gemini Notebook（NotebookLM）に公式の API はありますか？ useapi.net を使えば、通常のアカウントで使えます。useapi.net の Gemini Notebook API は、ご自身の Google アカウントを動かすサードパーティの REST API で、無料と有料の個人プランのどちらでも使え、Web 版のすべての機能をカバーし、料金は月 $15 の定額です（2026年10月時点）。Google が API を提供しているのは Gemini Notebook Enterprise だけで、Google Cloud プロジェクトで Enterprise ライセンスを購入する必要があり、できるのはノートブックの管理、ソースの追加、音声解説の生成に限られます。通常の Google アカウントでは使えません。比較は料金を参照してください。
Gemini API キーや NotebookLM の API キーは必要ですか？ useapi.net を使えば、不要です。月 $15 の定額（2026年10月時点）の useapi.net の API トークンで API を呼び出し、自動化された手順で Google アカウントを一度接続するだけで、Google Cloud プロジェクトも要りません。Google は通常のアカウントには Gemini Notebook の API キーを発行していません。
日本語のポッドキャストに対応していますか？ useapi.net を使えば、対応しています。POST /artifacts で language: "ja" を渡します（上の例を参照）。language は、音声、動画（cinematic を除く）、レポート、インタラクティブレポート、データテーブル、インフォグラフィック、スライドに使え、デフォルトは en です（2026年10月時点）。POST /accounts の outputLanguage で、アカウント全体の Studio の出力言語を設定することもできます。
Gemini Notebook（NotebookLM）を無料で使える API はありますか？ useapi.net を使えば、Gemini Notebook API は無料の Google アカウントで使え、Google 側の料金はかかりません。Google には通常のアカウント向けの API がありません。useapi.net のサブスクリプションは月 $15 です（2026年10月時点）。Stripe で支払った場合、初回購入から14日以内で、成功した生成が50回未満なら全額返金されます。返金ポリシーを参照してください。
無料の Google アカウントで使えますか？ useapi.net を使えば、使えます。無料プランでは、5時間の枠ごとに音声解説を約2本開始できます（2026年10月時点）。有料の Google AI プランでは上限が上がり、シネマティックな動画には有料プランが必要です。
ポッドキャスト1本の生成にどのくらいかかりますか？ useapi.net を使えば、音声解説は通常3〜6分、動画解説は10分以上、インフォグラフィックとレポートは1〜2分、クイズは約1分半、フラッシュカードとデータテーブルは1分未満です。
NotebookLM と Gemini Notebook は同じ製品ですか？ はい。Gemini Notebook は、2026年7月からの NotebookLM の新しい名前です。この記事の API は NotebookLM API と同じものです。