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"
    }
}