クックブック / 電子書籍からオーディオブック
EPUBを
オーディオブックに

スクリーンショット. ローカルで動かしたテンプレート。
- モデル
- sonic-3.6
- 言語
- 初期設定は英語。ほかの言語は--languageで指定
- ライセンス
- MIT
- 技術スタック
- PythonGradioEbookLibffmpeguv
- Cartesia の製品
- Sonic 3.6
できること
コマンドラインツールとWebアプリは、同じ変換を実行します。このプロジェクトは、p0n1によるオープンソースのepub_to_audiobookのフォークです。
同梱の読み上げ用ページでは、再生に合わせて単語が1つずつ強調され、単語をクリックするとその位置に移動します。字幕ファイルは、たいていのプレーヤーで使えます。
自分で動かす
キーなしでプレビューする
下のコマンドを実行します。Python 3.10から3.12と、インストール済みのuvとffmpegが必要です。
--previewでの実行は音声を作らず、キーも要りません。サンプルの本を章に分け、15,065文字(約15,000クレジット)と数え、登場人物ごとに選んだ声を記したout/cast.jsonを書き出します。環境変数 - CARTESIA_API_KEY
play.cartesia.ai/keys。--previewでは不要
音声を作る
.env.exampleを新しい.envファイルにコピーします。そこにCARTESIA_API_KEYを追加します。set -a; ../.env; set +aでシェルに読み込みます。そのあと--previewを外して同じコマンドを実行します。スクリプトから実行するときは、-yを付けると料金の確認を省略できます。Webアプリを使う
uv run python main_ui.pyを実行します。次にhttp://127.0.0.1:7860を開きます。そのシェルでCARTESIA_API_KEYを設定しておく必要があります。ホストは初期設定のローカルのままにしてください。アプリにはログインがなく、アクセスできる人なら誰でもあなたのクレジットを使えてしまいます。文字を追いながら聞く
プロジェクトの
readalong.htmlをブラウザーで開きます。章のMP3を選び、次にその隣にある.timings.jsonファイルを選びます。再生に合わせて今の単語が光ります。
コーディングエージェントで作る
どこから始めて、最初に何を読むべきかをコーディングエージェントに伝えるプロンプトです。
Convert an EPUB into an audiobook with Cartesia. Start from https:/ and follow its AGENTS.md for the commands, files and rules. It uses the cartesia Python SDK to stream sonic-3.6 from /tts/sse with add_timestamps and use_normalized_timestamps=False, joins the raw PCM with ffmpeg into one MP3 per chapter, and writes .timings.json and .vtt files for read-along. Run a --preview first, which needs no key, to check the character count and out/cast.json. If I don't have a Cartesia API key yet, follow https:/ to get one.
仕組み
/tts/sseをストリーミング。1リクエスト最大1,500文字timings.jsonと.vttファイルこの設計にした理由
単語ごとのタイミングはストリーミングで得る
Cartesiaの通常の音声合成エンドポイントは、音声しか返しません。文字を追うためのファイルには各単語の時刻が必要で、それを返すのはストリーミングのエンドポイントだけです。アプリはuse_normalized_timestamps=Falseも設定し、$5のような単語を書かれたとおりに残すので、強調表示が本の文と一致します。
音声はどの章よりも先に決まる
配役は変換を始める前に一度だけ決めるので、並列の処理や再実行でも、どの登場人物をどの声が読むかが変わりません。「とアリスは言った」のような話し手の表示がないせりふは、直前の話し手に割り当てます。ただし、2人が続けて段落ごとにせりふを交わしている場合は、もう一方の人物に割り当てます。
会話の手がかりで感情を決める
英語の会話では、せりふの隣にwhispered、shouted、sobbedのような言葉があると、Sonicはそのせりふを穏やかに、怒って、悲しげに読みます。laughedがあると、せりふの前に笑い声が入ります。
カスタマイズする
音声を選ぶ
out/cast.jsonを編集して、もう一度実行します。配役を使い回すには、--cast_fileで自分のファイルを渡します。値には、Archieのような組み込みの声の名前を使えます。play.cartesia.ai/voicesにある任意の音声IDも使えます。
音声を1つにする
--cast_mode narratorで実行すると、会話も含めて本全体を1つの声で読みます。その声は--voice_nameで選びます。
別の言語の本を変換する
--language frなど、Sonicの言語コードを渡します。登場人物ごとの声はそのまま使えます。感情や笑いの指定は英語でしか働きません。
よくある質問
本1冊を変換する料金はいくらですか?
Sonicの料金は1文字あたり約1クレジットで、段落の間の無音はローカルで無料で追加します。まず--previewで実行して文字数を確認してください。1クレジットの値段はプランによって違うので、ツールは金額を表示しません。
登場人物ごとに正しい声が付きますか?
「とアリスは言った」のように話し手を示す本なら、たいていは付きます。暗に示されているだけの話し手は見落とし、表示のない2人のやり取りは入れ替わることがあります。プレビューの後で配役ファイルを確認して直すか、本全体を1つの声で読んでください。
Audiobookshelfのようなオーディオブックアプリで聞けますか?
はい。どのMP3にもタイトル、著者、アルバム、トラックのタグが付いているので、Audiobookshelfなどのサーバーが章を1冊の本にまとめます。
どんな本でも変換できますか?
変換するのは、自分が所有する本か、権利を持つ本だけにしてください。公開する出力にはAI生成の音声であることを明記します。テスト用に、パブリックドメインの『不思議の国のアリス』から2章を同梱しています。
このテンプレートの詳しい手順ガイドはありますか?
はい。レシピでコードを順に解説しています。セットアップ、環境変数、デプロイはREADMEに、Cartesia側の仕様はTTS over server-sent eventsリファレンスにまとめています。
クックブックのほかの例
今すぐ始める
専門家に相談する。
音声体験の開発にCartesiaをどう活用できるか、私たちのチームにご相談ください。
開発を始める。
APIでモデルにアクセスし、数分で音声エージェントを本番環境に導入できます。

