ヘルプと FAQ

よくある質問

API キー

Q: 「API Key not configured」と表示されます

初回利用時に AI が設定手順を案内します。スキップしてしまった場合は、手動で設定してください：

1. ListenHub API キー設定ページ を開く
2. API キーを作成するか、既存のキーをコピーする（lh_sk_ で始まります）
3. 実行する：export LISTENHUB_API_KEY="lh_sk_your_key_here"
4. この行を ~/.zshrc または ~/.bashrc に追加して永続化する

Q: 無料プランでも Skills を使えますか？

使えます。すべてのユーザーが API キー設定ページ で API キーを取得し、Skills を利用できます。

生成

Q: 生成に時間がかかりすぎます

ポッドキャストは通常 2–3 分、解説動画は 3–5 分です。10 分を超える場合は、サーバーが混み合っている可能性があります。いつでも「もうできた？」と尋ねればステータスを確認できますし、再送信もできます。

Q: 生成の品質を上げるには？

いくつかの方向性があります：

• トピックを具体的にする（「AI コーディング」より「AI コーディングにおける 3 つの中核的なパラダイムシフト」のほうが効果的です）
• モードを指定する：deep（長く詳しい）または quick（簡潔）
• リクエストの中で言語を明示的に指定する
• 台本先行ポッドキャスト を使って、音声生成の前に台本を確認する

Q: 自分で書いた台本からポッドキャストを生成できますか？

できます。台本先行ポッドキャスト の第 2 段階の機能で、カスタム台本の JSON を渡して直接音声を生成してください。行ごとにボイスを厳密に割り当てたい場合は、マルチボイス台本 を使ってください。

画像

Q: 参考画像は画像ホスティングにアップロードする必要がありますか？

必要です。参考画像には公開アクセス可能な URL が必要で、ローカルのファイルパスは使えません。無料のおすすめホスティング：imgbb.com、sm.ms、postimages.org。アップロード後に直リンクをコピーしてください（通常は .jpg または .png で終わります）。

Q: 生成された画像はどこに保存されますか？

デフォルトでは ~/Downloads に、listenhub-{date}-{time}-{id}.jpg という名前で保存されます。

ボイス

Q: 利用できるボイスの一覧を見るには？

AI に直接聞いてください — たとえば「英語のボイスは何がありますか？」「ボイス一覧を見せて」など。AI がボイス照会 API を呼び出して、完全な一覧を返します。

Q: 自分でクローンした声を使えますか？

ListenHub プラットフォーム上でボイスクローンが完了していれば、クローンされたボイスは利用可能なボイス一覧に表示され、そのまま使えます。

よくあるエラー

Error: Invalid JSON format

TTS のマルチボイス台本やポッドキャストのカスタム台本を使うときは、JSON の構造が正しいことを確認してください：

{
  "scripts": [
    { "content": "Line content", "speakerId": "voice-id" }
  ]
}

curl: command not found または jq: command not found

Skills は curl と jq に依存します。多くの場合は AI が自動でインストールします。されない場合は手動でインストールしてください：

# macOS
brew install curl jq

# Ubuntu/Debian
sudo apt install curl jq

タスクが長時間「processing」のまま

考えられる原因：サーバー側のキュー、またはネットワークのタイムアウト。次を試してください：

1. 1–2 分待ってから、もう一度ステータスを確認する
2. 10 分を超えても解消しない場合は、生成リクエストを再送信する

一般的なトラブルシューティング

想定外のことが起きたら、まずインストールコマンドを実行し直してください。常に最新版を取得するため、すでに修正が含まれている場合があります：

npx skills add marswaveai/skills

何でも AI に聞く

上記で解決しない場合は、自然言語で質問してください。AI は ListenHub Skills にできることをすべて把握しています：

「ListenHub で何ができる？」

サポートへの問い合わせ

さらにサポートが必要な場合は support@marswave.ai までご連絡ください。