高保真语音台 短剧配音一句话一个角色

本包不内嵌 Key:用你自己在 api.a7w.cn 注册的 Key,扣你自己的余额。填 Key:python3 scripts/a7w.py login --key sk-你的key。

一句话

一个剧本进去,五种声音出来。 三人对手戏、五人群戏、播客双人、有声书独白 —— 8 个语音接口一条命令,零依赖。

三条音色线,一眼选对

音色线用哪个音色什么时候上
ElevenLabs 多语言 V2--line v267音质标杆。单人旁白、预告片、有声书,情绪 / 稳定性 / 相似度都能拧
ElevenLabs Turbo 2.5--line turbo67同一套音色,出得更快;唯一能用 --language-code 强制语言的档
Gemini 对话式--line gemini38 / gemini38lite / gemini25pro70 / 70 / 30会接话。逐句给语气、两人对话加语气词、2.5 Pro 还能换口音和语速
python3 scripts/run.py speak --line v2    --text "你终于来了。" --voice James --yes
python3 scripts/run.py speak --line turbo --text "你终于来了。" --voice James --language-code zh --yes

dialogue 怎么用 —— 本包和普通 TTS 最大的区别

普通 TTS 是「一段文本一个音色」,跑五个人得发五次、拼五次。V3 的 dialogue 是数组,每句自带 voice,一次请求出整段对手戏:

{"dialogue": [
  {"text": "你终于来了。",   "voice": "EkK5I93UQWFDigLMpZcX"},
  {"text": "我一直在等你。", "voice": "Z3R5wn05IrDiVCyEkUrK"}
]}

传成字符串会被挡回来(实测原文 {"code":0,"msg":"input.dialogue: 类型不正确","data":null})。所以本包用 --voices 分音色、--turn 或剧本文件给台词,组装交给我:

python3 scripts/run.py dialogue --voices "林晚=James" --voices "沈砚=Arabella" \
    --turn "林晚: 你终于来了。" --turn "沈砚: 我一直在等你。" --yes

规则三条:所有台词加起来 ≤ 5000 字符、每个角色必须分到音色、voice 只能是 67 个 ID 之一(写名字自动换)。

一条完整链路:剧本 → 分角色 → 配音 → 时间戳 → 对齐字幕

# 1) 剧本存成 UTF-8,一行一句「角色: 台词」(# 开头是注释):林晚: 你终于来了。
# 2) 干跑:只看请求体,不发请求、不冻结
python3 scripts/run.py dialogue --script 剧本.txt \
    --voices "林晚=James" --voices "沈砚=Arabella" --dry-run

# 3) 真跑:一次出完整段对手戏
python3 scripts/run.py dialogue --script 剧本.txt \
    --voices "林晚=James" --voices "沈砚=Arabella" --yes

# 4) 逐句要时间戳(v2 / turbo 的 --timestamps),拿去对齐字幕
python3 scripts/run.py speak --line v2 --text "你终于来了。" --voice James --timestamps --yes

# 5) 拿到任务号就追结果
python3 scripts/run.py task --task-id task_xxx

各线的返回结构不完全一样,包里把 taskId 和所有音频地址都打出来;--json 固定给 taskId 与 audioUrls 两个键,写脚本照这两个取。

三步上手

python3 scripts/run.py doctor                  # 1) 自检:Key / 应用 / 8 端点 / 价目口径,默认零 POST
python3 scripts/run.py voices --line v2        # 2) 挑音色:67 个 ID(3.8 有 70 个名字,Omni 30 个)
python3 scripts/run.py cost                    # 3) 先算钱:下限 60 点/条
python3 scripts/run.py speak --text "你终于来了。" --voice James --yes

价目(1 元 = 100 点)

项值

三条别人不会告诉你的

一、voice 是 ID,不是名字。 67 个 20 位 ID 写在枚举里,名字只在字段说明文字里。传 "James" 出去会回 input.voice: 不在允许选项内。本包 --voice James 自动换成 EkK5I93UQWFDigLMpZcX,重名(Mark / Hope / Viraj 各两个)取第一个并告一声。

二、校验失败也是 HTTP 200。 {"code":0,"msg":"input.xxx: …","data":null} —— 状态码没有区分度,判成功只能看 code == 1。Gemini 三条线遇类型错更直接:HTTP 500「服务内部错误」,同样不建单,冻结的 60 点原路退回(refund:sync_error)。

三、2.5 Pro 的音色表和 3.8 不一样。 3.8 有 70 个 voice_name,2.5 Pro 只有 30 个,而且 accent 必填(默认 Neutral)。拿 3.8 的名字打 2.5 Pro 会白跑,本包按线在本地校验,报错时一个请求都没发。

常用命令

python3 scripts/run.py catalog                                    # 8 条线 + 接口 code + 音色数
python3 scripts/run.py voices --line gemini38                     # 70 个音色 + 40 个语气标签
python3 scripts/run.py speak --text "…" --voice Arabella --speed 0.9 --stability 0.4 --yes
python3 scripts/run.py scene --line gemini38 --cast "1=Kore" --cast "2=Fenrir" --turn "1: 门外有人。" --turn "2: <whispering> 别开门。" --filler-words --yes
python3 scripts/run.py scene --line gemini25pro --cast "1=Kore" --accent "British (RP)" --turn "1: 门开了。" --scene "A quiet room with a fireplace." --yes
python3 scripts/run.py design --name "深夜电台-阿岚" --audio-id achernar --yes
python3 scripts/run.py task --task-id task_xxx

不加 --yes 退 4 并告诉你这次下限多少点;下限 > --budget 退 5,一个请求都不发(--budget 单位是点,默认 600 = 6 元)。

参数

参数默认说明
--linev2speak 用 v2 / turbo;scene 用 gemini38 / gemini38lite / gemini25pro
--text / --text-file—单人台词,≤ 5000 字符(UTF-8)
--voice必填音色 ID 或名字(67 个,见 voices)
--turn / --script—「角色: 台词」重复给,或整份剧本文件
--voices / --cast必填角色=音色(V3 用 --voices,Gemini 用 --cast)
--timestamps—v2 / turbo 顺带要逐词时间戳
--budget600点数上限(单位:点,1 元 = 100 点)
--yes / --dry-run—确认真实建单 / 只打印请求

子命令

子命令扣费吗干什么
catalog / voices / cost免费8 条线 / 音色库 / 下限估算
doctor免费自检(默认零 POST;--probe-post 才碰端点,每条冻 60 后退回,净 0)
speak / dialogue / scene计费单人 / 多人对白 / 场景对话
design / character计费造音色 / 造角色
task / log免费查任务 / 本地台账

退出码

0 成功 / 2 用法错(缺参数、音色不在表里、选项缩写)/ 3 doctor 出现 × / 4 没给 --yes / 5 预算不足(一个请求都不发)/ 6 调用失败 / 1 内部错 / 130 中断。

--json 契约

{"ok": true, "line": "v2", "code": "elevenlabs_text_to_speech_multilingual_v2",
 "taskId": "task_xxx", "audioUrls": ["https://…"], "estimatedPoints": 60}

失败:{"ok": false, "exit": 5, "error": {"kind": "budget", "message": "…"}},kind 取 usage|gate|confirm|budget|call|interrupt|internal。--json 写在子命令前后都可以,stdout 只有一个 JSON 文档。

联系我们

  • 技术微信:9872659 —— 加好友时说一下是从哪个 Skill 找过来的,直接给你配套的 API Key 与能跑的示例。
  • 要算力 / 要 API Key:算力集市 · 注册领 API Key —— 一个 Key 调用全部 AI 算力,注册、充值、创建 Key 都在这里。
  • 更多 AI 插件与接口:AI 插件市场。

同类文章