AI 语音合成（TTS）大模型 API 接口

通过我们的 AI 语音合成（TTS）大模型 API 接口，您可以轻松将文本转化为自然流畅的语音素材。接口基于最新的深度学习技术，支持多种语言和语音风格，音质清晰、语音自然，广泛应用于智能客服、导航系统、播报服务、语音助手等场景。

🎯接口地址

POST https://wcode.net/api/audio/gpt/text-to-audio/v3/transcription

🎯快速开始

（注：以下请求示例中的 API_KEY 需要替换后再发起请求。 获取 API_KEY 入口：https://wcode.net/get-apikey）

请求示例（doubao-ve-tts-v1模型）：

curl --request POST 'https://wcode.net/api/audio/gpt/text-to-audio/v3/transcription' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
    "model": "doubao-ve-tts-v1",
    "text": "你好，这里是万码云开发平台技术研发中心。",
    "file_format": "mp3"
}'

🎯计费方式

按调用次数计费，费用充值：https://wcode.net/apikey-recharge，费用发票：https://wcode.net/get-fapiao

模型 ID	价格（元/千字）	模型说明
cosyvoice-v2	0.3	CosyVoice-v2 在发音准确性、音色一致性、韵律和音质上都有显著提升。
cosyvoice-v1	0.3	CosyVoice-v1 深度融合文本理解和语音生成的新一代生成式TTS语音合成大模型。
doubao-ve-tts-v1	0.65	豆包语音合成大模型基于新一代AI技术，通过智能分析文本上下文生成高保真且个性化的语音，在自然度、音质和情感表达等维度显著超越传统技术，实现了接近真人水平的语音合成效果。

cosyvoice-v2 模型目前处于实验性支持阶段，生产环境优先推荐 cosyvoice-v1 和 doubao-ve-tts-v1 模型。

🎯请求方法

POST

🎯请求头（Request Headers）

Header	值	备注	示例	相关链接
Authorization	Bearer API_KEY	格式：Bearer + 空格 + API_KEY	Bearer sk-.....	获取 API_KEY 入口：https://wcode.net/get-apikey
Content-Type	application/json	固定为 application/json

🎯请求参数

🚀 model | ✅️必填 | string | 模型 ID

模型 ID	价格（元/千字）	模型说明
cosyvoice-v2	0.3	CosyVoice-v2 在发音准确性、音色一致性、韵律和音质上都有显著提升。
cosyvoice-v1	0.3	CosyVoice-v1 深度融合文本理解和语音生成的新一代生成式TTS语音合成大模型。
doubao-ve-tts-v1	0.65	豆包语音合成大模型基于新一代AI技术，通过智能分析文本上下文生成高保真且个性化的语音，在自然度、音质和情感表达等维度显著超越传统技术，实现了接近真人水平的语音合成效果。

cosyvoice-v2 模型目前处于实验性支持阶段，生产环境优先推荐 cosyvoice-v1 和 doubao-ve-tts-v1 模型。

🚀 text | ✅️必填 | string | 需要进行语音合成的文本内容。示例：相较于传统语音合成技术，大模型能输出在自然度、音质、韵律、情感、语气词表达等方面更像真人。

文本内容长度限制为 1024 字节，超过此长度的文本内容需分段生成。

🚀 file_format | 选填 | string | 默认值：mp3 | 语音合成的音频编码格式，可选值如下：

• mp3
• wav
• pcm

🚀 timbre | 选填 | string | 语音合成的音色ID，需搭配模型一起使用，音色支持列表如下：

点击查看 cosyvoice-* 系列模型支持的音色列表（默认音色ID：longxiaochun）

音色	model参数	音色ID	适用场景	语言	默认采样率（Hz）	默认音频格式
龙婉	cosyvoice-v1 或 cosyvoice-v2	longwan	语音助手、导航播报、聊天数字人	中文普通话	22050	mp3
龙橙	cosyvoice-v1 或 cosyvoice-v2	longcheng	语音助手、导航播报、聊天数字人	中文普通话	22050	mp3
龙华	cosyvoice-v1 或 cosyvoice-v2	longhua	语音助手、导航播报、聊天数字人	中文普通话	22050	mp3
龙小淳	cosyvoice-v1 或 cosyvoice-v2	longxiaochun	语音助手、导航播报、聊天数字人	中文+英文	22050	mp3
龙小夏	cosyvoice-v1 或 cosyvoice-v2	longxiaoxia	语音助手、聊天数字人	中文	22050	mp3
龙小诚	cosyvoice-v1	longxiaocheng	语音助手、导航播报、聊天数字人	中文+英文	22050	mp3
龙小白	cosyvoice-v1	longxiaobai	聊天数字人、有声书、语音助手	中文	22050	mp3
龙老铁	cosyvoice-v1	longlaotie	新闻播报、有声书、语音助手、直播带货、导航播报	中文东北口音	22050	mp3
龙书	cosyvoice-v1 或 cosyvoice-v2	longshu	有声书、语音助手、导航播报、新闻播报、智能客服	中文	22050	mp3
龙硕	cosyvoice-v1	longshuo	语音助手、导航播报、新闻播报、客服	中文	22050	mp3
龙婧	cosyvoice-v1	longjing	语音助手、导航播报、新闻播报、客服	中文	22050	mp3
龙妙	cosyvoice-v1	longmiao	客服、导航播报、有声书、语音助手	中文	22050	mp3
龙悦	cosyvoice-v1	longyue	语音助手、诗词朗诵、有声书朗读、导航播报、新闻播报、客服	中文	22050	mp3
龙媛	cosyvoice-v1	longyuan	有声书、语音助手、聊天数字人	中文	22050	mp3
龙飞	cosyvoice-v1	longfei	会议播报、新闻播报、有声书	中文	22050	mp3
龙杰力豆	cosyvoice-v1	longjielidou	新闻播报、有声书、聊天助手	中文+英文	22050	mp3
龙彤	cosyvoice-v1	longtong	有声书、导航播报、聊天数字人	中文	22050	mp3
龙祥	cosyvoice-v1	longxiang	新闻播报、有声书、导航播报	中文	22050	mp3
Stella	cosyvoice-v1	loongstella	语音助手、直播带货、导航播报、客服、有声书	中文+英文	22050	mp3
Bella	cosyvoice-v1 或 cosyvoice-v2	loongbella	语音助手、客服、新闻播报、导航播报	中文	22050	mp3

点击查看 doubao-* 系列模型支持的音色列表（默认音色ID：zh_female_cancan_mars_bigtts）

场景	音色名称	音色ID	时间戳	语种
通用场景	灿灿/Shiny	zh_female_cancan_mars_bigtts	√	中文、美式英语
通用场景	清新女声	zh_female_qingxinnvsheng_mars_bigtts	√	中文
通用场景	邻家小妹/Lily	zh_female_linjia_mars_bigtts	√	中文、美式英语
通用场景	爽快思思/Skye	zh_female_shuangkuaisisi_moon_bigtts	√	中文、美式英语
通用场景	温暖阿虎/Alvin	zh_male_wennuanahu_moon_bigtts	√	中文、美式英语
通用场景	少年梓辛/Brayan	zh_male_shaonianzixin_moon_bigtts	√	中文、美式英语
通用场景	知性女声	zh_female_zhixingnvsheng_mars_bigtts	√	中文
通用场景	清爽男大	zh_male_qingshuangnanda_mars_bigtts	√	中文
通用场景	邻家女孩	zh_female_linjianvhai_moon_bigtts	√	中文
通用场景	渊博小叔	zh_male_yuanboxiaoshu_moon_bigtts	√	中文
通用场景	阳光青年	zh_male_yangguangqingnian_moon_bigtts	√	中文
通用场景	甜美小源	zh_female_tianmeixiaoyuan_moon_bigtts	√	中文
通用场景	清澈梓梓	zh_female_qingchezizi_moon_bigtts	√	中文
通用场景	解说小明	zh_male_jieshuoxiaoming_moon_bigtts	√	中文
通用场景	开朗姐姐	zh_female_kailangjiejie_moon_bigtts	√	中文
通用场景	邻家男孩	zh_male_linjiananhai_moon_bigtts	√	中文
通用场景	甜美悦悦	zh_female_tianmeiyueyue_moon_bigtts	√	中文
通用场景	心灵鸡汤	zh_female_xinlingjitang_moon_bigtts	√	中文
通用场景	知性温婉	ICL_zh_female_zhixingwenwan_tob	√	中文
通用场景	暖心体贴	ICL_zh_male_nuanxintitie_tob	√	中文
通用场景	温柔文雅	ICL_zh_female_wenrouwenya_tob	√	中文
通用场景	开朗轻快	ICL_zh_male_kailangqingkuai_tob	√	中文
通用场景	活泼爽朗	ICL_zh_male_huoposhuanglang_tob	√	中文
通用场景	率真小伙	ICL_zh_male_shuaizhenxiaohuo_tob	√	中文
多语种	Smith	en_male_smith_mars_bigtts	√	英式英语
多语种	Anna	en_female_anna_mars_bigtts	√	英式英语
多语种	Adam	en_male_adam_mars_bigtts	√	美式英语
多语种	Sarah	en_female_sarah_mars_bigtts	√	澳洲英语
多语种	Dryw	en_male_dryw_mars_bigtts	√	澳洲英语
多语种	かずね（和音）/Javier or Álvaro	multi_male_jingqiangkanye_moon_bigtts	√	日语、西语
多语种	はるこ（晴子）/Esmeralda	multi_female_shuangkuaisisi_moon_bigtts	√	日语、西语
多语种	ひろし（広志）/Roberto	multi_male_wanqudashu_moon_bigtts	√	日语、西语
多语种	あけみ（朱美）	multi_female_gaolengyujie_moon_bigtts	√	日语
趣味口音	京腔侃爷/Harmony	zh_male_jingqiangkanye_moon_bigtts	√	中文-北京口音、英文
趣味口音	湾湾小何	zh_female_wanwanxiaohe_moon_bigtts	√	中文-台湾口音
趣味口音	湾区大叔	zh_female_wanqudashu_moon_bigtts	√	中文-广东口音
趣味口音	呆萌川妹	zh_female_daimengchuanmei_moon_bigtts	√	中文-四川口音
趣味口音	广州德哥	zh_male_guozhoudege_moon_bigtts	√	中文-广东口音
趣味口音	北京小爷	zh_male_beijingxiaoye_moon_bigtts	√	中文-北京口音
趣味口音	浩宇小哥	zh_male_haoyuxiaoge_moon_bigtts	√	中文-青岛口音
趣味口音	广西远舟	zh_male_guangxiyuanzhou_moon_bigtts	√	中文-广西口音
趣味口音	妹坨洁儿	zh_female_meituojieer_moon_bigtts	√	中文-长沙口音
趣味口音	豫州子轩	zh_male_yuzhouzixuan_moon_bigtts	√	中文-河南口音
角色扮演	奶气萌娃	zh_male_naiqimengwa_mars_bigtts	√	中文
角色扮演	婆婆	zh_female_popo_mars_bigtts	√	中文
角色扮演	高冷御姐	zh_female_gaolengyujie_moon_bigtts	√	中文
角色扮演	傲娇霸总	zh_male_aojiaobazong_moon_bigtts	√	中文
角色扮演	魅力女友	zh_female_meilinvyou_moon_bigtts	√	中文
角色扮演	深夜播客	zh_male_shenyeboke_moon_bigtts	√	中文
角色扮演	柔美女友	zh_female_sajiaonvyou_moon_bigtts	√	中文
角色扮演	撒娇学妹	zh_female_yuanqinvyou_moon_bigtts	√	中文
角色扮演	病弱少女	ICL_zh_female_bingruoshaonv_tob	√	中文
角色扮演	活泼女孩	ICL_zh_female_huoponvhai_tob	√	中文
角色扮演	东方浩然	zh_male_dongfanghaoran_moon_bigtts	√	中文
角色扮演	绿茶小哥	ICL_zh_male_lvchaxiaoge_tob	√	中文
角色扮演	娇弱萝莉	ICL_zh_female_jiaoruoluoli_tob	√	中文
角色扮演	冷淡疏离	ICL_zh_male_lengdanshuli_tob	√	中文
角色扮演	憨厚敦实	ICL_zh_male_hanhoudunshi_tob	√	中文
角色扮演	傲气凌人	ICL_zh_male_aiqilingren_tob	√	中文
角色扮演	活泼刁蛮	ICL_zh_female_huopodiaoman_tob	√	中文
角色扮演	固执病娇	ICL_zh_male_guzhibingjiao_tob	√	中文
角色扮演	撒娇粘人	ICL_zh_male_sajiaonianren_tob	√	中文
角色扮演	傲慢娇声	ICL_zh_female_aomanjiaosheng_tob	√	中文
角色扮演	潇洒随性	ICL_zh_male_xiaosasuixing_tob	√	中文
角色扮演	腹黑公子	ICL_zh_male_fuheigongzi_tob	√	中文
角色扮演	诡异神秘	ICL_zh_male_guiyishenmi_tob	√	中文
角色扮演	儒雅才俊	ICL_zh_male_ruyacaijun_tob	√	中文
角色扮演	病娇白莲	ICL_zh_male_bingjiaobailian_tob	√	中文
角色扮演	正直青年	ICL_zh_male_zhengzhiqingnian_tob	√	中文
角色扮演	娇憨女王	ICL_zh_female_jiaohannvwang_tob	√	中文
角色扮演	病娇萌妹	ICL_zh_female_bingjiaomengmei_tob	√	中文
角色扮演	青涩小生	ICL_zh_male_qingsenaigou_tob	√	中文
角色扮演	纯真学弟	ICL_zh_male_chunzhenxuedi_tob	√	中文
角色扮演	暖心学姐	ICL_zh_female_nuanxinxuejie_tob	√	中文
角色扮演	可爱女生	ICL_zh_female_keainvsheng_tob	√	中文
角色扮演	成熟姐姐	ICL_zh_female_chengshujiejie_tob	√	中文
角色扮演	病娇姐姐	ICL_zh_female_bingjiaojiejie_tob	√	中文
角色扮演	优柔帮主	ICL_zh_male_youroubangzhu_tob	√	中文
角色扮演	优柔公子	ICL_zh_male_yourougongzi_tob	√	中文
角色扮演	妩媚御姐	ICL_zh_female_wumeiyujie_tob	√	中文
角色扮演	调皮公主	ICL_zh_female_tiaopigongzhu_tob	√	中文
角色扮演	傲娇女友	ICL_zh_female_aojiaonvyou_tob	√	中文
角色扮演	贴心男友	ICL_zh_male_tiexinnanyou_tob	√	中文
角色扮演	少年将军	ICL_zh_male_shaonianjiangjun_tob	√	中文
角色扮演	贴心女友	ICL_zh_female_tiexinnvyou_tob	√	中文
角色扮演	病娇哥哥	ICL_zh_male_bingjiaogege_tob	√	中文
角色扮演	学霸男同桌	ICL_zh_male_xuebanantongzhuo_tob	√	中文
角色扮演	幽默叔叔	ICL_zh_male_youmoshushu_tob	√	中文
角色扮演	性感御姐	ICL_zh_female_xingganyujie_tob	√	中文
角色扮演	假小子	ICL_zh_female_jiaxiaozi_tob	√	中文
角色扮演	冷峻上司	ICL_zh_male_lengjunshangsi_tob	√	中文
角色扮演	温柔男同桌	ICL_zh_male_wenrounantongzhuo_tob	√	中文
角色扮演	病娇弟弟	ICL_zh_male_bingjiaodidi_tob	√	中文
角色扮演	幽默大爷	ICL_zh_male_youmodaye_tob	√	中文
角色扮演	傲慢少爷	ICL_zh_male_aomanshaoye_tob	√	中文
角色扮演	神秘法师	ICL_zh_male_shenmifashi_tob	√	中文
视频配音	和蔼奶奶	ICL_zh_female_heainainai_tob	√	中文
视频配音	邻居阿姨	ICL_zh_female_linjuayi_tob	√	中文
视频配音	温柔小雅	zh_female_wenrouxiaoya_moon_bigtts	√	中文
视频配音	天才童声	zh_male_tiancaitongsheng_mars_bigtts	√	中文
视频配音	猴哥	zh_male_sunwukong_mars_bigtts	√	中文
视频配音	熊二	zh_male_xionger_mars_bigtts	√	中文
视频配音	佩奇猪	zh_female_peiqi_mars_bigtts	√	中文
视频配音	武则天	zh_female_wuzetian_mars_bigtts	√	中文
视频配音	顾姐	zh_female_gujie_mars_bigtts	√	中文
视频配音	樱桃丸子	zh_female_yingtaowanzi_mars_bigtts	√	中文
视频配音	广告解说	zh_male_chunhui_mars_bigtts	√	中文
视频配音	少儿故事	zh_female_shaoergushi_mars_bigtts	√	中文
视频配音	四郎	zh_male_silang_mars_bigtts	√	中文
视频配音	磁性解说男声/Morgan	zh_male_jieshuonansheng_mars_bigtts	√	中文、美式英语
视频配音	鸡汤妹妹/Hope	zh_female_jitangmeimei_mars_bigtts	√	中文、美式英语
视频配音	贴心女声/Candy	zh_female_tiexinnvsheng_mars_bigtts	√	中文、美式英语
视频配音	俏皮女声	zh_female_qiaopinvsheng_mars_bigtts	√	中文
视频配音	萌丫头/Cutey	zh_female_mengyatou_mars_bigtts	√	中文、美式英语
有声阅读	悬疑解说	zh_male_changtianyi_mars_bigtts	√	中文
有声阅读	儒雅青年	zh_male_ruyaqingnian_mars_bigtts	√	中文
有声阅读	霸气青叔	zh_male_baqiqingshu_mars_bigtts	√	中文
有声阅读	擎苍	zh_male_qingcang_mars_bigtts	√	中文
有声阅读	活力小哥	zh_male_yangguangqingnian_mars_bigtts	√	中文
有声阅读	古风少御	zh_female_gufengshaoyu_mars_bigtts	√	中文
有声阅读	温柔淑女	zh_female_wenroushunv_mars_bigtts	√	中文

🎯返回参数

不同模型返回参数可能存在差异，请以实际返回为准。

返回参数	数据类型	说明
status	string	请求成功返回success，失败返回failed
error_message	string	接口返回的错误消息。当status为success时，error_message为空字符串
error_code	int 或 null	接口返回的错误码。当status为success时，error_code为 null
data	object 或 null	接口返回的数据。当status为failed时，data为 null
data.result.audio_file_temp_url	string	语音合成文件临时 URL，有效期 3 分钟，开发者需尽快下载保存至本地
data.result.audio_file_filesize	int 或 null	语音合成文件大小
data.result.audio_file_playtime_seconds	float 或 null	语音合成文件播放时长（单位：秒）
data.result.audio_file_playtime_string	string 或 null	语音合成文件播放时长（时间格式）
data.result.audio_file_bitrate	int 或 null	语音合成文件比特率
data.result.audio_file_sample_rate	int 或 null	语音合成文件采样率
data.result.audio_file_channels	int 或 null	语音合成文件音频通道数量，1为单声道（Mono），2为立体声（Stereo），null则表示无法获取音频通道信息
data.usage	object	本次调用的费用信息
data.usage.total_cost	float	本次调用产生的费用
data.api_version	string	当前所使用的 API 的版本，免费版为free，付费版为paid
data.api_docs	string	当前所使用的 API 的文档链接

🎯响应头（Response Headers）

Header	说明	示例	相关链接
X-Account-Balance	API_KEY 余额（元）	123.0123	API_KEY 费用充值入口：https://wcode.net/apikey-recharge

🎯Python 代码示例（Requests）

import requests
import json

url = "https://wcode.net/api/audio/gpt/text-to-audio/v3/transcription"

payload = json.dumps({
    "model": "doubao-ve-tts-v1",
    "text": "你好，这里是万码云开发平台技术研发中心。",
    "file_format": "mp3"
})
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer API_KEY'     # TODO: 这里的 API_KEY 需要替换，获取 API_KEY 入口：https://wcode.net/get-apikey
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

...其他编程语言可参考下方 curl http 请求示例进行调用

🎯请求示例 1（使用 doubao-ve-tts-v1 模型）

curl --request POST 'https://wcode.net/api/audio/gpt/text-to-audio/v3/transcription' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
    "model": "doubao-ve-tts-v1",
    "text": "你好，这里是万码云开发平台技术研发中心。",
    "file_format": "mp3"
}'

🎯响应示例 1

{
    "status": "success",
    "error_message": "",
    "error_code": null,
    "data": {
        "result": {
            "audio_file_temp_url": "https://wcode.net/tmp/tts-1740813073-QcYjtrzqnUYwJ7y7.mp3", // 有效期 3 分钟，开发者需尽快下载保存至本地
            "audio_file_filesize": 91200,
            "audio_file_playtime_seconds": 4.56,
            "audio_file_playtime_string": "0:05",
            "audio_file_bitrate": 160000,
            "audio_file_sample_rate": 24000
        },
        "api_usage": {
            "total_cost": 0.013,
            "total_cost_currency": "CNY",
            "total_cost_currency_symbol": "¥"
        },
        "api_version": "paid"
    }
}

🎯请求示例 2（使用 cosyvoice-v1 模型）

curl --request POST 'https://wcode.net/api/audio/gpt/text-to-audio/v3/transcription' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
    "model": "cosyvoice-v1",
    "text": "你好，这里是万码云开发平台技术研发中心。",
    "file_format": "mp3"
}'

🎯响应示例 2

{
    "status": "success",
    "error_message": "",
    "error_code": null,
    "data": {
        "result": {
            "audio_file_temp_url": "https://wcode.net/tmp/tts-1740635350-TIgoVyzMS4eZ33qt.mp3", // 有效期 3 分钟，开发者需尽快下载保存至本地
            "audio_file_filesize": 63574,
            "audio_file_playtime_seconds": 3.9705625,
            "audio_file_playtime_string": "0:04",
            "audio_file_bitrate": 128000,
            "audio_file_sample_rate": 22050
        },
        "api_usage": {
            "total_cost": 0.006,
            "total_cost_currency": "CNY",
            "total_cost_currency_symbol": "¥"
        },
        "api_version": "paid"
    }
}