listenhub-voice

Generates end-to-end audio from text or images via the ListenHub-Voice-1.0 OpenAPI.

335|37|Updated Jul 18, 2026
One-click install
npx skills add https://github.com/joeseesun/qiaomu-cut-skill --skill listenhub-voice-joeseesun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: listenhub-voice
Source: https://github.com/joeseesun/qiaomu-cut-skill/tree/main/vendor/marswaveai-skills/listenhub-voice
Command: npx skills add https://github.com/joeseesun/qiaomu-cut-skill --skill listenhub-voice-joeseesun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating finished audio—narration, multi-voice dialogue, sound effects, or voice clones—normally requires stitching together separate TTS, cloning, and sound-design tools. This Skill turns a single text script or reference image into a completed audio file through one async API workflow, with billing, polling, and file download handled for you. ## Core Features & Use Cases - End-to-End Audio Generation: Submit a text script (up to 1400 characters) to the ListenHub-Voice-1.0 model and receive a finished audio track, including sound effects described inline in the text. - Multi-Voice Dialogue & Voice Cloning: Assign lines to 2–3 voices with @音频N prefixes, clone a voice from a public reference audio URL, or use a registered ListenHub speaker or official voice_type. - Image-to-Audio: Convert a reference image (URL or Base64) into an audio track, mutually exclusive with voice selection. - Use Case: Ask for a 15-second rain-and-thunder sound effect, or a two-person podcast dialogue cloned from two reference clips, and the Skill submits the task, polls until success, and saves the MP3 to your working directory. ## Quick Start Ask the assistant to generate an audio clip from your script using listenhub-voice, for example: generate a 15-second sound effect of steady rain with distant thunder.

Frequently Asked Questions about listenhub-voice

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate audio from text with ListenHub Voice?▼

Submit a POST request to /v1/listenhub-voice/generate with your text (up to 1400 characters) and model listenhub-voice-1.0, authenticated with a Bearer API key. The endpoint returns a taskId, which you poll via GET /v1/listenhub-voice/tasks/{taskId} until the status is success.

How do I create multi-voice dialogue audio?▼

Provide 2–3 voices of type reference with public audio URLs, then prefix each script line with @音频1, @音频2, or @音频3 matching the voices array order. Every voice in a multi-voice request must be reference-audio-capable; official voice_type speakers are single-voice only.

Can I clone a voice from a reference audio file?▼

Yes, add a voices item of type reference pointing to a public audio URL. The clip must be 30 seconds or less, under 10MB, and in wav, mp3, pcm, or ogg_opus format.

Does ListenHub Voice support image-to-audio generation?▼

Yes, pass an image object with either a public URL or Base64 data (jpeg, png, or webp, under 10MB). The image field is mutually exclusive with voices, so you cannot combine both in one request.

What audio formats and parameters can I configure?▼

The audioConfig object accepts format (mp3 default, wav, pcm, ogg_opus), speechRate and loudnessRate from -50 to 100, and pitchRate from -12 to 12. You can also set durationHint between 1 and 110 seconds to guide generation length.

Why did my ListenHub Voice generation request fail?▼

A 400 response carries a business error code in the data payload, typically for insufficient credits, rate limiting (5 requests per 60 seconds), or validation errors such as text over 1400 characters. Check the errorMessage field on failed tasks and verify your API key configuration.