🎙️ 语音合成

提交文本和参考音频 URL，生成语音。

请求参数（JSON Body）

参数名	类型	必填	默认值	说明
text	string	✅ 是	-	要合成的文本，最大 5000 字符
prompt_audio_url	string	✅ 是	-	音色参考音频的 URL 地址（需公网可访问）
emo_control_method	string	否	same	情感控制方式：same / ref_audio / vector
emo_ref_url	string	否	-	情感参考音频 URL（ref_audio 方式时需要）
emo_weight	float	否	0.65	情感权重，范围 0~1
emo_vector	float[8]	否	全0	情感向量 [喜,怒,哀,惧,厌恶,低落,惊喜,平静]，各维度 0~1
temperature	float	否	0.8	采样温度 0.1~2.0，越高越随机
top_p	float	否	0.8	Nucleus 采样概率阈值 0~1
top_k	int	否	30	Top-K 采样，0=不限制
output_format	string	否	url	输出格式：url（返回音频 URL）/ base64

成功响应

{
  "code": 200,
  "message": "success",
  "data": {
    "audio_url": "https://tts.juchuang.cloud/outputs/tts_xxx.wav",
    "text": "你好，欢迎使用语音合成。",
    "text_length": 13,
    "cost": 0.0013,
    "balance": 9.9987
  }
}

错误码

code	HTTP	说明
200	200	✅ 成功
400	400	请求参数错误（缺少必填参数或格式错误）
401	401	API Key 无效或未提供
402	402	余额不足，请充值
403	403	账号已被禁用
500	500	服务器内部错误或 TTS 服务异常

cURL 示例

curl -X POST https://tts.juchuang.cloud/api/v1/tts \
  -H "X-API-Key: tts-a1b2c3d4e5f6789012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "你好，欢迎使用语音合成服务。",
    "prompt_audio_url": "https://example.com/reference.wav"
  }'

Python 示例

import requests

API_KEY = "tts-your-api-key"
API_URL = "https://tts.juchuang.cloud/api/v1/tts"

response = requests.post(API_URL,
    headers={
        "X-API-Key": API_KEY,
        "Content-Type": "application/json"
    },
    json={
        "text": "你好，欢迎使用语音合成服务。",
        "prompt_audio_url": "https://example.com/reference.wav"
    },
    timeout=120
)

result = response.json()
if result["code"] == 200:
    audio_url = result["data"]["audio_url"]
    print(f"生成成功！\n音频地址：{audio_url}\n消耗：¥{result['data']['cost']}")
    # 下载音频
    r = requests.get(audio_url)
    with open("output.wav", "wb") as f:
        f.write(r.content)
else:
    print(f"错误 [{result['code']}]: {result['message']}")

JavaScript / Node.js 示例

const API_KEY = "tts-your-api-key";
const API_URL = "https://tts.juchuang.cloud/api/v1/tts";

async function tts(text, promptAudioUrl) {
    const response = await fetch(API_URL, {
        method: "POST",
        headers: {
            "X-API-Key": API_KEY,
            "Content-Type": "application/json"
        },
        body: JSON.stringify({ text, prompt_audio_url: promptAudioUrl })
    });
    return await response.json();
}

// 使用示例
tts("你好世界", "https://example.com/voice.wav").then(console.log);

PHP 示例

📊 查询账户信息

查询当前 API Key 对应的账户余额和用量统计。

请求示例

curl -H "X-API-Key: tts-your-api-key" \
  https://tts.juchuang.cloud/api/v1/account

Python 示例

import requests

r = requests.get("https://tts.juchuang.cloud/api/v1/account",
    headers={"X-API-Key": "tts-your-api-key"}
)
print(r.json())
# { "code": 200, "data": { "username": "demo", "balance": 50.0, ... } }

返回示例

{
  "code": 200,
  "data": {
    "username": "demo",
    "balance": 50.00,
    "total_calls": 1234,
    "total_chars": 567890,
    "role": "user"
  }
}