LEAPERone 文档

语音合成 API

POST /v1/audio/speech 参考,涵盖 TTS 模型、音色、音频响应格式、请求示例、定价和身份认证。

把文本合成为语音音频。支持预设音色和自定义声音克隆。

端点

POST https://api.leaper.one/v1/audio/speech

模型

模型价格说明
moss-tts-nano0.005 点数 / 1K 字符支持声音克隆的多语言 TTS

参数

JSON Body(预设音色)

参数类型必填说明
modelstring使用的模型。默认:"moss-tts-nano"
inputstring要合成的文本,最多 4096 个字符
voicestring预设音色名称。默认:"nova"(中文)。参阅可用音色
response_formatstring输出格式:"wav""pcm"。默认:"wav"

Multipart Form(声音克隆)

参数类型必填说明
modelstring使用的模型。默认:"moss-tts-nano"
inputstring要合成的文本,最多 4096 个字符
voicestring预设音色名称,作为克隆的基础音色
prompt_audiofile声音克隆参考音频,最大 1MB。支持 mp3、wav、flac、m4a、ogg
response_formatstring输出格式:"wav""pcm"。默认:"wav"

请求

使用预设音色

curl -X POST https://api.leaper.one/v1/audio/speech \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moss-tts-nano",
    "input": "Hello, welcome to LEAPERone.",
    "voice": "alloy"
  }' \
  --output speech.wav

使用自定义音频克隆声音

curl -X POST https://api.leaper.one/v1/audio/speech \
  -H "Authorization: Bearer sk-your-api-key" \
  -F model=moss-tts-nano \
  -F input="This text will be spoken in the cloned voice." \
  -F voice=alloy \
  -F [email protected] \
  --output cloned.wav

使用 OpenAI SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://api.leaper.one/v1",
    api_key="sk-your-api-key"
)

response = client.audio.speech.create(
    model="moss-tts-nano",
    input="Hello, welcome to LEAPERone.",
    voice="alloy"
)
response.stream_to_file("speech.wav")

声音克隆必须使用 multipart/form-data 上传参考音频。OpenAI SDK 不支持这种请求,请使用 curl 或自定义 HTTP 请求。

响应

接口直接返回音频字节。Content-Type 响应头表示音频格式:

格式Content-Type
wavaudio/wav
pcmapplication/octet-stream

PCM 是 48kHz、16-bit、双声道的原始音频。

可用音色

兼容 OpenAI 的别名

音色语言风格
alloy英语欢迎 / 中性
echo英语新闻播报
fable英语温和提醒
onyx英语学术 / 讲座
nova中文欢迎 / 中性
shimmer中文轻柔 / 温和

中文音色

音色风格
zh-welcome中性欢迎
zh-gentle深夜轻柔
zh-taiwan台湾口音
zh-beijing北京方言
zh-culture正式 / 文化
zh-yangmi名人音色

英文音色

音色风格
en-welcome中性欢迎
en-lesson学术讲座
en-news新闻播报
en-gentle温和提醒
en-taylor名人音色
en-quiet平静 / 沉思

其他语言

音色语言
ja-news日语
ko-news韩语
es-news西班牙语
fr-news法语
de-news德语
it-news意大利语
ru-news俄语

还可以直接传入 demo-1demo-29,使用全部 MOSS 预设音色。

注意事项

  • 按字符数计费,每 1,000 个字符 0.005 点数。
  • 声音克隆使用 CPU 推理,速度明显慢于预设音色。短文本通常需要 20-60 秒。
  • prompt_audio 应使用清晰的人声样本,建议时长为 5-15 秒。
  • 输入最多 4,096 个字符。