API 指南 · 价格核对于 2026 年 10 月 26 日

CosyVoice API：模型（v3-flash、v3.5-flash、Plus）、价格与快速上手

用代码调用 CosyVoice 有三种方式：在自己的服务器上部署开源模型；通过阿里云百炼（Model Studio / DashScope）调用云端 CosyVoice 模型；或者不用 API，直接在浏览器里用 CosyVoice.org。

云端模型与价格 CosyVoice.org 套餐

1. 自己部署开源模型

官方仓库自带 FastAPI 和 gRPC 服务端。下面的命令摘自 QwenAudio/CosyVoice 的 README，运行前请先到 README 核对最新版本。

克隆并安装（Python 3.10，Conda）

git clone --recursive https://github.com/QwenAudio/CosyVoice.git
cd CosyVoice
git submodule update --init --recursive
conda create -n cosyvoice -y python=3.10
conda activate cosyvoice
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com

从 Hugging Face 下载 Fun-CosyVoice 3.0（也可用 ModelScope）

# for oversea users, huggingface SDK model download
from huggingface_hub import snapshot_download
snapshot_download('FunAudioLLM/Fun-CosyVoice3-0.5B-2512', local_dir='pretrained_models/Fun-CosyVoice3-0.5B')

用 Docker 启动 FastAPI 服务，并用自带客户端调用

cd runtime/python
docker build -t cosyvoice:v1.0 .
# for fastapi usage
docker run -d --runtime=nvidia -p 50000:50000 cosyvoice:v1.0 /bin/bash -c "cd /opt/CosyVoice/CosyVoice/runtime/python/fastapi && python3 server.py --port 50000 --model_dir iic/CosyVoice-300M && sleep infinity"
cd fastapi && python3 client.py --port 50000 --mode <sft|zero_shot|cross_lingual|instruct>

README 的服务端示例加载的是 CosyVoice-300M，并说明想用 instruct 推理就换成 iic/CosyVoice-300M-Instruct；请把 --model_dir 换成你下载的模型。README 还介绍了同一镜像里的 gRPC 服务、CosyVoice 2/3 的 vLLM 支持，以及 runtime/triton_trtllm 下的 TensorRT-LLM 运行时。

QwenAudio/CosyVoice README

2. 阿里云百炼（Model Studio / DashScope）

阿里云把 CosyVoice 做成了按字符计费的云端 API，可以通过 WebSocket 或 DashScope Python/Java SDK 调用。能用哪些模型，取决于账号所在地域。

各云端 CosyVoice 模型的地域与功能
模型	地域	声音复刻	声音设计（仅北京）	指令控制
`cosyvoice-v3.5-plus`	中国（北京）
`cosyvoice-v3.5-flash`	中国（北京）
`cosyvoice-v3-plus`	新加坡, 中国（北京）
`cosyvoice-v3-flash`	新加坡, 中国（北京）
`cosyvoice-v2`	中国（北京）

v3.5 模型没有系统音色，需要先复刻或设计一个音色。声音设计仅在中国（北京）地域提供。 Alibaba Cloud Model Studio: speech synthesis models Alibaba Cloud Model Studio: real-time TTS regions and models Alibaba Cloud Model Studio: voice design guide

CosyVoice API 官方价格

CosyVoice API 官方价格
模型	地域	每 1 万字符价格	免费额度
`cosyvoice-v3-plus`	新加坡	$0.26	1 万字符，90 天有效
`cosyvoice-v3-flash`	新加坡	$0.13	1 万字符，90 天有效
`cosyvoice-v3.5-plus`	中国（北京）	$0.22	无
`cosyvoice-v3.5-flash`	中国（北京）	$0.116	无
`cosyvoice-v3-plus`	中国（北京）	$0.286706	无
`cosyvoice-v3-flash`	中国（北京）	$0.14335	无
`cosyvoice-v2`	中国（北京）	$0.286706	无

阿里云国际站价格，2026 年 10 月 26 日所见（页面最后更新于 2026 年 10 月 22 日）。按输入字符计费，输出音频不收费。免费额度仅限新加坡地域，自开通百炼、模型发布或申请获批之日起（以最晚者为准）90 天内有效。 Alibaba Cloud Model Studio pricing (International site)

阿里云中国站账号按人民币计价——例如在中国（北京）地域，cosyvoice-v3-flash 为每 1 万字符 1 元，cosyvoice-v3.5-flash 为 0.8 元，免费额度仅限北京地域。阿里云百炼模型价格 (China site)

Python 快速上手

安装 DashScope SDK，把 API Key 放进环境变量 DASHSCOPE_API_KEY，再把地址里的 WorkspaceId 占位符换成你的百炼业务空间 ID。下面是阿里云官方的新加坡示例；不要把 Key 写进代码。

用 cosyvoice-v3-plus 合成一句话（新加坡）

import dashscope
from dashscope.audio.tts_v2 import *
import os
dashscope.api_key = os.environ.get('DASHSCOPE_API_KEY')
dashscope.base_websocket_api_url='wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference'
model = "cosyvoice-v3-plus"
voice = "longanyang"
synthesizer = SpeechSynthesizer(model=model, voice=voice)
audio = synthesizer.call("How is the weather today?")
with open('output.mp3', 'wb') as f:
    f.write(audio)

一次 call() 最多 2 万字符。阿里云现在推荐使用这个按业务空间区分的地址，而不是旧的 dashscope-intl.aliyuncs.com。 Alibaba Cloud Model Studio: CosyVoice Python SDK

通过 API 复刻声音

先用一段参考录音创建自定义音色——建议 10–20 秒，最长 60 秒、不超过 10 MB——然后用音色 ID 合成。阿里云创建音色不收费，每个账号最多保存 1,000 个自定义音色。 Alibaba Cloud Model Studio: voice cloning guide

3. 不想管 Key 和服务器？

CosyVoice.org 不提供公开 API，而是直接在浏览器里替你运行云端 CosyVoice 模型：输入文案、选择或克隆音色、下载音频。可以免费开始，需要更长文本或商用时再升级。

查看 CosyVoice.org 套餐 →在浏览器里免费试用 →

不确定该用哪一代模型？请看CosyVoice 3详解。

CosyVoice API 常见问题

选 cosyvoice-v3-flash 还是 cosyvoice-v3.5-flash？

按地域和音色来选。cosyvoice-v3.5-flash 只在中国（北京）地域提供，没有系统音色，需要先复刻或设计一个音色；cosyvoice-v3-flash 在新加坡和中国（北京）都有，并带系统音色。两者都支持声音复刻和指令控制。

CosyVoice API 有免费额度吗？

在阿里云国际站，cosyvoice-v3-plus 和 cosyvoice-v3-flash 在新加坡地域各有 1 万字符免费额度，90 天有效，国际站其他地域没有。在阿里云中国站，免费额度仅限北京地域。

CosyVoice API 怎么计费？

按每 1 万输入字符计费，生成的音频不收费。不同模型和地域价格不同——见上表，做预算前请再到阿里云价格页核对。

CosyVoice.org 有 API 吗？

没有公开 API。CosyVoice.org 是浏览器应用。需要用代码调用的话，可以自己部署开源模型或使用阿里云百炼；想在浏览器里直接生成语音，请看我们的套餐。

可以免费自己部署 CosyVoice 吗？

代码和 Fun-CosyVoice 3.0 权重都可以按 Apache-2.0 协议免费下载，但 GPU 服务器要自己付费；README 没有给出最低 GPU 要求，请实测后再定配置。

资料来源

本页事实已于 2026 年 10 月 26 日对照以下官方资料核对。