slidespeak

SlideSpeak プレゼンテーションスキル

このスキルを使うと、SlideSpeak API で PowerPoint プレゼンテーションを作成、編集できます。

重要：所要時間について

プレゼンテーションの生成には30～60秒かかります。

オプション1：完了まで待機（デフォルト）

コマンドを実行して、完了まで待ちます。スクリプトは完了するまで内部でポーリングします。

node scripts/slidespeak.mjs generate --text "Topic"

• タスクが終了するまで処理をブロックします（通常は30～60秒）。
• ダウンロード URL を含む完全な結果を返します。

オプション2：--no-wait で即時に戻る

コマンドの完了を待てない場合は、--no-wait を使用します。

node scripts/slidespeak.mjs generate --text "Topic" --no-wait

次の内容がすぐに返されます。

{
  "success": true,
  "data": {
    "task_id": "abc123...",
    "message": "Task started. Check status with: node scripts/slidespeak.mjs status abc123..."
  }
}

その後、完了するまでステータスをポーリングします。

node scripts/slidespeak.mjs status <task_id>

task_status が SUCCESS になったら、request_id を使ってダウンロードします。

タイムアウト時の動作

待機中にスクリプトがタイムアウトした場合、ポーリングを続けられるように task_id を返します。

{
  "success": true,
  "data": {
    "complete": false,
    "task_id": "abc123...",
    "task_status": "STARTED",
    "message": "Task still processing. Check status with: node scripts/slidespeak.mjs status abc123..."
  }
}

セットアップ

SLIDESPEAK_API_KEY 環境変数を設定する必要があります。API キーは https://app.slidespeak.co/settings/developer から取得してください。

クイックリファレンス

すべてのコマンドで scripts/slidespeak.mjs のヘルパースクリプトを使用します。このスクリプトは API 認証を処理し、非同期タスクが完了するまで自動的に待機します（手動でのポーリングは不要です）。

テキストからプレゼンテーションを生成する

node scripts/slidespeak.mjs generate --text "Your topic or content" --length 6

オプション：

• --text（必須）：プレゼンテーションのトピックまたは内容
• --length：スライドの枚数（デフォルト：10）
• --template：テンプレート名または ID（デフォルト："default"）
• --language：出力言語（デフォルト："ORIGINAL"）
• --tone：casual、professional、funny、educational、sales_pitch
• --verbosity：concise、standard、text-heavy
• --no-images：ストック画像の取得を無効にする
• --no-cover：表紙スライドを除外する
• --no-toc：目次を除外する

アップロードしたドキュメントから生成する

まずドキュメントをアップロードしてから、生成します。

# Upload a document (PDF, DOCX, PPTX, etc.)
node scripts/slidespeak.mjs upload /path/to/document.pdf

# Use the returned document_uuid to generate
node scripts/slidespeak.mjs generate --document <document_uuid> --length 10

対応形式：.pdf、.docx、.doc、.pptx、.ppt、.xlsx、.txt、.md

利用可能なテンプレートを一覧表示する

# Default templates
node scripts/slidespeak.mjs templates

# Branded templates (if configured)
node scripts/slidespeak.mjs templates --branded

プレゼンテーションをダウンロードする

生成が完了したら、request_id を使ってダウンロードします。

node scripts/slidespeak.mjs download <request_id>

有効期限の短いダウンロード URL を含む JSON オブジェクトを返します。

既存のプレゼンテーションを編集する

既存のプレゼンテーションのスライドを編集します。

# Insert a new slide at position 2
node scripts/slidespeak.mjs edit-slide \
  --presentation-id <id> \
  --type INSERT \
  --position 2 \
  --prompt "Content about market analysis"

# Regenerate slide at position 3
node scripts/slidespeak.mjs edit-slide \
  --presentation-id <id> \
  --type REGENERATE \
  --position 3 \
  --prompt "Updated content for this slide"

# Remove slide at position 4
node scripts/slidespeak.mjs edit-slide \
  --presentation-id <id> \
  --type REMOVE \
  --position 4

編集タイプ：

• INSERT：指定した位置に新しいスライドを追加します
• REGENERATE：既存のスライドの内容を置き換えます
• REMOVE：スライドを削除します（プロンプトは不要です）

タスクのステータスを確認する

デバッグまたは手動でポーリングする場合に使用します。

node scripts/slidespeak.mjs status <task_id>

アカウント情報を取得する

node scripts/slidespeak.mjs me

スライドごとの生成

各スライドを細かく制御するには、スライドごとのエンドポイントを使用します。スキーマの詳細は references/API.md を参照してください。

node scripts/slidespeak.mjs generate-slides --config slides.json

slides.json の内容は次のとおりです。

{
  "slides": [
    {"title": "Introduction", "layout": "title", "content": "Welcome message"},
    {"title": "Key Points", "layout": "bullets", "item_amount": 4, "content": "Main discussion points"}
  ],
  "template": "default"
}

Webhook

タスク完了時に通知を受け取るには、登録します。

# Subscribe
node scripts/slidespeak.mjs webhook-subscribe --url "https://your-webhook.com/endpoint"

# Unsubscribe
node scripts/slidespeak.mjs webhook-unsubscribe --url "https://your-webhook.com/endpoint"

エラー処理

スクリプトは、次のいずれかを含む JSON を出力します。

• 成功：{"success": true, "data": {...}}
• エラー：{"success": false, "error": "message"}

よくあるワークフロー

トピックについてのプレゼンテーションを作成する

node scripts/slidespeak.mjs generate --text "Introduction to Machine Learning" --length 8 --tone educational

PDF レポートからプレゼンテーションを作成する

# Upload the PDF
RESULT=$(node scripts/slidespeak.mjs upload report.pdf)
DOC_ID=$(echo $RESULT | jq -r '.data.document_uuid')

# Generate presentation
node scripts/slidespeak.mjs generate --document "$DOC_ID" --length 12

新しいスライドを追加するためにプレゼンテーションを編集する

node scripts/slidespeak.mjs edit-slide \
  --presentation-id "abc123" \
  --type INSERT \
  --position 5 \
  --prompt "Add a slide about quarterly revenue growth with charts"

その他のリソース

すべてのパラメーター、レイアウトタイプ、制約を含む API ドキュメントの詳細は、references/API.md を参照してください。