clavue-tts · 公网 · 2026-09-11

clavue-tts · 怎么接、提示词怎么写

有声小说 / 演播 TTS。OpenAI 兼容 POST /v1/audio/speech，返回 audio/wav 24 kHz 单声道。中文。旧链 /tts/usage 仍可用。实时短句用 luxtts，不要用本页模型。写口播稿的 chat 打裸 27b/35b（零注入）；不要用 clavue-3-chat 写稿再喂给 TTS。

0. 三十秒上手

1. 每本书选一个 voice，model 用第 2 节同一行的分组名。
2. 为这本书写一条 instructions，按第 3 节四段模板填。
3. 把 (voice, instructions) 钉进这本书的配置，整本书每句都传同一对。
4. 开本前用第 6 节三句试听稿先出 3 条听一下，再批量。

1. 两个旋钮

2. 声音

集群别名：qwen3-tts-acted-ml / -fn / -rest。网关现只挂 8 路分片（3/7/12/13/19/21/22/31），主入口 :31801 已停，内网打 11401。api.clavue.com 不要用这三个分组名，那边 clavue-tts 仍只放行 Uncle_Fu / Vivian / Serena。

OpenAI 旧名 alloy/echo/onyx → 低磁男；nova/shimmer/fable → 演播女主。新书不要靠这些别名，写死上表名字。

3. instructions 四段式

• 60–120 字。
• 一本书一条，全书不换。 情绪变化靠正文标点和分句，不靠逐句改 instructions。
• 中文写。

出现下面任一词，整段被丢弃，退回默认演播腔：新闻播音 不要口语 不要气声 专名不吞字 数字读完整。旧系统给 TTS 加过这类通用后缀的，接入时去掉。

4. 按书型模板（改 ② 段即另一本书）

男声，一线旁白，能从冷切到暖。这部书偏现代都市、克制、句子短，怒短而冷，心疼压住，激昂不喊。禁止油腻气声，禁止播音腔，禁止耳语ASMR。吐字清楚。

男声，爆发、命令口吻。这部书冲突多、短句、停顿硬，怒在牙缝里，不吼麦。禁止中二拉长，禁止耳语ASMR，禁止播音腔。吐字清楚。

男声，中文低磁。这部书是悬疑，旁白慢、有距离、不下判断，怒不吼，嘲在气里。禁止日语腔，禁止阴森拖长气声，禁止耳语ASMR。吐字清楚。

男声，一线旁白。这部书是民国年代戏，字正、压着说、不油，怒短而冷，悲只在尾音。禁止播音腔，禁止耳语ASMR，禁止喊麦。吐字清楚。

女声，安抚、陪伴。这部书慢、稳、不甜腻，悲只在尾音，怒不破。禁止娃娃音，禁止撒娇，禁止耳语ASMR。吐字清楚。

女声，中文温柔细腻，能从软切到冷。这部书是都市言情，喜不尖，怒不破，笑意在气息里。禁止糯音，禁止萝莉，禁止耳语ASMR。吐字清楚。

女声，中文御姐，中低音有锋。这部书是职场商战，怒不破，嘲要短，喜不甜腻。禁止女王喊麦，禁止撒娇，禁止耳语ASMR。吐字清楚。

女声，古风剧配，抑扬有骨。这部书偏文言气息，怒不破，嘲不尖，悲只在尾音发颤。禁止现代甜宠，禁止戏曲腔，禁止耳语ASMR。吐字清楚。

5. 好 / 坏对照

6. 开本前三句试听

旁白：夜色压下来的时候，巷口只剩一盏灯。风把纸屑吹过石阶。
对白：她没有回头。这句话，他等了三年。
冲突：现在。立刻。把那份东西交出来。

听三点：像不像人设、有没有破音/喊麦、语速停顿是不是这本书的节奏。不对就改 ②③ 段。

7. 请求

POST https://ttkk.inping.com/v1/audio/speech
Authorization: Bearer sk-…
Content-Type: application/json

{
  "model": "clavue-tts-ml",
  "input": "她没有回头。这句话，他等了三年。",
  "voice": "jp-m-versatile",
  "instructions": "男声，一线旁白，能从冷切到暖。这部书偏现代都市、克制、句子短，怒短而冷。禁止油腻气声，禁止播音腔，禁止耳语ASMR。吐字清楚。",
  "response_format": "wav"
}

curl

curl -sS -m 300 -o out.wav \
  -H "Authorization: Bearer $CLAVUE_KEY" -H 'Content-Type: application/json' \
  -d '{"model":"clavue-tts-ml","input":"她没有回头。这句话，他等了三年。","voice":"jp-m-versatile","instructions":"男声，一线旁白，能从冷切到暖。这部书偏现代都市、克制、句子短，怒短而冷。禁止油腻气声，禁止播音腔，禁止耳语ASMR。吐字清楚。"}' \
  https://ttkk.inping.com/v1/audio/speech

Python（openai SDK）

from openai import OpenAI
client = OpenAI(base_url="https://ttkk.inping.com/v1", api_key=CLAVUE_KEY)

BOOK = dict(voice="jp-m-versatile",
            instructions="男声，一线旁白，能从冷切到暖。这部书偏现代都市、克制、句子短，怒短而冷。禁止油腻气声，禁止播音腔，禁止耳语ASMR。吐字清楚。")

r = client.audio.speech.create(model="clavue-tts-ml", input="她没有回头。这句话，他等了三年。",
                               response_format="wav", timeout=300, **BOOK)
r.write_to_file("out.wav")

8. 正文怎么给

• 一句到一小段，≤ 200 字。
• 标点控停顿：句号大停顿、逗号小停顿。想「短句利落」就真切短。
• 拟声词（门吱呀、脚步咔哒）写进正文即可，服务端会点一下即收；不要在 instructions 里要求「加音效」。
• 不要塞舞台提示「（愤怒地）」。

9. 不要做

• 不要用 clavue-tts 做耳语 ASMR——无效。见 ASMR。
• 不要每句随机换 voice / instructions。
• 不要把 child-f-sweet 接到成人书。
• 不要传 ref_audio 等克隆字段。
• 不要用 tts-1 / gpt-4o-mini-tts 这类别名接新书；只用 clavue-tts。