Seedance 2.5 is live — 30-second cinematic video with native audio & real-person references

变声 API — 基于 Voice Pack 的人声转换

用已配置的 voice pack 转换源人声。变声 API 支持口音强度、音色参考来源以及异步输出交付。

模型特点
音色包 · 变声强度可调
适用场景
旁白、角色配音、配音
输入
音频文件 URL + 音色包
输出
转换后音频
Input
0/1 file

MP3 / WAV / AAC / OGG

必填

0 到 1 任意数值;默认 1

source_file 或 voice_pack

可选

mp3、wav、flac、aac 或 ogg

Result

你能用这个模型做什么

可以用这个模型构建并上线的真实工作流与生产级用例。

人声录音被转换成目标 voice pack 的音色

变声 API 做 Voice Pack 转换

当产品已经有现成的目标 voice pack id,需要通过异步后端调用转换源人声时,就用变声 API。用户在产品里选好 pack,后端带上 voice_pack_id 提交任务,完成后返回 converted_mix 输出。适合音色选择发生在自家产品里、再触发音频处理的场景。变声 API 把音频任务聚焦在转换本身,pack 浏览与权限由你的应用负责。

转换音色
口音与音色的调节控件

变声 API 的口音与音色控制

把 accent 设在 0 到 1 之间,再在 source_file 与 voice_pack 之间选择音色来源。变声 API 给产品团队几个清晰的旋钮,而不是一整套复杂的音频编辑器。这样表单对非工程师也容易理解。UI 可以先暴露简单默认值,进阶用户只调他们懂的字段。当产品需要一条引导式 voice-pack 流程,而不是完整编辑界面时,这套接口特别合适。

voice pack 资源库连接到音频转换任务

变声 API 接入发布工作流

完成后的变声任务会以可下载的轨道形式返回转换后的人声。可以直接存下、预览,或送进审核与发布流水线。当轨道带标签时,output.tracks 可以标出 converted_mix。

价格

积分计费 — 1 积分 = 0.001 美元,仅为成功生成付费。

首次测试成本
$0.2200 credits

最低档一次生成(1 started minute)。

测试预算参考
充值积分
$10
约 50 次测试
$50
约 250 次测试
$100
约 500 次测试
模型类别价格
声音转换源人声
$0.2
200 credits · 1 started minute

为什么选 reAPI

为什么变声 API 必须传 voice_pack_id

变声 API 把 voice_pack_id 作为必填,确保每次任务都精确对应到产品选中的某个 voice 资源。这样转换行为始终绑定到一个已知 pack 上,pack 选择也不必塞进音频上传本身。

控件小,覆盖面够

accent 用真正的 0–1 数值,tonality_reference 接受 source_file 或 voice_pack。这两个字段已经覆盖最常见的风格选择,不会把用户埋进一堆音频术语里。提交的值要随任务一起存下来,方便客服和审核团队后续复现结果。

同一套轮询契约

提交任务、轮询 /api/v1/tasks/:id 直到完成。变声 API 与其它 reAPI 音频接口走的是同一个异步模型。后端可以复用现有的任务存储、重试和结果处理逻辑。UI 把 queued、processing、completed、failed 四种状态展示清楚时效果最好。

三步接入变声 API

  1. step 01

    创建 API key

    在 reAPI 工作空间设置里生成一把 key。把变声 API 调用放在后端,voice pack id 和 key 都留在服务端。

    打开
  2. step 02

    提交转换任务

    POST model audio-voice-change,带上 audio_url 和 voice_pack_id。需要时再加 accent、tonality_reference、dereverb_enabled 或 encoder_format。

    打开
  3. step 03

    轮询并播放结果

    GET /api/v1/tasks/:id 直到 completed。下载 output.audio_urls,或用 output.tracks 找到 converted_mix 轨。

    打开
docs/api/voice-changer

API 参考

复制即用的代码片段与完整参数表。

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"audio-voice-change","audio_url":"https://cdn.example.com/source-vocal.wav","voice_pack_id":"voice_pack_id_here","accent":1,"encoder_format":"mp3"}'

参数校验失败

提交时同步拒绝并指明出错字段。检查枚举值、范围与 URL 字段——不产生任何扣费。

认证或余额问题

401 表示 Bearer 密钥缺失或无效;402 表示预扣额超出余额。密钥与积分在控制台管理。

内容或素材被拒

参考素材与生成结果都会经过自动审核。被拒的任务返回明确错误并全额退款。

任务失败或超时

进入失败状态的任务不会扣费——预扣自动退还。保留任务 ID,随时可重试。

常见问题

关于此模型的常见疑问。

变声 API 是一个异步声音转换接口。传入一段源人声 audio_url 和必填的 voice_pack_id,然后轮询直到 converted_mix 音频输出可用。当产品需要 voice pack 转换、又不想自己造一整套编辑器时就用它。

start building

准备好上线了吗?

在 Playground 中试用,或直接获取 API Key 立即接入。