HY 语音

文本

0 字符输入上限 1000 字符

模型

音色

格式

语速

语音结果

生成后的音频会显示在这里。

0 字节response_format=wav

准备就绪。

回车生成，Command+回车换行

对接信息

接口概览

Base URL	`$BASE_URL`
鉴权	`Authorization: Bearer <API_KEY>`
生成语音	`POST /v1/audio/speech`
音色列表	`GET /v1/audio/voices`
AI 模型列表	`GET /v1/models`
默认模型	`F5-TTS-Vietnamese-ViVoice`
备用模型	`VieNeu-TTS-v3-Turbo`

请求参数

字段	类型	必填	说明
`model`	string	否	`F5-TTS-Vietnamese-ViVoice` 或 `VieNeu-TTS-v3-Turbo`；省略时使用 F5-TTS。
`input`	string	是	只能传越南语文本；最多 1000 字符，建议 300-500 字符以内。
`voice`	string	否	默认 `Ngọc Linh` 女声；`Minh Đức` 男声。
`response_format`	string	否	`wav` 或 `mp3`，默认 `wav`。
`speed`	number	否	范围 0.5-2.0，默认 1。

生成语音示例

curl -X POST "$BASE_URL/v1/audio/speech" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{
    "model": "F5-TTS-Vietnamese-ViVoice",
    "input": "Xin chào, hôm nay bạn khỏe không?",
    "voice": "Ngọc Linh",
    "response_format": "wav",
    "speed": 1
  }' --output speech.wav

音色列表示例

curl "$BASE_URL/v1/audio/voices?model=VieNeu-TTS-v3-Turbo" \
  -H "Authorization: Bearer <API_KEY>"

{
  "data": [
    {"id": "Ngọc Linh", "name": "女声 · Ngọc Linh"},
    {"id": "Minh Đức", "name": "男声 · Minh Đức"}
  ]
}

生成接口返回 audio/wav 或 audio/mpeg 音频流。F5-TTS 使用 GPU 1 串行推理，最多允许 8 个在途请求；VieNeu-TTS v3 使用 CPU ONNX INT8 串行推理，最多允许 4 个在途请求。队列满时返回 HTTP 429。查询音色时可通过 model 参数选择模型。

CPU V3 请求示例

curl -X POST "$BASE_URL/v1/audio/speech" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API_KEY>" \
  -d '{
    "model": "VieNeu-TTS-v3-Turbo",
    "input": "Xin chào, hôm nay bạn khỏe không?",
    "voice": "Ngọc Linh",
    "response_format": "wav",
    "speed": 1
  }' --output speech-v3.wav

AI 模型列表

curl "$BASE_URL/v1/models" \
  -H "Authorization: Bearer <API_KEY>"

{
  "object": "list",
  "data": [
    {"id": "/workspace/HY-MT1.5-1.8B", "object": "model", "created": 1787529600, "owned_by": "hy"},
    {"id": "F5-TTS-Vietnamese-ViVoice", "object": "model", "created": 1787529600, "owned_by": "hynt"},
    {"id": "VieNeu-TTS-v3-Turbo", "object": "model", "created": 1787529600, "owned_by": "pnnbao-ump"}
  ]
}