CosyVoice3-API

OpenAI-compatible text-to-speech (TTS) API that wraps Alibaba FunAudioLLM's CosyVoice 3 to provide a self-hosted, NVIDIA-GPU TTS service with zero-shot voice…

  • AI
  • Productivity
  • Tools & Utilities
OpenAI-compatible text-to-speech (TTS) API that wraps Alibaba FunAudioLLM's CosyVoice 3 to provide a self-hosted, NVIDIA-GPU TTS service with zero-shot voice cloning, voice registration, streaming, 9 languages, and 18 Chinese dialects for homelab users integrating OpenAI-compatible clients.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

34/100 Low

Maintained
59last commit 164 days ago
Popular
61 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
1016 GB minimum RAM

Availability: platform listings confirmed today, links checked 23 days ago

GitHub stars
1
Open issues
0
Last commit
2026-06-09
Activity
stale

Checked 7 days ago - source: GitHub (hsiang-han/CosyVoice3-API)

Resources & Compatibility

Minimum requirements: 16 GB RAM.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Voice setup and model download The model has no built-in voices. Register a voice by uploading a 3-second reference audio via /v1/voices/register, or use /v1/audio/speech/clone for one-off cloning. The first start downloads about 10 GB of model files from Hugging Face; in China, configure HF_ENDPOINT to the Hugging Face mirror for faster downloads. Requires an NVIDIA GPU with driver 550 or newer and CUDA 12.8 for Blackwell, Ada source

Fetched 47 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I create and keep a reusable voice in CosyVoice3-API?

Register a 3-second reference audio with its prompt text using the voice registration endpoint. Registered voices persist across container restarts.

What does streaming output from the speech endpoint contain?

Setting stream to true returns raw PCM audio. The audio is 16-bit, mono, 24000 Hz, and the headers include sample rate, channel, and bit-depth metadata.

How should I handle the initial model download for the Docker container?

Bind a persistent host directory to /root/.cache/models in the Docker run command. The first start downloads about 10 GB of model files, and China users can set HF_ENDPOINT to the Hugging Face mirror for faster downloads.

Which port does the Docker example expose for API requests?

The quick-start command exposes port 8080. Use that port to reach the API endpoints.

Answers sourced from github.com

Community

Collected 43 days ago - public community threads