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

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

有声小说 / 演播 TTS。OpenAI 兼容 POST /v1/audio/speech，返回 audio/wav 24 kHz 单声道。中文。

接入
项值
Base URLhttps://ttkk.inping.com
端点POST /v1/audio/speech
鉴权Authorization: Bearer sk-…（面板发的 token）
modelclavue-tts（等价：clavue-tts-acted / qwen3-tts-acted）
超时客户端 ≥ 180 s。单句 10–60 s，排队时更长。按异步/任务队列接。

公网走的是 OpenAI 网关，字段名用 OpenAI 的：声音用 voice，风格用 instructions。内网直连时 speaker/instruct 也认，公网只认前者。

0. 三十秒上手

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

1. 两个旋钮

字段决定什么说明
voice是谁在说：音色、性别、底座人设书与书想听出明显不同，先换这个
instructions怎么说：这本书的年代、气质、节奏、情绪边界整段替换该声音的预设，不是追加。不传 = 默认演播腔
input正文一次一句到一小段，≤ 200 字

2. 声音

voice人设建议用在
jp-m-versatile男 · 冷/暖两用一线旁白新书男主 / 男旁白默认
jp-m-burst男 · 爆发、命令、短句爽文冲突、军令、对峙、反派
novel-m-lead男 · 原一线男主旧书保持一致
jp-m-low男 · 低磁、有距离悬疑、冷叙事
jp-f-heal女 · 安抚、慢、稳治愈、陪伴
novel-f-acted女 · 原演播女主常规女主 / 女旁白（默认）
jp-f-soft女 · 温柔细腻，能切冷言情
jp-f-oneesan女 · 御姐强势女、职场
drama-f-guofeng女 · 古风有骨古言、仙侠
child-f-sweet女 · 成人讲睡前故事仅儿童故事，忽略 instructions

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

3. instructions 四段式

① 性别+底座人设，② 这本书的年代/气质，③ 节奏与情绪边界。④ 红线
段写什么例子
①性别 + 与 voice 一致的人设。不要和 voice 打架男声，一线旁白，能从冷切到暖
②这本书独有的：年代、题材、气质。差异的来源这部书偏现代都市、克制 / 这部书是民国谍战，压着说
③节奏 + 情绪上限。写边界（「怒不吼」），不写形容词（「有感情」）句子短，怒短而冷，心疼压住，激昂不喊
④直接抄禁止耳语ASMR，禁止喊麦破音，禁止播音腔。吐字清楚。

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

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

都市冷感男主 · jp-m-versatile 
男声，一线旁白，能从冷切到暖。这部书偏现代都市、克制、句子短，怒短而冷，心疼压住，激昂不喊。禁止油腻气声，禁止播音腔，禁止耳语ASMR。吐字清楚。
爽文 / 对峙 · jp-m-burst 
男声，爆发、命令口吻。这部书冲突多、短句、停顿硬，怒在牙缝里，不吼麦。禁止中二拉长，禁止耳语ASMR，禁止播音腔。吐字清楚。
悬疑 / 冷叙事 · jp-m-low 
男声，中文低磁。这部书是悬疑，旁白慢、有距离、不下判断，怒不吼，嘲在气里。禁止日语腔，禁止阴森拖长气声，禁止耳语ASMR。吐字清楚。
民国 / 年代 · jp-m-versatile 
男声，一线旁白。这部书是民国年代戏，字正、压着说、不油，怒短而冷，悲只在尾音。禁止播音腔，禁止耳语ASMR，禁止喊麦。吐字清楚。
治愈 / 陪伴女 · jp-f-heal 
女声，安抚、陪伴。这部书慢、稳、不甜腻，悲只在尾音，怒不破。禁止娃娃音，禁止撒娇，禁止耳语ASMR。吐字清楚。
言情女主 · jp-f-soft 
女声，中文温柔细腻，能从软切到冷。这部书是都市言情，喜不尖，怒不破，笑意在气息里。禁止糯音，禁止萝莉，禁止耳语ASMR。吐字清楚。
强势女 / 职场 · jp-f-oneesan 
女声，中文御姐，中低音有锋。这部书是职场商战，怒不破，嘲要短，喜不甜腻。禁止女王喊麦，禁止撒娇，禁止耳语ASMR。吐字清楚。
古言 / 仙侠 · drama-f-guofeng 
女声，古风剧配，抑扬有骨。这部书偏文言气息，怒不破，嘲不尖，悲只在尾音发颤。禁止现代甜宠，禁止戏曲腔，禁止耳语ASMR。吐字清楚。

5. 好 / 坏对照

instructions问题
✗要有感情，好听一点没有性别、人设、边界，等于没传
✗男声，新闻播音，不要气声命中新闻词，整段被丢
✗女声御姐…（voice 却是 jp-m-burst）与底座打架，音色会飘
✗300 字书简介后半段被忽略
✓男声，一线旁白，能从冷切到暖。这部书偏现代都市、克制、句子短，怒短而冷。禁止油腻气声，禁止播音腔，禁止耳语ASMR。吐字清楚。四段齐

6. 开本前三句试听

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

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

7. 请求

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

{
  "model": "clavue-tts",
  "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","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", input="她没有回头。这句话，他等了三年。",
                               response_format="wav", timeout=300, **BOOK)
r.write_to_file("out.wav")

8. 正文怎么给

9. 不要做