1. Vidu
梧柏API使用文档
WHBAI · Vidu
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • Vidu
    • 语音合成 TTS
      POST
    • 文生视频
      POST
    • 图生视频
      POST
    • 首尾帧生视频
      POST
    • 参考生视频
      POST
    • 参考生图
      POST
    • 文生音频
      POST
    • 查询任务
      GET
  • vidu
    • 创建视频
      POST
    • 查询任务
      GET
  • 数据模型
    • ViduSampleRequest
    • PostEntV2Text2videoRequest
    • PostEntV2Img2videoRequest
    • PostEntV2StartEnd2videoRequest
    • PostEntV2Reference2videoRequest
    • PostEntV2Reference2imageRequest
    • PostEntV2Text2audioRequest
    • NewApiError
  1. Vidu

语音合成 TTS

POST
/ent/v2/audio-tts
文本转语音。

网站中的模型与调用示例#

语音合成#

官方文档:https://platform.vidu.cn/docs/text-to-speech

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "payload": {
      "description": "透传参数\n不做任何处理,仅数据传输\n注:最多 1048576个字符",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Pass-through parameter. Not processed; forwarded as-is. Max 1048576 characters."
        }
      }
    },
    "pronunciation_dict_tone": {
      "description": "定义多音字发音\n- 定义需要特殊标注的文字或符号对应的注音或发音替换规则,针对多音字场景,在中文文本中,声调用数字表示:一声为 1;二声为 2;三声为 3;四声为 4;轻声为 5。\n- 示例如下:\n[\"燕少飞/(yan4)(shao3)(fei1)\", \"达菲/(da2)(fei1)\", \"omg/oh my god\"]",
      "type": "string"
    },
    "text": {
      "description": "需要合成语音的文本\n1. 长度限制小于 10000 字符\n2. 段落切换用换行符标记\n3. 停顿控制:支持自定义文本之间的语音时间间隔,以实现自定义文本语音停顿时间的效果。\n- 使用方式:在文本中增加<#x#>标记,x 为停顿时长(单位:秒),范围 [0.01, 99.99],最多保留两位小数。文本间隔时间需设置在两个可以语音发音的文本之间,不可连续使用多个停顿标记\n- 示例:你好<#2#>我是vidu<#2#>很高兴见到你",
      "type": "string"
    },
    "voice_setting_emotion": {
      "description": "控制合成语音的情绪\n1. 参数范围 [\"happy\", \"sad\", \"angry\", \"fearful\", \"disgusted\", \"surprised\", \"calm\"],分别对应 7 种情绪:高兴,悲伤,愤怒,害怕,厌恶,惊讶,中性\n2. 模型会根据输入文本自动匹配合适的情绪,一般无需手动指定",
      "type": "string"
    },
    "voice_setting_pitch": {
      "description": "合成音频的语调\n范围 [-12,12],默认 0,其中 0 为原音色输出",
      "type": "string"
    },
    "voice_setting_speed": {
      "description": "语速,默认为1.0\n1.0为正常语速,范围 [0.5,2],值为0.5时播报语速最慢,值为2时播报语速最快",
      "type": "string"
    },
    "voice_setting_voice_id": {
      "description": "合成音频的音色id\n可查看音色列表查询全部可用音色:https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg",
      "type": "string"
    },
    "voice_setting_volume": {
      "description": "音量大小\n范围 0 - 10,默认为0,代表正常音量,值越大音量越高",
      "type": "string"
    }
  },
  "required": [
    "text",
    "voice_setting_voice_id"
  ]
}

请求示例 · 示例 1#

{
  "text": "人工智能正在改变我们的生活方式,从智能家居到自动驾驶,技术的进步让世界变得更加便利。",
  "voice_setting_voice_id": "male-qn-daxuesheng"
}

响应示例 · 成功示例#

{
  "created_at": "2026-01-20T07:16:38.094635957Z",
  "credits": 10,
  "duration": 5,
  "model": "audio1.0",
  "prompt": "雨滴落在窗户上的声音,伴随着轻柔的雷声",
  "seed": 0,
  "state": "created",
  "task_id": "911094612548939776"
}

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Body 参数application/json必填

示例
{
    "text": "人工智能正在改变我们的生活方式,从智能家居到自动驾驶,技术的进步让世界变得更加便利。",
    "voice_setting_voice_id": "male-qn-daxuesheng"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/ent/v2/audio-tts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "text": "人工智能正在改变我们的生活方式,从智能家居到自动驾驶,技术的进步让世界变得更加便利。",
    "voice_setting_voice_id": "male-qn-daxuesheng"
}'

返回响应

🟢200成功
application/json
OK
Bodyapplication/json

示例
{
    "code": 0,
    "message": "success",
    "data": {
        "task_id": "task_example_001"
    }
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:24
下一页
文生视频
Built with