IndexTTS · 提交任务

走上游 voice_tts,按上游实际点数 ×3 计费(2026-10-03 决策 A:语音/音频线 ×5 → ×3):本接口对外形状不变(source_audio + input_text)。clone_voice 建音色:上游实际 200 点 ×3 = 600 点/次(同一参考音频复用缓存,不再收);tts_live 合成:按上游实际点数 ×3 —— 33 字实测上游 1.98 点 → 我方 5.94 点(单笔保底 1 点)。上游 frozen_points(60) 只是冻结上限,提交时按上限预扣、完成时按实际结算并自动退回差额(points_cost 单位是点,不是元)。轮询 GET /api/v1/tasks/<task_id>。回退开关 config.voiceClone.provider = upstream|bailian|auto。

创建一条弹性任务,返回平台任务 id

<details>
<summary>基本信息</summary>

字段内容
类型应用 API
应用名称IndexTTS
应用编码indextts
API 名称提交任务
API 编码submit
请求方式POST
请求路径/api/v1/apps/indextts/submit
调用模式异步

</details>

鉴权

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

请求路径

POST /api/v1/apps/indextts/submit

该接口为异步任务,提交后返回 task_id,请通过 GET /api/v1/tasks/{task_id} 查询结果,或在请求中传 callback_url 接收完成回调。

业务参数

参数类型必填默认值可选值 / 范围示例说明
modestring否async_query——任务模式,默认 async_query
input_textstring是——你好,这是一段测试语音。需要合成的文本内容
source_audiostring是——https://example.com/ref_voice.wav参考音频文件 URL,用于克隆音色

请求示例

{
    "mode": "async_query",
    "input_text": "你好,这是一段测试语音。",
    "source_audio": "https://example.com/ref_voice.wav"
}

成功响应

{
    "task_id": "tsk_xxxxxxxxxxxxxxxx",
    "status": "pending",
    "created_at": 1740000000
}

查询任务结果

GET /api/v1/tasks/{task_id}
{
    "task_id": "tsk_xxxxxxxxxxxxxxxx",
    "status": "completed",
    "created_at": 1740000000,
    "completed_at": 1740000060,
    "result": {
        "output": "任务输出内容"
    },
    "usage": {
        "points": 100
    }
}

失败响应

{
    "error": {
        "message": "点数余额不足",
        "type": "insufficient_points",
        "code": "insufficient_points"
    }
}

错误码

HTTPcode含义
400invalid_request参数缺失或格式错误
401auth_failedAPI Key 缺失或无效
402insufficient_points点数余额不足
402key_quota_exceeded当前 API Key 点数额度不足
403permission_denied当前 API Key 无权调用该模型/应用
404not_found模型 / 应用 / 任务不存在
429queue_limit_exceeded排队任务已达上限
5xxserver_error服务异常,请稍后重试

同类文章