一定要传 voice_pack_id 吗？

是的。变声 API 强制要求 voice_pack_id，因为每次转换都必须有一个明确的目标 pack。应用应当在提交音频任务前就收集或存好这个 id，然后从后端连同源音频 URL 一起送出。除非用户在开发者控制台里，否则不要让他们自己手输这个 id。

变声 API 的 accent 怎么用？

accent 接受 0 到 1 之间的任意数值。值越低越保留源口音，为 1 时完全应用 voice pack 的口音。Playground 会在提交前校验取值范围，避免发送非法值。产品 UI 里把它当滑动条，而不要做成自由文本框。

tonality_reference 控制什么？

tonality_reference 告诉变声 API：音色行为应该跟随 source_file 还是 voice_pack。希望偏向源音的转换就保持 source_file；希望目标 pack 主导音色就选 voice_pack。只在用户能理解目标 voice pack 并愿意仔细对比结果时，才把两个选项都暴露给他们。

变声 API 返回什么？

任务成功后会返回可下载的音频 URL。当轨道带标签时，output.tracks 会包含 converted_mix——也就是应用要播放或保存的转换后人声。变声 API 也支持请求 mp3、wav、flac、aac 或 ogg 输出。预览器用标签做映射，下载和存储策略按所选格式来。

变声 API 怎么收费？

变声 API 按向上取整后的源音频分钟计费，每起算分钟 200 credits（$0.20）。45 秒的人声文件按 1 起算分钟计，95 秒的文件按 2 起算分钟计。长文件提交前把估算放到提交按钮旁边，用户才能理解向上取整这条规则。

变声 API 的参考文档在哪里？

完整参数表和 cURL 示例在 /docs/voice-changer。用 POST /api/v1/audio/generations 创建转换任务、GET /api/v1/tasks/:id 轮询完成。文档详细列出了 voice_pack_id、accent、tonality_reference、dereverb 和输出格式。服务日志里用同样的字段名，失败请求就容易追。文档也写清楚了哪些字段是必填、哪些可以走默认值。

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

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

价格

est$0.2– $0.2按起算分钟计费

试用变声查看变声文档

01playground

InputsPOST /api/v1/audio/generations

源音频*

Drag audio here or click to uploadMP3 / WAV / AAC / OGG · max 20 MB · up to 1 file

MP3 / WAV / AAC / OGG

Voice Pack ID*

必填

口音强度

0 到 1 任意数值；默认 1

音色参考

source_file 或 voice_pack

去混响

可选

输出格式

mp3、wav、flac、aac 或 ogg

Outputidle

no output

Run Generate to see results.

02use cases

你能用它做什么

由此模型驱动的真实工作流。

01/case

变声 API 做 Voice Pack 转换

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

转换音色

02/case

变声 API 的口音与音色控制

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

03/case

变声 API 接入发布工作流

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

03pricing

价格

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

模式	类别	单位	价格
声音转换
└	源人声	1 started minute	$0.2 200 credits

05why

为什么选 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 四种状态展示清楚时效果最好。

06quickstart

三步接入变声 API

step 01
创建 API key
在 reAPI 工作空间设置里生成一把 key。把变声 API 调用放在后端，voice pack id 和 key 都留在服务端。
打开
step 02
提交转换任务
POST model audio-voice-change，带上 audio_url 和 voice_pack_id。需要时再加 accent、tonality_reference、dereverb_enabled 或 encoder_format。
打开
step 03
轮询并播放结果
GET /api/v1/tasks/:id 直到 completed。下载 output.audio_urls，或用 output.tracks 找到 converted_mix 轨。
打开

07faq

常见问题

关于此模型的常见疑问。

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

09api reference

docs/api/voice-changer

API 参考

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

查看完整参考文档

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_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"}'

start building

准备好上线了吗？

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

试用变声获取 API Key

你能用它做什么

由此模型驱动的真实工作流。

01/case