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

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

此文档为标准版 API 接口文档，可直接用于项目开发和系统调用。如果标准版 API 接口无法满足您的需求，需要定制开发 API 接口，请联系我们的 IT 技术支持工程师：

详细信息

定制开发服务流程：沟通需求✅ → 确认技术方案✅ → 沟通费用与工期✅ → 开发&测试✅ → 验收交付✅ → 维护升级✅

🎯接口地址

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

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

字符数量计算规则：1 个中文文字（含标点符号）计为 2 个字符；1 个英文字母（含标点符号）、特殊字符、空格、回车等均计为 1 个字符。

🎯请求方法

POST

🎯请求头（Request Headers）

🎯请求参数

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

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

字符数量计算规则：1 个中文文字（含标点符号）计为 2 个字符；1 个英文字母（含标点符号）、特殊字符、空格、回车等均计为 1 个字符。

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

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

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

• mp3
• wav
• pcm

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

🎯返回参数

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

🎯响应头（Response Headers）

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

以上文档为标准版 API 接口文档，可直接用于项目开发和系统调用。如果标准版 API 接口无法满足您的需求，需要定制开发 API 接口，请扫码联系我们的 IT 技术支持工程师：

（沟通需求✅ → 确认技术方案✅ → 沟通费用与工期✅ → 开发&测试✅ → 验收交付✅ → 维护升级✅）