Indextts Voice_设计多媒体 skill-PHP中文网

Indextts Voice

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

IndexTTS 语音克隆与合成：创建声音模型、文本转语音、参考音频管理（仅限企业会员）

IndexTTS 语音克隆与合成技能

功能概述

IndexTTS 语音克隆与合成技能是一项面向实际任务的技能，主要用于IMPORTANT]；⚠️ 企业会员专属技能；

核心要点

本技能需要 IndexTTS 企业会员才能使用；
API 签名；
仅企业会员可获得；

使用与执行

访问官网 → 会员中心 → 购买企业会员；使用网页版进行声音克隆和语音合成（无需 API）；请访问官网或联系客服；未购买企业会员请勿安装此技能！IndexTTS 是一个专业的语音克隆和语音合。

结果检查与注意事项

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

IndexTTS 语音克隆与合成技能

[!IMPORTANT]

⚠️ 企业会员专属技能

本技能需要 IndexTTS 企业会员才能使用

项目说明

API 签名 仅企业会员可获得

官方网站 https://indextts.cn

购买方式 访问官网 → 会员中心 → 购买企业会员

免费替代 使用网页版进行声音克隆和语音合成（无需 API）

价格咨询 请访问官网或联系客服

未购买企业会员请勿安装此技能！

项目	说明
API 签名	仅企业会员可获得
官方网站	https://indextts.cn
购买方式	访问官网 → 会员中心 → 购买企业会员
免费替代	使用网页版进行声音克隆和语音合成（无需 API）
价格咨询	请访问官网或联系客服

技能描述

IndexTTS 是一个专业的语音克隆和语音合成 API 服务。本技能提供完整的命令行接口，支持声音模型管理、异步语音合成、参考音频管理、配额查询等核心功能。

适用场景

创建声音克隆模型（基于 2-60 秒的音频样本）
管理已创建的语音模型（列表查询、详情、删除）
使用克隆的声音进行文本转语音（TTS）
上传/管理语调参考音频（用于情感合成，24 小时有效）
查询合成任务状态和下载音频
查询用户剩余配额/额度

环境要求

Python 3.6+
requests 库
需要设置环境变量 INDEX_API_SIGN（API 签名，需企业会员）

安装依赖

pip install requests

配置环境变量

Windows PowerShell

$env:INDEX_API_SIGN='你的 API 签名'
$env:INDEX_BASE_URL='https://openapi.lipvoice.cn'

Windows CMD

set INDEX_API_SIGN=你的 API 签名
set INDEX_BASE_URL=https://openapi.lipvoice.cn

永久设置（推荐）

将环境变量添加到系统环境变量中，或写入脚本自动加载。

API 签名获取

📌 企业会员专属

API 签名是 IndexTTS 企业会员的专属功能，用于通过 API 调用语音合成服务。

获取步骤：

访问 https://indextts.cn

注册/登录账户

购买企业会员服务（在会员中心）

进入「开发者中心」或「API 管理」

复制 API 签名/密钥

价格咨询： 请访问 IndexTTS 官网查看企业会员价格

免费替代方案： 如不需要 API 调用，可直接使用网页版进行声音克隆和语音合成。

命令参考

一、声音模型管理

1. 创建声音模型

python scripts/indextts_api.py create-model "模型名称" "音频文件路径" [--describe "描述"]

参数说明：

模型名称 - 自定义模型名称（必需）
音频文件路径 - MP3/WAV/M4A 格式，<50MB，时长 2-60 秒（必需）
--describe - 模型描述（可选）

示例：

python scripts/indextts_api.py create-model "我的旁白声" "C:/Users/yanyu/Desktop/voice.wav" --describe "温暖男声"

返回：

{
  "code": 0,
  "data": {
    "audioId": "ABuVg22s3ydwS7RtkVyVN86Egq",
    "name": "我的旁白声",
    "describe": "温暖男声"
  },
  "msg": "成功"
}

2. 查询模型列表

python scripts/indextts_api.py list-models [--page 1] [--page-size 10]

参数说明：

--page - 页码，默认 1
--page-size - 每页条数，默认 10，最大 20

示例：

python scripts/indextts_api.py list-models --page 1 --page-size 20

3. 查询模型详情

python scripts/indextts_api.py get-model

参数说明：

audioId - 模型 ID（从 list-models 获取）

示例：

python scripts/indextts_api.py get-model ABuVg22s3ydwS7RtkVyVN86Egq

注意： 此接口可能未在所有账户中开放，如返回 404 请使用网页版查看模型详情。

4. 删除模型

python scripts/indextts_api.py delete-model

参数说明：

audioId - 模型 ID（必需）
注意： 删除后数据不可恢复

示例：

python scripts/indextts_api.py delete-model ABuVg22s3ydwS7RtkVyVN86Egq

二、语调参考音频管理（用于情感合成）

重要说明：

参考音频用于 genre=1（语气参考）模式下的情感语音合成
上传的参考音频仅保存 24 小时，过期自动清理
最多上传 30 个 参考音频，每个 < 50MB

5. 上传参考音频

python scripts/indextts_api.py upload-tts-reference "音频文件路径"

参数说明：

音频文件路径 - MP3/WAV/M4A 格式，<50MB（必需）

示例：

python scripts/indextts_api.py upload-tts-reference "C:/Users/yanyu/Desktop/emotion_sample.wav"

返回：

{
  "code": 0,
  "data": {
    "file": {
      "emotionPath": "1cb251ec0d568de6a929b520c4aed8d1_20260401104924.wav"
    }
  },
  "msg": "上传成功"
}

6. 查询参考音频列表

python scripts/indextts_api.py list-tts-references [--page 1] [--page-size 10]

参数说明：

--page - 页码，默认 1
--page-size - 每页条数，默认 10，最大 30

示例：

python scripts/indextts_api.py list-tts-references

返回：

{
  "code": 0,
  "data": {
    "list": [
      {
        "emotionPath": "1cb251ec0d568de6a929b520c4aed8d1_20260401104924.wav",
        "name": "text.mp3",
        "createdAt": "2026-04-01T10:49:24.147+08:00"
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 10
  },
  "msg": "获取成功"
}

7. 删除参考音频

python scripts/indextts_api.py delete-tts-reference

参数说明：

emotionPath - 参考音频名称（从 list-tts-references 获取，必需）

示例：

python scripts/indextts_api.py delete-tts-reference "1cb251ec0d568de6a929b520c4aed8d1_20260401104924.wav"

三、语音合成（TTS）

8. 语音合成

python scripts/indextts_api.py tts-create "文本内容"  [选项]

参数说明：

文本内容 - 要合成的文字，最大 5000 字符（必需）
audioId - 模型 ID（必需）
--style - 模型版本：1=基础 (默认) 2=专业 3=多语言
--speed - 语速：0.5-1.5，默认 1.0
--genre - 模型类别（必需）
- 0 = 参考原音频（默认，支持所有模型）
- 1 = 语气参考模式（仅专业模型，使用情感参数）
- 2 = 使用参考音频（仅专业模型，需要 emotionPath）
--emotion-path - 参考音频路径（genre=2 时必需，从 list-tts-references 获取）
--happy - 开心程度 (0-1，genre=1 时使用)
--angry - 愤怒程度 (0-1，genre=1 时使用)
--sad - 悲伤程度 (0-1，genre=1 时使用)
--afraid - 恐惧程度 (0-1，genre=1 时使用)
--disgusted - 厌恶程度 (0-1，genre=1 时使用)
--melancholic - 忧郁程度 (0-1，genre=1 时使用)
--surprised - 惊讶程度 (0-1，genre=1 时使用)
--calm - 平静程度 (0-1，genre=1 时使用)

示例：

# 基础合成（genre=0）
python scripts/indextts_api.py tts-create "你好，这是测试文本" ABuVg22s3ydwS7RtkVyVN86Egq

# 使用情感参数合成（genre=1，需要专业模型 style=2）
python scripts/indextts_api.py tts-create "太棒了！" ABuVg22s3ydwS7RtkVyVN86Egq `
  --style 2 --genre 1 --happy 0.8 --speed 1.1

# 使用参考音频合成（genre=2，需要先上传参考音频）
# 1. 先上传参考音频
python scripts/indextts_api.py upload-tts-reference "C:/Users/yanyu/Desktop/emotion.wav"

# 2. 查看参考音频列表，获取 emotionPath
python scripts/indextts_api.py list-tts-references

# 3. 使用参考音频进行合成（genre=2，自动使用 style=2）
python scripts/indextts_api.py tts-create "今天天气真好" ABuVg22s3ydwS7RtkVyVN86Egq `
  --genre 2 --emotion-path "1cb251ec0d568de6a929b520c4aed8d1_20260401104924.wav"

返回：

{
  "code": 0,
  "data": {
    "taskId": "ABuVg22sQoSxZ7DFDTXqFP7dA9",
    "status": 1,
    "voiceUrl": ""
  },
  "msg": "成功"
}

9. 查询合成任务列表

python scripts/indextts_api.py tts-list [--page 1] [--page-size 10]

参数说明：

--page - 页码，默认 1
--page-size - 每页条数，默认 10，最大 20

示例：

python scripts/indextts_api.py tts-list --page 1 --page-size 20

10. 查询合成任务结果

python scripts/indextts_api.py tts-result

参数说明：

taskId - 任务 ID（从 tts-create 获取）

状态说明：

1 - 处理中
2 - 已完成
3 - 失败

示例：

python scripts/indextts_api.py tts-result ABuVg22sQoSxZ7DFDTXqFP7dA9

返回（已完成）：

{
  "code": 0,
  "data": {
    "taskId": "ABuVg22sQoSxZ7DFDTXqFP7dA9",
    "status": 2,
    "voiceUrl": "https://openapi.lipvoice.cn/file/download/xxx.wav"
  },
  "msg": "成功"
}

11. 下载合成音频

python scripts/indextts_api.py tts-download  <输出文件路径>

参数说明：

taskId - 任务 ID（必需）
输出文件路径 - 保存的 WAV 文件路径（必需）

示例：

python scripts/indextts_api.py tts-download ABuVg22sQoSxZ7DFDTXqFP7dA9 "C:/Users/yanyu/Desktop/output.wav"

注意： 此命令会自动查询任务状态并下载音频，如任务未完成会提示错误。

四、其他功能

12. 查询用户配额

python scripts/indextts_api.py quota

说明： 查询剩余字符额度、已用额度等信息

示例：

python scripts/indextts_api.py quota

注意： 此接口可能未在所有账户中开放，如返回 404 请登录网页版查看配额。

API 接口文档

官方文档: https://indextts.cn/main/developer

API 基础 URL: https://openapi.lipvoice.cn/api/third/

鉴权方式: 所有接口需要在 Header 中传递 sign 参数，或在 URL params 中拼接 sign

声音模型接口

功能	方法	端点	命令	状态
创建模型	POST	`/reference/upload`	`create-model`	✅ 已验证
模型列表	GET	`/reference/list`	`list-models`	✅ 已验证
模型详情	GET	`/reference/detail`	`get-model`	⚠️ 部分账户可用
删除模型	DELETE	`/reference/delete`	`delete-model`	✅ 已验证

参考音频接口（24 小时有效）

功能	方法	端点	命令	状态
上传参考音频	POST	`/tts/uploadCustom`	`upload-tts-reference`	✅ 已验证
参考音频列表	GET	`/tts/listCustom`	`list-tts-references`	✅ 已验证
删除参考音频	POST	`/tts/deleteCustom`	`delete-tts-reference`	✅ 已验证

语音合成接口

功能	方法	端点	命令	状态
异步语音合成	POST	`/tts/create`	`tts-create`	✅ 已验证
任务列表	GET	`/tts/list`	`tts-list`	✅ 已验证
任务结果	GET	`/tts/result`	`tts-result`	✅ 已验证
下载音频	GET	(voiceUrl)	`tts-download`	✅ 已验证

用户接口

功能	方法	端点	命令	状态
用户配额	GET	`/user/quota`	`quota`	⚠️ 部分账户可用

API 响应格式

所有接口返回统一的 JSON 格式：

{
  "code": 0,          // 0=成功，7=异常
  "data": { ... },    // 返回数据
  "msg": "成功"       // 描述信息
}

错误码说明

错误码	说明
0	成功
7	异常/错误（如 sign 无效、参数错误、资源不存在等）

使用流程示例

完整 TTS 工作流

# 1. 设置环境变量
$env:INDEX_API_SIGN = '你的 API 签名'
$env:INDEX_BASE_URL = 'https://openapi.lipvoice.cn'

# 2. 查看已有声音模型
python scripts/indextts_api.py list-models

# 3. 上传参考音频（用于情感合成）
python scripts/indextts_api.py upload-tts-reference "C:/Users/yanyu/Desktop/emotion.wav"

# 4. 查看参考音频列表，获取 emotionPath
python scripts/indextts_api.py list-tts-references

# 5. 使用参考音频进行情感合成
python scripts/indextts_api.py tts-create "今天天气真好！" ABuVg22s3ydwS7RtkVyVN86Egq --genre 1

# 6. 等待几秒后查询结果
Start-Sleep -Seconds 5
python scripts/indextts_api.py tts-result 

# 7. 下载合成音频
python scripts/indextts_api.py tts-download  "C:/Users/yanyu/Desktop/output.wav"