语音合成（fish-tts）

POST

{{YOUR_BASE_URL}}/fish/v1/tts

最后修改时间：2025-07-15 11:22:24

责任人：未设置

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

response_format

string

必需

返回格式，默认为文件流

示例值:

url

Body 参数application/json

text

string

必需

最高支持5000字符，约2500汉子

reference_id

string

可选

模型id，可以由/fish/model接口克隆得到，示例为雷军的音色

chunk_length

integer

可选

format

string

可选

mp3_bitrate

integer

可选

normalize

boolean

可选

latency

string

可选

示例

{
    "text": "语音质量取决于模型。为获得最佳效果，请使用高质量模型。严禁合成涉及政治、色情、赌博、毒品等违法违规内容。", // 最高支持5000字符，约2500汉子
    "reference_id": "738d0cc1a3e9430a9de2b544a466a7fc", // 模型id，可以由/fish/model接口克隆得到，示例为雷军的音色
    "chunk_length": 200,
    "format": "mp3",
    "mp3_bitrate": 128,
    "normalize": true,
    "latency": "balanced"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '{{YOUR_BASE_URL}}/fish/v1/tts?response_format=url' \
--header 'Content-Type: application/json' \
--data-raw '{
    "text": "语音质量取决于模型。为获得最佳效果，请使用高质量模型。严禁合成涉及政治、色情、赌博、毒品等违法违规内容。", // 最高支持5000字符，约2500汉子
    "reference_id": "738d0cc1a3e9430a9de2b544a466a7fc", // 模型id，可以由/fish/model接口克隆得到，示例为雷军的音色
    "chunk_length": 200,
    "format": "mp3",
    "mp3_bitrate": 128,
    "normalize": true,
    "latency": "balanced"
}'

返回响应

🟢200成功

application/json

Body

_id

string

必需

state

string

必需

type

string

必需

model

string

必需

parameters

object

必需

text

string

必需

user_id

string

必需

created_at

string

必需

deleted

boolean

必需

channel

string

必需

finished_at

string

必需

result

string

必需

generate_error

boolean

必需

示例

{
    "_id": "d9a70f301b46411bb7370e88ecd17e42",
    "state": "finished",
    "type": "tts",
    "model": "738d0cc1a3e9430a9de2b544a466a7fc",
    "parameters": {
        "text": "语音质量取决于模型。为获得最佳效果，请使用高质量模型。严禁合成涉及政治、色情、赌博、毒品等违法违规内容。"
    },
    "user_id": "09a4d8ed4434477cbac20b6eb6712f8b",
    "created_at": "2024-10-25T07:22:28.532000+00:00",
    "deleted": false,
    "channel": "premium",
    "finished_at": "2024-10-25T07:22:30.721000+00:00",
    "result": "https://c97f3361a1c971323738e24f451a0225.r2.cloudflarestorage.com/fish-platform-data/task/d9a70f301b46411bb7370e88ecd17e42.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=45aaffe6f2c5f28b260e2165001da8ad%2F20241025%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20241025T072230Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=02d408ae5849823328eeede784001ca486cf41a9a3b5631269ad87fa98b6f3f8",
    "generate_error": false
}

修改于 2025-07-15 11:22:24

语音克隆（fish-tts-model）

创建语音