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 음악 하위 명령은 로컬 파일만 받고(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>`	문자열(반복 가능)	—	이름으로 지정하는 스피커. 한 명이면 단독 진행, 두 명 이상이면 여러 목소리.
`--speaker-id <id>`	문자열(반복 가능)	—	내부 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`	페이지당 항목 수.
`--json`, `-j`	플래그	`false`	JSON 출력.

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

tts

하나의 보이스로 텍스트를 음성으로 변환합니다.

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>`	문자열	—	내부 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`	페이지당 항목 수.
`--json`, `-j`	플래그	`false`	JSON 출력.

listenhub tts list

voice-clone

로그인한 계정으로 참조 오디오에서 자신의 목소리를 복제하고, 그렇게 만들어진 비공개 보이스를 관리합니다. 업로드 모드만 지원하며, 대화형 녹음 플로는 웹 앱에 있습니다. 지원 언어는 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>`	비공개 보이스 하나를 가져옵니다.
`voice-clone update <speakerId>`	보이스 이름을 바꾸거나 성별을 변경합니다.
`voice-clone delete <speakerId>`	보이스를 삭제하고 슬롯 하나를 비웁니다.

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 중 최소 하나를 받습니다.

# 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>`	문자열	—	내부 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`	페이지당 항목 수.
`--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>`	문자열	—	내부 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`	페이지당 항목 수.
`--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). 소스는 정확히 하나만 지정하세요. 위치 인자 [audio] 로컬 파일(.mp3/.m4a, 최대 10 MB), --audio-url, --provider-song-id 중 하나입니다.

플래그	값	기본값	의미
`[audio]`	로컬 파일	—	참조 오디오 파일(위치 인자).
`--audio-url <url>`	URL	—	파일 대신 사용할 참조 오디오 URL.
`--provider-song-id <id>`	문자열	—	파일 대신 사용할 Mureka 곡 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 중 정확히 하나만 지정하세요.

플래그	값	기본값	의미
`--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 중 정확히 하나만 지정하세요.

플래그	값	기본값	의미
`--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). 소스는 정확히 하나만 지정하세요. 위치 인자 [audio] 로컬 파일(.mp3/.m4a/.wav, 최대 10 MB) 또는 --provider-song-id입니다. --generate-type이 Vocals이면 --lyrics가 필수입니다.

플래그	값	기본값	의미
`[audio]`	로컬 파일	—	참조 오디오 파일(위치 인자).
`--provider-song-id <id>`	문자열	—	파일 대신 사용할 Mureka 곡 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`	페이지당 항목 수.
`--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`	페이지당 항목 수.
`--json`, `-j`	플래그	`false`	JSON 출력.

image get / image delete

명령	인자	의미
`image get <id>`	이미지 ID	이미지 상세 정보를 가져옵니다. `-j`를 받습니다.
`image delete <id...>`	이미지 ID 하나 이상	AI 이미지를 하나 이상 삭제합니다. `-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 열입니다.

이 명령은 로그인이 필요합니다. 인증 없이 같은 카탈로그를 둘러보거나, 요청 한 번으로 에이전트에게 통째로 넘기고 싶다면 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...>`	ID 하나 이상	생성물을 하나 이상 삭제합니다. `-j`를 받습니다.

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

CLI 빠른 시작

인증

OpenAPI 명령

JavaScript SDK

이 페이지의 내용