# IndexTTS 2.5 删除音色 > 音频生成 验证公司和请求的公开模型归属后删除音色，成功后清理绑定；不删除源素材。活动任务引用中的音色可能无法删除。 ## 请求地址 `POST https://api.modelverse.cn/v1/audio/voice/delete` ## 请求体 ## 响应 - **200** — Success - **400** — Invalid request - **401** — Authentication failed - **403** — 账户、IP 或模型访问权限不允许此操作。 - **404** — Resource not found - **429** — Rate limited - **500** — Service error ## OpenAPI 定义 ```json { "components": { "schemas": { "Error": { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": {}, "message": { "type": "string" }, "param": {}, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "File": { "additionalProperties": true, "properties": { "bytes": { "type": "integer" }, "created_at": { "type": "integer" }, "expires_at": { "type": "integer" }, "filename": { "type": "string" }, "id": { "description": "参考音频素材 ID，后续作为 asset_id 引用。", "type": "string" }, "object": { "const": "file", "type": "string" }, "purpose": { "const": "tts:speech_reference:IndexTTS-2.5", "description": "标识用于 IndexTTS 2.5 的参考音频。", "type": "string" }, "status": { "type": "string" } }, "required": [ "id", "object", "bytes", "created_at", "filename", "purpose" ], "type": "object" }, "FileList": { "additionalProperties": false, "properties": { "data": { "items": { "$ref": "#/components/schemas/File" }, "type": "array" }, "object": { "const": "list", "type": "string" } }, "required": [ "object", "data" ], "type": "object" }, "FileUpload": { "additionalProperties": false, "properties": { "duration_ms": { "maximum": 30000, "minimum": 500, "type": "integer" }, "file": { "description": "WAV/MP3/FLAC/OGG/M4A；最多15 MiB（15728640字节）。", "format": "binary", "type": "string" }, "purpose": { "const": "tts:speech_reference:IndexTTS-2.5", "description": "标识用于 IndexTTS 2.5 的参考音频。", "type": "string" } }, "required": [ "purpose", "duration_ms", "file" ], "type": "object" }, "Pronunciation": { "additionalProperties": false, "properties": { "kind": { "enum": [ "pinyin", "alias", "cmu", "kana" ], "type": "string" }, "value": { "maxLength": 512, "minLength": 1, "type": "string" }, "word": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "word", "kind", "value" ], "type": "object" }, "TaskRequest": { "additionalProperties": false, "properties": { "input": { "additionalProperties": false, "properties": { "text": { "description": "正文至少包含一个字母（含汉字）或十进制数字。", "maxLength": 2000, "minLength": 1, "type": "string" } }, "required": [ "text" ], "type": "object" }, "model": { "const": "IndexTTS-2.5", "type": "string" }, "parameters": { "additionalProperties": false, "properties": { "auto_emotion": { "default": true, "type": "boolean" }, "emotion_description": { "maxLength": 200, "type": "string" }, "emotion_strength": { "default": 0.8, "maximum": 1, "minimum": 0, "type": "number" }, "emotion_vector": { "description": "总和大于0且不超过0.8；需要 auto_emotion=false 且无情绪描述。顺序：高兴、愤怒、悲伤、恐惧、厌恶、低落、惊讶、平静。", "items": { "maximum": 0.8, "minimum": 0, "type": "number" }, "maxItems": 8, "minItems": 8, "type": "array" }, "emotion_vector_mode": { "description": "single 仅允许一个非零元素；省略时根据向量自动确定模式。", "enum": [ "single", "mixed" ], "type": "string" }, "language": { "default": "ZH", "enum": [ "ZH", "EN", "JA", "ES", "AR" ], "type": "string" }, "pronunciations": { "items": { "$ref": "#/components/schemas/Pronunciation" }, "maxItems": 100, "type": "array" }, "speed": { "default": 1, "description": "语速范围为 0.5～2；省略或传 0 时按 1 处理。", "anyOf": [ { "const": 0 }, { "maximum": 2, "minimum": 0.5 } ], "type": "number" }, "voice": { "$ref": "#/components/schemas/VoiceReference" } }, "required": [ "voice" ], "type": "object" } }, "required": [ "model", "input", "parameters" ], "type": "object" }, "TaskStatus": { "additionalProperties": true, "properties": { "output": { "additionalProperties": true, "properties": { "error_message": { "type": "string" }, "finish_time": { "type": "integer" }, "submit_time": { "type": "integer" }, "task_id": { "type": "string" }, "task_status": { "enum": [ "Pending", "Running", "Success", "Failure", "Cancelled" ], "type": "string" }, "urls": { "items": { "format": "uri", "type": "string" }, "type": "array" } }, "required": [ "task_id", "task_status" ], "type": "object" }, "request_id": { "type": "string" }, "usage": { "additionalProperties": true, "properties": { "prompt_tokens": { "description": "任务成功后，按 input.text 的全部 Unicode 字符数计量，包含标点、空白、换行和符号；成功前为0。", "type": "integer" }, "completion_tokens": { "const": 0, "type": "integer" }, "total_tokens": { "description": "与 prompt_tokens 相同。", "type": "integer" } }, "required": [ "prompt_tokens", "completion_tokens", "total_tokens" ], "type": "object" } }, "required": [ "output" ], "type": "object" }, "TaskCancelled": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "deleted": { "const": true, "type": "boolean" }, "object": { "const": "video.deleted", "type": "string" } }, "required": [ "id", "deleted", "object" ], "type": "object" }, "TaskSubmitted": { "additionalProperties": true, "properties": { "output": { "additionalProperties": false, "properties": { "task_id": { "type": "string" } }, "required": [ "task_id" ], "type": "object" }, "request_id": { "type": "string" } }, "required": [ "output" ], "type": "object" }, "Voice": { "additionalProperties": false, "properties": { "audio_url": { "format": "uri", "type": "string" }, "id": { "type": "string" }, "kind": { "enum": [ "preset", "custom" ], "type": "string" }, "language": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name", "kind" ], "type": "object" }, "VoiceCreate": { "additionalProperties": false, "properties": { "asset_id": { "minLength": 1, "type": "string" }, "model": { "const": "IndexTTS-2.5", "type": "string" }, "name": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "model", "name", "asset_id" ], "type": "object" }, "VoiceCreated": { "additionalProperties": false, "properties": { "id": { "description": "新 voice_id；不兼容旧 uspeech: ID。", "type": "string" } }, "required": [ "id" ], "type": "object" }, "VoiceDelete": { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "model": { "const": "IndexTTS-2.5", "type": "string" } }, "required": [ "model", "id" ], "type": "object" }, "VoiceDeleted": { "additionalProperties": false, "properties": { "success": { "const": true, "type": "boolean" } }, "required": [ "success" ], "type": "object" }, "VoiceList": { "additionalProperties": false, "properties": { "list": { "items": { "$ref": "#/components/schemas/Voice" }, "maxItems": 1000, "type": "array" } }, "required": [ "list" ], "type": "object" }, "VoiceReference": { "oneOf": [ { "additionalProperties": false, "properties": { "source": { "enum": [ "preset", "custom" ], "type": "string" }, "voice_id": { "minLength": 1, "type": "string" } }, "required": [ "source", "voice_id" ], "type": "object", "title": "object" }, { "additionalProperties": false, "properties": { "asset_id": { "minLength": 1, "type": "string" }, "source": { "const": "asset", "type": "string" } }, "required": [ "source", "asset_id" ], "type": "object", "title": "object" } ] } }, "securitySchemes": { "bearerAuth": { "bearerFormat": "ModelVerse API Key", "scheme": "bearer", "type": "http" } } }, "info": { "description": "IndexTTS 2.5 独立异步语音模型。使用 ModelVerse API Key、统一 task、Files 和音色管理路径。迁移时需备份旧 Speaker 原文件，上传参考素材，再创建新音色并保存新旧 ID 对照；旧 uspeech:、旧预设名及情绪音频不能仅通过修改 model 值继续使用。生成成功后按 input.text 的全部 Unicode 字符计费，包含标点、空白、换行和符号，沿用旧 IndexTTS 2 的统计口径。情绪描述、读音规则等生成参数不计入正文用量，售价以 ModelVerse 价格说明为准。重新提交请求会创建新任务或音色；请求超时后，请先查询已取得的任务 ID，再决定是否重提。结果应及时下载，保留期限以当期公告为准。", "title": "IndexTTS 2.5 异步语音 API", "version": "1.0.0" }, "openapi": "3.1.0", "paths": { "/v1/audio/voice/delete": { "post": { "description": "验证公司和请求的公开模型归属后删除音色，成功后清理绑定；不删除源素材。活动任务引用中的音色可能无法删除。", "operationId": "deleteIndexTTS25Voice", "requestBody": { "content": { "application/json": { "example": { "id": "", "model": "IndexTTS-2.5" }, "schema": { "$ref": "#/components/schemas/VoiceDelete" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VoiceDeleted" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentication failed" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "账户、IP 或模型访问权限不允许此操作。" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Resource not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limited" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Service error" } }, "summary": "IndexTTS 2.5 删除音色", "tags": [ "IndexTTS 2.5" ] } }, "/v1/audio/voice/list": { "get": { "description": "custom 只返回当前公司在请求的公开模型下登记的音色，最多1000条；preset 返回该模型的预设音色目录。响应 ID 字段为 id，生成时作为 voice_id 使用。", "operationId": "listIndexTTS25Voices", "parameters": [ { "in": "query", "name": "model", "required": true, "schema": { "const": "IndexTTS-2.5", "type": "string" } }, { "in": "query", "name": "kind", "required": false, "schema": { "default": "custom", "enum": [ "preset", "custom" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VoiceList" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentication failed" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "账户、IP 或模型访问权限不允许此操作。" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Resource not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limited" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Service error" } }, "summary": "IndexTTS 2.5 查询音色列表", "tags": [ "IndexTTS 2.5" ] } }, "/v1/audio/voice/upload": { "post": { "description": "先通过 /v1/files 获取 asset_id，再引用它创建音色。源素材必须属于当前公司、当前项目及请求的公开模型。创建后的音色在同公司、同公开模型内共享。", "operationId": "createIndexTTS25Voice", "requestBody": { "content": { "application/json": { "example": { "asset_id": "", "model": "IndexTTS-2.5", "name": "客服女声" }, "schema": { "$ref": "#/components/schemas/VoiceCreate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VoiceCreated" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentication failed" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "账户、IP 或模型访问权限不允许此操作。" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Resource not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limited" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Service error" } }, "summary": "IndexTTS 2.5 使用上传素材创建音色", "tags": [ "IndexTTS 2.5" ] } }, "/v1/files": { "get": { "description": "查询 ModelVerse 登记的当前公司、项目的素材元数据，使用 purpose 筛选公开模型。当前响应不返回可用于下一页查询的游标，不能将响应中的 asset_id 用作 after。请保存每次上传返回的 id 作为迁移清单，并按 id 查询详情核对。", "operationId": "listIndexTTS25References", "parameters": [ { "in": "query", "name": "purpose", "required": true, "schema": { "const": "tts:speech_reference:IndexTTS-2.5", "description": "标识用于 IndexTTS 2.5 的参考音频。", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "after", "deprecated": true, "description": "暂不建议使用。当前响应未提供可取得的下一页游标，请保存上传返回的 id 逐项查询。", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileList" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentication failed" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "账户、IP 或模型访问权限不允许此操作。" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Resource not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limited" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Service error" } }, "summary": "IndexTTS 2.5 查询素材列表", "tags": [ "IndexTTS 2.5" ] }, "post": { "description": "上传参考音频并创建素材记录，返回 id 即后续引用的 asset_id。素材按公司、项目及公开模型名隔离；不得使用其他 Files 用途或其他公开模型登记的文件 ID。", "operationId": "uploadIndexTTS25Reference", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/FileUpload" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentication failed" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "账户、IP 或模型访问权限不允许此操作。" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Resource not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limited" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Service error" } }, "summary": "IndexTTS 2.5 上传参考素材", "tags": [ "IndexTTS 2.5" ] } }, "/v1/files/{file_id}": { "get": { "description": "查询参考音频素材的元数据。该用途暂不支持删除素材和下载素材内容。", "operationId": "getIndexTTS25Reference", "parameters": [ { "in": "path", "name": "file_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/File" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentication failed" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "账户、IP 或模型访问权限不允许此操作。" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Resource not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limited" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Service error" } }, "summary": "IndexTTS 2.5 查询素材详情", "tags": [ "IndexTTS 2.5" ] } }, "/v1/tasks/cancel": { "get": { "description": "使用 ModelVerse 任务取消接口，只能取消尚未开始生成的任务，已取消的任务重复调用会返回成功。生成已开始或结束时，当前接口返回 HTTP 500 的取消拒绝错误；应继续查询任务状态，成功生成仍按正常规则计费。查询看到 Pending 不保证取消成功，以处理取消请求时的任务状态为准。成功响应中的 deleted=true 表示取消成功，object=video.deleted 为历史兼容值，不表示删除任务或素材。", "operationId": "cancelIndexTTS25Task", "parameters": [ { "in": "query", "name": "task_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "id": "", "deleted": true, "object": "video.deleted" }, "schema": { "$ref": "#/components/schemas/TaskCancelled" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentication failed" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "账户、IP 或模型访问权限不允许此操作。" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limited" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Service error" } }, "summary": "IndexTTS 2.5 取消任务", "tags": [ "IndexTTS 2.5" ] } }, "/v1/tasks/status": { "get": { "description": "建议每3秒轮询。成功后 output.urls 为可直接下载 WAV 的普通 URL 字符串数组。任务按公司与项目隔离，后台跟进与计费不依赖客户继续轮询。 下方成功示例对应输入“你好，测试123。”，包含标点共9个字符。任务 ID 不存在或不属于当前公司、项目时，当前接口返回 HTTP 400。", "operationId": "getIndexTTS25TaskStatus", "parameters": [ { "in": "query", "name": "task_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "example": { "output": { "task_id": "", "task_status": "Success", "urls": [ "https://example.com/audio/result.wav" ], "submit_time": 1700000000, "finish_time": 1700000003 }, "usage": { "prompt_tokens": 9, "completion_tokens": 0, "total_tokens": 9 } }, "schema": { "$ref": "#/components/schemas/TaskStatus" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentication failed" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "账户、IP 或模型访问权限不允许此操作。" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limited" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Service error" } }, "summary": "IndexTTS 2.5 查询任务状态", "tags": [ "IndexTTS 2.5" ] } }, "/v1/tasks/submit": { "post": { "description": "使用 ModelVerse task 协议提交异步语音任务，parameters 仅列出本模型支持的参数。未列出的字段可能被忽略，不应依赖其生效；旧 emo_*、gain、sample_rate 参数不生效，save_voice=true 会被拒绝。临时素材用 source=asset，复用音色用 source=custom，预设音色用 source=preset。素材和自定义音色必须属于请求的公开模型名；使用模型别名时，也必须引用登记在该模型名称下的资源。", "operationId": "submitIndexTTS25Task", "requestBody": { "content": { "application/json": { "example": { "input": { "text": "你好，欢迎使用语音合成。" }, "model": "IndexTTS-2.5", "parameters": { "auto_emotion": true, "language": "ZH", "speed": 1, "voice": { "source": "custom", "voice_id": "" } } }, "schema": { "$ref": "#/components/schemas/TaskRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskSubmitted" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentication failed" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "账户、IP 或模型访问权限不允许此操作。" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Resource not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Rate limited" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Service error" } }, "summary": "IndexTTS 2.5 创建语音生成任务", "tags": [ "IndexTTS 2.5" ] } } }, "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.modelverse.cn" } ], "tags": [ { "name": "IndexTTS 2.5" } ], "x-language": "zh-CN" } ```