スライド
slides モード — プレゼンテーション用レイアウト、ナレーション原稿、そして PPT の書き出しが API にない理由。
slides は、共通の storybook エンドポイントにある 3 つ目のモードです。AI によるビジュアルとナレーション原稿を
備えたプレゼンテーション形式のページを生成し、会議のプレゼン、ビジネスレポート、カンファレンス講演に適して
います。エンドポイント、リクエストパラメータ、ポーリング、ステータス、動画のレンダリング手順については、
解説動画とスライドの概要 を参照してください。本ページでは、
slides に固有の内容だけを扱います。
POST /v1/storybook/episodes で mode: "slides" を指定します。このフィールドはエンドポイント上では任意ですが
— 省略すると slides ではなく info になるため — このモードでは実質的に必須です。slides モードが何を描くかは
概要ページのモード表 にまとめられています。
PPT ファイルを取得する
PPT の書き出しは OpenAPI では利用できません。API が返すのは各スライドの画像とそのナレーション原稿です。
編集可能な .pptx として書き出すには、ListenHub プラットフォームでそのエピソードを開いてください。
動画なしでページを利用する
slides は、素材そのものが成果物になることが最も多いモードです。pages[] の各要素にはスライド画像
（imageUrl）とそのナレーション原稿（text）が含まれており、スピーカーノートとして利用できるため、自分の
ツールでデッキを組み立て、動画のレンダリングを完全に省略できます。
ナレーション音声がまったく不要な場合は、作成時に skipAudio: true を併用してください — 画像と原稿はその
まま返り、speakers は任意になります。
例
ナレーション付きのスライド：
curl -X POST "https://api.marswave.ai/openapi/v1/storybook/episodes" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sources": [
{"type": "text", "content": "Q3 results: revenue, retention and the two bets for Q4..."}
],
"speakers": [{"speakerId": "<SPEAKER_ID>"}],
"language": "en",
"mode": "slides"
}'スライド画像と原稿だけ — speakers なし、音声レンダリングなし：
curl -X POST "https://api.marswave.ai/openapi/v1/storybook/episodes" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sources": [
{"type": "url", "content": "https://example.com/quarterly-report"}
],
"language": "zh",
"mode": "slides",
"skipAudio": true
}'返された episodeId をポーリングし、必要に応じて動画をレンダリングしてください —
ワークフロー を参照してください。