让你的 Agent
开口说话。

export TTS_CLIENT_ID="由服务提供方单独提供"
export TTS_CLIENT_SECRET="由服务提供方单独提供"

curl --fail-with-body --no-buffer https://tts.heang.top/v1/audio/speech \
  -H "CF-Access-Client-Id: $TTS_CLIENT_ID" \
  -H "CF-Access-Client-Secret: $TTS_CLIENT_SECRET" \
  -H "User-Agent: BreezeAgent/1.0" \
  -H "Content-Type: application/json" \
  -d '{"input":"你好，欢迎来到我的直播间。","instructions":"温柔自然的成年女性，用普通话亲切地说话。","response_format":"pcm","cfg_scale":1,"max_new_tokens":500}' \
  --output speech.pcm

# 可选：使用 ffplay 边接收边播放时，将 --output speech.pcm 替换为：
# --output - | ffplay -nodisp -autoexit -f s16le -ar 24000 -ac 1 -i -

curl --fail-with-body https://tts.heang.top/health \
  -H "User-Agent: BreezeAgent/1.0" \
  -H "CF-Access-Client-Id: $TTS_CLIENT_ID" \
  -H "CF-Access-Client-Secret: $TTS_CLIENT_SECRET"

# 正常响应包含：{"status":"ok","sample_rate":24000}

# Python 3.10+，仅使用标准库。密钥先设置到环境变量。
import json, os, urllib.request, wave

request = urllib.request.Request(
    "https://tts.heang.top/v1/audio/speech",
    data=json.dumps({
        "input": "你好，这是流式语音合成测试。",
        "instructions": "自然、清晰、温暖的成年女声。",
        "response_format": "pcm",
        "cfg_scale": 1,
        "max_new_tokens": 500,
    }).encode("utf-8"),
    headers={
        "Content-Type": "application/json",
        "User-Agent": "BreezeAgent/1.0",
        "CF-Access-Client-Id": os.environ["TTS_CLIENT_ID"],
        "CF-Access-Client-Secret": os.environ["TTS_CLIENT_SECRET"],
    },
)
with urllib.request.urlopen(request, timeout=180) as response:
    if "audio" not in response.headers.get("Content-Type", ""):
        raise RuntimeError("服务未返回音频，请检查认证和响应内容")
    with wave.open("speech.wav", "wb") as audio:
        audio.setnchannels(1)
        audio.setsampwidth(2)
        audio.setframerate(24000)
        while chunk := response.read1(4096):
            # 实时播放：将 chunk 交给 PCM 播放队列，勿等待整个请求结束。
            audio.writeframesraw(chunk)
# wave 自动写入正确的文件长度；不要把 .pcm 直接改名为 .wav。

// Node.js 22+；保存为 speech.mjs 后执行 node speech.mjs。
import { createWriteStream } from "node:fs";
import { Readable } from "node:stream";
import { pipeline } from "node:stream/promises";

const response = await fetch("https://tts.heang.top/v1/audio/speech", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "User-Agent": "BreezeAgent/1.0",
    "CF-Access-Client-Id": process.env.TTS_CLIENT_ID,
    "CF-Access-Client-Secret": process.env.TTS_CLIENT_SECRET,
  },
  body: JSON.stringify({
    input: "你好，我正在实时生成语音。",
    instructions: "温暖、自然的成年男声。",
    response_format: "pcm", cfg_scale: 1, max_new_tokens: 500,
  }),
  signal: AbortSignal.timeout(180000),
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
if (!response.headers.get("content-type")?.includes("audio")) {
  throw new Error("Expected audio response");
}
await pipeline(Readable.fromWeb(response.body), createWriteStream("speech.pcm"));
// 实时应用可逐块读取 response.body，并交给播放器。