OAuth コマンド

listenhub の OAuth コマンド（auth、podcast、tts、explainer、slides、music、image、video、speakers、lyrics、creation）の完全リファレンス。

本ページでは OAuth コマンド群、つまりサインインしたユーザーアカウントとして動作する listenhub <domain> ... コマンドを解説します。これらはブラウザでのログイン（listenhub auth login）を必要とし、トークンを ~/.config/listenhub/credentials.json から読み取ります。スクリプトや CI で使う API キー版のコマンド群は OpenAPI コマンドを参照してください。

共通仕様

以下の挙動は、このページのすべてのコマンドに共通します。

グローバルフラグ。 すべてのコマンドが --json / -j（機械可読な出力を stdout に、エラーを stderr に）と --help / -h を受け付けます。作成系のコマンドはさらに --no-wait（ポーリングせずに ID を即座に返す）と --timeout <seconds>（ポーリングの待機時間の上限。デフォルトはコマンドごとに異なります）も受け付けます。
ポーリング。 作成系のコマンドはジョブを送信したあと、終了状態に達するまで 10 秒ごとにステータスをポーリングします。タイムアウトするとコマンドは終了コード 3 で終了します。ジョブはサーバー側で動き続けるため、後から ID で取得できます。
言語の自動判定。 --lang を持つコマンドでそれを省略すると、CLI は入力テキストから言語を推測します。かな → ja、それ以外の CJK 文字 → zh、それ以外は en です。
スピーカーの解決。 --speaker <name> は、判定された言語のスピーカーを一覧して inner ID に解決されます。--speaker-id <id> はそのまま渡されます。どちらも指定しない場合、CLI は判定された言語のデフォルトの声を選びます。
ファイルと URL の自動判別。 <path-or-url> を受け付けるフラグは入力を自動判別します。http(s) の URL はそのまま渡され、ローカルパスは拡張子とサイズを検証したうえで、API 呼び出しの前にクラウドストレージへアップロードされます。アップロードに対応する形式は、音声が .mp3、.wav、.flac、.m4a、.ogg、.aac（最大 20 MB）、画像が .jpg、.jpeg、.png、.webp、.gif（最大 10 MB）、動画が .mp4、.mov（最大 50 MB）です。一部の Mureka 系 music サブコマンドはローカルファイルのみ（URL 不可）を受け付け、独自の上限があります。詳細は各コマンドの説明を参照してください。
終了コード。 0 成功、1 エラー、2 認証が必要または無効、3 タイムアウト。

生成にはクレジットを消費します。OAuth コマンド群には video estimate を除いてコマンドごとのクレジット見積もり機能はありません。生成する前に listenhub openapi subscription で残高を確認し、動画のコストは listenhub openapi video estimate（または listenhub video estimate）で確認してください。固定のコストを前提にせず、必ず照会してください。

auth

ログインセッションを管理します。

listenhub auth login
listenhub auth logout
listenhub auth status [-j]

コマンド	説明
`login`	ブラウザを開いて OAuth を完了します。成功すると、トークンを `~/.config/listenhub/credentials.json`（モード `0600`）に書き込みます。トークンは自動で更新されます。
`logout`	トークンを失効させ、保存された認証情報を削除します。
`status`	現在のログイン状態を表示します。`-j` を受け付けます。

listenhub auth login
listenhub auth status

podcast

トピックや参照ソースからポッドキャストのエピソードを生成します。

listenhub podcast create [options]
listenhub podcast list [options]

podcast create

フラグ	値	デフォルト	意味
`--query <text>`	文字列	—	エピソードのトピックまたはプロンプト。
`--source-url <url>`	URL（繰り返し可）	`[]`	エピソードの根拠となる参照 URL。複数指定する場合は繰り返します。
`--source-text <text>`	文字列（繰り返し可）	`[]`	エピソードの根拠となる参照テキスト。複数指定する場合は繰り返します。
`--mode <mode>`	`quick`、`deep`、`debate`	`quick`	生成モード。
`--lang <lang>`	`en`、`zh`、`ja`	自動	出力言語。省略時は `--query` から自動判定。
`--speaker <name>`	文字列（繰り返し可）	—	名前でスピーカーを指定。1 人なら単独エピソード、2 人以上ならマルチボイス。
`--speaker-id <id>`	文字列（繰り返し可）	—	inner ID でスピーカーを指定。`--speaker` の代わりに使います。
`--no-wait`	フラグ	ポーリング	ポーリングせずにエピソード ID を即座に返します。
`--timeout <seconds>`	数値	`300`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub podcast create --query "AI agent trends in 2026" --mode quick

podcast list

フラグ	値	デフォルト	意味
`--page <n>`	数値	`1`	ページ番号。
`--page-size <n>`	数値	`20`	1 ページあたりの件数。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub podcast list --page 1 --page-size 20

tts

1 つの声でテキストを音声に変換します。

listenhub tts create [options]
listenhub tts list [options]

tts create

フラグ	値	デフォルト	意味
`--text <text>`	文字列	—	音声に変換するテキスト。
`--source-url <url>`	URL（繰り返し可）	`[]`	参照 URL。複数指定する場合は繰り返します。
`--source-text <text>`	文字列（繰り返し可）	`[]`	参照テキスト。複数指定する場合は繰り返します。
`--mode <mode>`	`smart`、`direct`	`smart`	`smart` は読み上げ向けに入力を書き換え、`direct` はそのまま読み上げます。
`--lang <lang>`	`en`、`zh`、`ja`	自動	出力言語。省略時は `--text` から自動判定。
`--speaker <name>`	文字列	—	名前でスピーカーを指定。
`--speaker-id <id>`	文字列	—	inner ID でスピーカーを指定。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`300`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub tts create --text "Hello, world" --lang en

tts list

フラグ	値	デフォルト	意味
`--page <n>`	数値	`1`	ページ番号。
`--page-size <n>`	数値	`20`	1 ページあたりの件数。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub tts list

voice-clone

ログイン中のアカウントで、参考音声から自分の声をクローンし、そこで生成されたプライベート音声を管理します。アップロードモードのみ対応で、対話的な録音フローは Web アプリ側にあります。対応言語は zh と en です。

クローンの確定は、プランの期間ごとのクォータ内であれば無料です。それを超えると 1 回の確定につき 300 クレジットかかり、--use-credits を渡したときにのみ実行されます。

コマンド	説明
`voice-clone create`	1–6 個の参考音声ファイルをアップロードし、クローンタスクを作成します。
`voice-clone get <taskId>`	タスクのステータスを取得します。
`voice-clone confirm`	完了したタスクをプライベート音声として確定します。
`voice-clone speakers`	プライベート音声を、クォータと残りの確定回数とあわせて一覧します。
`voice-clone speaker <speakerId>`	プライベート音声を 1 件取得します。
`voice-clone update <speakerId>`	音声の名前を変更する、または性別を変更します。
`voice-clone delete <speakerId>`	音声を削除し、枠を 1 つ解放します。

voice-clone create のオプション：

オプション	デフォルト	説明
`--file <path...>`	必須	1–6 個のローカル参考音声ファイル。
`--lang <lang>`	必須	`zh` または `en`。
`--no-wait`、`--timeout <seconds>`（`600`）、`--json`	—	標準の非同期フラグ。

voice-clone confirm は --task-id <id>、--name <name>（最大 50 文字）、--gender <male\|female\|other>、および任意の --use-credits を受け付けます。voice-clone update <speakerId> は --name と --gender のいずれか（少なくとも 1 つ）を受け付けます。

# Clone, then confirm what you heard
listenhub voice-clone create --file ./reference.mp3 --lang en
listenhub voice-clone confirm \
  --task-id 6915bde9cca4d3c8ecb3eaf5 --name "My Voice" --gender female

# The speaker ID from `speakers` works anywhere a voice is expected
listenhub voice-clone speakers
listenhub tts create --text "Hello from my own voice." --speaker-id voice-clone-6915bde9cca4d3c8ecb3eaf5

explainer

解説動画（ナレーション付きのビジュアルセグメント）を生成します。

listenhub explainer create [options]
listenhub explainer list [options]

explainer create

音声ナレーションはデフォルトで有効です。--skip-audio を渡すと無音の動画を生成します。

フラグ	値	デフォルト	意味
`--query <text>`	文字列	—	トピックまたはプロンプト。
`--source-url <url>`	URL（繰り返し可）	`[]`	参照 URL。複数指定する場合は繰り返します。
`--source-text <text>`	文字列（繰り返し可）	`[]`	参照テキスト。複数指定する場合は繰り返します。
`--mode <mode>`	`info`、`story`	`info`	生成モード。
`--lang <lang>`	`en`、`zh`、`ja`	自動	出力言語。省略時は `--query` から自動判定。
`--speaker <name>`	文字列	—	名前でスピーカーを指定。
`--speaker-id <id>`	文字列	—	inner ID でスピーカーを指定。
`--skip-audio`	フラグ	`false`	音声ナレーションをスキップします（無音の動画）。
`--image-size <size>`	`2K`、`4K`	`2K`	レンダリングする画像の解像度。
`--aspect-ratio <ratio>`	`16:9`、`9:16`、`1:1`	`16:9`	画面のアスペクト比。
`--style <style>`	文字列	—	ビジュアルスタイルのヒント。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`300`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub explainer create --query "How vaccines work" --mode info --aspect-ratio 16:9

explainer list

フラグ	値	デフォルト	意味
`--page <n>`	数値	`1`	ページ番号。
`--page-size <n>`	数値	`20`	1 ページあたりの件数。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub explainer list

slides

トピックやソースからスライドを生成します。

listenhub slides create [options]
listenhub slides list [options]

slides create

スライドはデフォルトで無音です。--no-skip-audio を渡すと音声ナレーションを追加します。

フラグ	値	デフォルト	意味
`--query <text>`	文字列	—	トピックまたはプロンプト。
`--source-url <url>`	URL（繰り返し可）	`[]`	参照 URL。複数指定する場合は繰り返します。
`--source-text <text>`	文字列（繰り返し可）	`[]`	参照テキスト。複数指定する場合は繰り返します。
`--lang <lang>`	`en`、`zh`、`ja`	自動	出力言語。省略時は `--query` から自動判定。
`--speaker <name>`	文字列	—	名前でスピーカーを指定（ナレーションを有効にした場合に使われます）。
`--speaker-id <id>`	文字列	—	inner ID でスピーカーを指定。
`--no-skip-audio`	フラグ	無音	音声ナレーションを生成します（デフォルトはオフ）。
`--image-size <size>`	`2K`、`4K`	`2K`	レンダリングする画像の解像度。
`--aspect-ratio <ratio>`	`16:9`、`9:16`、`1:1`	`16:9`	スライドのアスペクト比。
`--style <style>`	文字列	—	ビジュアルスタイルのヒント。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`300`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub slides create --query "Q3 product roadmap" --no-skip-audio

slides list

フラグ	値	デフォルト	意味
`--page <n>`	数値	`1`	ページ番号。
`--page-size <n>`	数値	`20`	1 ページあたりの件数。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub slides list

music

音楽を生成、変換、分析します。生成系のサブコマンドはポーリングします（デフォルトのタイムアウトは 600）。分析系のサブコマンド（recognize、describe、stem）は同期実行で、すぐに結果を出力します。Mureka と記載のあるサブコマンドは、参照入力にローカルファイルのみを受け付けます（URL のパススルーは不可）。

listenhub music generate [options]
listenhub music cover --audio <path-or-url> [options]
listenhub music extend --audio <path-or-url> --model <v> --continue-at <s> [options]
listenhub music remix [audio] [options]
listenhub music instrumental [options]
listenhub music soundtrack [options]
listenhub music track [audio] [options]
listenhub music recognize --audio <path> [-j]
listenhub music describe --audio <path> [-j]
listenhub music stem --audio <path> [options]
listenhub music list [options]
listenhub music get <taskId> [-j]

music generate

テキストプロンプトから音楽を生成します。

フラグ	値	デフォルト	意味
`--prompt <text>`	文字列（必須）	—	音楽の説明。
`--style <text>`	文字列	—	スタイルまたはムード。
`--title <text>`	文字列	—	トラックのタイトル。
`--instrumental`	フラグ	`false`	ボーカルなしのインストゥルメンタルのみ。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`600`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music generate --prompt "Upbeat electronic dance" --style "EDM" --title "Night Drive"

music cover

参考音声からカバーを作成します。--audio はローカルファイルまたは URL を受け付けます。

フラグ	値	デフォルト	意味
`--audio <path-or-url>`	パスまたは URL（必須）	—	参考音声。
`--prompt <text>`	文字列	—	音楽の説明。
`--style <text>`	文字列	—	スタイルまたはムード。
`--title <text>`	文字列	—	トラックのタイトル。
`--instrumental`	フラグ	`false`	ボーカルなしのインストゥルメンタルのみ。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`600`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music cover --audio ./original.mp3 --title "My Remix"

music extend

参考音声をもとに、指定した時点から続きを生成して曲を延長します。--audio はローカルファイルまたは URL を受け付けます。

フラグ	値	デフォルト	意味
`--audio <path-or-url>`	パスまたは URL（必須）	—	参考音声。
`--model <version>`	`V4`、`V4_5`、`V4_5PLUS`、`V4_5ALL`、`V5`、`V5_5`（必須）	—	モデルのバージョン。
`--continue-at <seconds>`	数値（必須）	—	延長を開始する時点。
`--prompt <text>`	文字列	—	歌詞または説明。
`--style <text>`	文字列	—	スタイルまたはムード。
`--title <text>`	文字列	—	トラックのタイトル。
`--instrumental`	フラグ	`false`	ボーカルなしのインストゥルメンタルのみ。
`--negative-tags <text>`	文字列	—	除外するスタイル。
`--vocal-gender <gender>`	`m`、`f`	—	ボーカルの性別。
`--style-weight <weight>`	数値 `0`–`1`	—	スタイルの反映度。
`--weirdness <weight>`	数値 `0`–`1`	—	創造性・奇抜さの制約。
`--audio-weight <weight>`	数値 `0`–`1`	—	入力音声の影響度。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`600`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music extend --audio ./song.mp3 --model V5 --continue-at 30

music remix

既存の曲を新しい歌詞でリミックスします（Mureka）。ソースはちょうど 1 つ指定します。位置引数 [audio] のローカルファイル（.mp3/.m4a、最大 10 MB）、--audio-url、--provider-song-id のいずれかです。

フラグ	値	デフォルト	意味
`[audio]`	ローカルファイル	—	参考音声ファイル（位置引数）。
`--audio-url <url>`	URL	—	ファイルの代わりに参考音声の URL を指定。
`--provider-song-id <id>`	文字列	—	ファイルの代わりに Mureka song id を指定。
`--lyrics <text>`	文字列（必須）	—	リミックスする曲の歌詞。
`--prompt <text>`	文字列（必須）	—	音楽の説明。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`600`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music remix ./original.mp3 --lyrics "New verse..." --prompt "Lo-fi hip hop"

music instrumental

単体のインストゥルメンタルを生成します（Mureka）。--prompt と --reference-audio のうち、ちょうど 1 つを指定します。

フラグ	値	デフォルト	意味
`--prompt <text>`	文字列	—	音楽の説明。
`--reference-audio <path>`	ローカルファイル	—	参考音声（`.mp3`/`.m4a`、最大 10 MB）。
`--model <version>`	`auto`、`mureka-7.6`、`mureka-8`、`mureka-o2`	—	モデルのバージョン。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`600`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music instrumental --prompt "Cinematic orchestral build-up" --model mureka-8

music soundtrack

画像または動画から音楽を生成します（Mureka）。--image と --video のうち、ちょうど 1 つを指定します。

フラグ	値	デフォルト	意味
`--image <path>`	ローカルファイル	—	元になる画像（`.jpg`/`.jpeg`/`.png`/`.webp`、最大 10 MB）。
`--video <path>`	ローカルファイル	—	元になる動画（`.mp4`/`.mov`/`.avi`/`.mkv`/`.webm`、最大 10 MB）。
`--prompt <text>`	文字列	—	音楽の説明。
`--model <version>`	`auto`、`mureka-7.6`、`mureka-8`、`mureka-9`、`mureka-o2`	—	モデルのバージョン。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`600`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music soundtrack --image ./cover.png --prompt "Dreamy synthwave"

music track

単一の楽器またはボーカルのトラックを生成します（Mureka）。ソースはちょうど 1 つ指定します。位置引数 [audio] のローカルファイル（.mp3/.m4a/.wav、最大 10 MB）か --provider-song-id です。--generate-type が Vocals の場合は --lyrics が必須です。

フラグ	値	デフォルト	意味
`[audio]`	ローカルファイル	—	参考音声ファイル（位置引数）。
`--provider-song-id <id>`	文字列	—	ファイルの代わりに Mureka song id を指定。
`--generate-type <type>`	`Vocals`、`Instrumental`、`Drums`、`Bass`、`Guitar`、`Keyboard`、`Percussion`、`Strings`、`Synth`、`FX`、`Brass`、`Woodwinds`（必須）	—	生成するトラックの種類。
`--prompt <text>`	文字列（必須）	—	音楽の説明。
`--lyrics <text>`	文字列	—	歌詞。`--generate-type` が `Vocals` の場合は必須。
`--vocal-gender <gender>`	`male`、`female`	—	ボーカルの性別。
`--generate-start <seconds>`	数値	—	範囲の開始位置（秒）。
`--generate-end <seconds>`	数値	—	範囲の終了位置（秒）。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`600`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music track ./song.mp3 --generate-type Drums --prompt "Punchy breakbeat"

music recognize

音声からタイムスタンプ付きの歌詞を認識します（Mureka）。同期実行で、すぐに出力します。

フラグ	値	デフォルト	意味
`--audio <path>`	ローカルファイル（必須）	—	音声ファイル（`.mp3`/`.m4a`、最大 10 MB）。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music recognize --audio ./song.mp3

music describe

音声を分析します。説明、タグ、ジャンル、楽器を返します（Mureka）。同期実行です。

フラグ	値	デフォルト	意味
`--audio <path>`	ローカルファイル（必須）	—	音声ファイル（`.mp3`/`.m4a`、最大 10 MB）。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music describe --audio ./song.mp3

music stem

音声をステムに分離し、ダウンロード URL を返します（Mureka）。同期実行です。

フラグ	値	デフォルト	意味
`--audio <path>`	ローカルファイル（必須）	—	音声ファイル（`.mp3`/`.m4a`、最大 10 MB）。
`--model <model>`	`audio-separation-1`、`audio-separation-2`	—	分離モデル。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music stem --audio ./song.mp3 --model audio-separation-2

music list

フラグ	値	デフォルト	意味
`--page <n>`	数値	`1`	ページ番号。
`--page-size <n>`	数値	`20`	1 ページあたりの件数。
`--status <status>`	`pending`、`generating`、`uploading`、`success`、`failed`	—	ステータスで絞り込みます。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music list --status success

music get

フラグ	値	デフォルト	意味
`<taskId>`	文字列（必須）	—	音楽タスクの ID（位置引数）。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub music get <task-id>

image

AI 画像を生成・管理します。

listenhub image create --prompt <text> [options]
listenhub image list [options]
listenhub image get <id> [-j]
listenhub image delete <id...> [-j]

image create

--reference はローカルファイルまたは URL を受け付け、最大 5 回まで繰り返し指定できます。

フラグ	値	デフォルト	意味
`--prompt <text>`	文字列（必須）	—	画像の説明。
`--model <model>`	文字列	—	モデル名。
`--lang <lang>`	文字列	—	プロンプトの言語のヒント。
`--aspect-ratio <ratio>`	文字列	`1:1`	アスペクト比。
`--size <size>`	`1K`、`2K`、`4K`	`2K`	画像サイズ。
`--reference <path-or-url>`	パスまたは URL（繰り返し可、最大 5）	`[]`	参照画像。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`120`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub image create --prompt "a dragon in watercolor style" --reference ./sketch.png

image list

フラグ	値	デフォルト	意味
`--page <n>`	数値	`1`	ページ番号。
`--page-size <n>`	数値	`20`	1 ページあたりの件数。
`--json`、`-j`	フラグ	`false`	JSON 出力。

image get / image delete

コマンド	引数	意味
`image get <id>`	画像 ID	画像の詳細を取得します。`-j` を受け付けます。
`image delete <id...>`	1 つ以上の画像 ID	AI 画像を 1 つ以上削除します。`-j` を受け付けます。

listenhub image get <id>
listenhub image delete <id1> <id2>

video

SeeDance モデルで動画を生成します。画像 / 動画 / 音声の入力は <path-or-url> を受け付けます（ローカルファイルはアップロードされ、URL はそのまま渡されます）。

listenhub video create --prompt <text> [options]
listenhub video get <taskId> [-j]
listenhub video list [options]
listenhub video estimate [options]

video create

フラグ	値	デフォルト	意味
`--prompt <text>`	文字列（必須）	—	動画の説明。
`--model <model>`	`happyhorse`、`doubao-seedance-2-pro`、`doubao-seedance-2-fast`	`happyhorse`	生成モデル。
`--resolution <res>`	`480p`、`720p`、`1080p`	—	出力解像度。
`--ratio <ratio>`	`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`4:5`、`5:4`	—	アスペクト比。
`--duration <seconds>`	数値 `3`–`15`	—	動画の長さ。
`--first-frame <path-or-url>`	パスまたは URL	—	最初のフレームの画像。
`--last-frame <path-or-url>`	パスまたは URL	—	最後のフレームの画像（`--first-frame` が必要）。
`--reference-image <path-or-url>`	パスまたは URL（繰り返し可、最大 9）	`[]`	参照画像。
`--reference-video <path-or-url>`	パスまたは URL（繰り返し可、最大 3）	`[]`	参照動画。
`--reference-audio <path-or-url>`	パスまたは URL（繰り返し可、最大 3）	`[]`	参照音声。
`--input-video-duration <seconds>`	数値 `2`–`15`	—	参照動画の長さ。`--reference-video` と併用する場合は必須。
`--no-generate-audio`	フラグ	音声あり	音声の生成を無効にします。
`--audio-setting <mode>`	`auto`、`origin`	—	動画編集時の音声の扱い。
`--seed <number>`	数値 `-1`–`4294967295`	—	乱数シード。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`1200`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub video create --prompt "A cat playing piano" --resolution 720p --duration 5

video estimate

作成する前にクレジットのコストを見積もります。

フラグ	値	デフォルト	意味
`--model <model>`	文字列（必須）	—	モデル名。
`--resolution <res>`	文字列（必須）	—	解像度。
`--duration <seconds>`	数値（必須）	—	長さ。
`--ratio <ratio>`	文字列	`16:9`	アスペクト比。
`--has-video-input`	フラグ	`false`	参照動画の入力があるかどうか。
`--input-video-duration <seconds>`	数値	—	参照動画の長さ。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub video estimate --model doubao-seedance-2-pro --resolution 1080p --duration 10

コマンド	フラグ	意味
`video get <taskId>`	`-j`	動画タスクの詳細を取得します。
`video list`	`--page`、`--page-size`、`--status`（`pending`/`generating`/`uploading`/`success`/`failed`）、`-j`	動画タスクを一覧します。

listenhub video list --status success
listenhub video get <task-id>

speakers

アカウントで利用できる声を一覧します。

listenhub speakers list [options]

フラグ	値	デフォルト	意味
`--lang <lang>`	`en`、`zh`、`ja`	—	言語で絞り込みます。
`--json`、`-j`	フラグ	`false`	JSON 出力。

Name、ID、Gender、Personality の表を出力します。作成系のコマンドで --speaker-id に渡すのは ID 列の値です。

このコマンドはログインが必要です。認証なしで同じカタログを見たい場合や、エージェントに 1 回のリクエストで丸ごと渡したい場合は listenhub.ai/voices.txt を取得してください。すべての公式音声の ID、言語、性別、タグが並んでいます。listenhub.ai/voices は同じカタログを音声プレビュー付きで見られます。

listenhub speakers list --lang en

lyrics

プロンプトから曲の歌詞を生成します。

listenhub lyrics generate --prompt <text> [options]
listenhub lyrics list [options]
listenhub lyrics get <taskId> [-j]

lyrics generate

フラグ	値	デフォルト	意味
`--prompt <text>`	文字列（必須、最大 200 文字）	—	歌詞の説明。
`--no-wait`	フラグ	ポーリング	ポーリングせずに ID を即座に返します。
`--timeout <seconds>`	数値	`120`	ポーリングのタイムアウト。
`--json`、`-j`	フラグ	`false`	JSON 出力。

listenhub lyrics generate --prompt "A hopeful anthem about new beginnings"

lyrics list / lyrics get

コマンド	フラグ	意味
`lyrics list`	`--page`、`--page-size`、`--status`（`pending`/`generating`/`success`/`failed`）、`-j`	歌詞タスクを一覧します。
`lyrics get <taskId>`	`-j`	歌詞タスクの詳細を取得します。

listenhub lyrics list --status success
listenhub lyrics get <task-id>

creation

任意の創作物（エピソード、画像、その他の生成物）を ID で取得または削除します。

listenhub creation get <id> [-j]
listenhub creation delete <id...> [-j]

コマンド	引数	意味
`creation get <id>`	創作物の ID	創作物の詳細を取得します。`-j` を受け付けます。
`creation delete <id...>`	1 つ以上の ID	創作物を 1 つ以上削除します。`-j` を受け付けます。

listenhub creation get <id>
listenhub creation delete <id1> <id2>

CLI クイックスタート

認証

OpenAPI コマンド

JavaScript SDK

このページの内容