API 文档 & 测试

快速接入指南和在线测试工具

未登录用户请在下方的测试工具中输入 API Key
选择接口/模型：
清除

目录

认证方式

所有 API 请求都需要在请求体中包含 key 参数：

{
  "key": "your-api-key-here",
  // 其他参数...
}

注册后可在用户中心获取 API Key。

接口地址

POSThttps://api.shuoxuai.top/api/v1/proxy.php生成/调用接口
POSThttps://api.shuoxuai.top/api/v1/query.php查询接口

通用参数

参数名类型必填说明
keystring是API密钥，从用户中心获取
modelstring条件必填模型名称，调用模型时必填，查看模型列表
api_idint条件必填接口ID，调用无模型接口时必填
task_typestring否任务类型：sync（同步，默认）或 async（异步）
promptstring条件必填提示词，图像/视频模型需要

接口详情 ID: 197

音频同音克隆

支持传入音频文件/音频地址和待克隆文本生成音频文件，此接口是异步接口，克隆是audio和text字段，查询是taskid字段，其中audio可使用from-data传入音频文件或者其他方式直接传入音频链接

请求参数结构

key (string) *必填
Key值验证
text (string) *必填
待克隆文本
audio (string) *必填
不能超过120秒音频链接，可form-data传入文件
model (string) *必填
模型名称，支持indextts-2，cosyvoice3，qwen3-tts
taskid (string) 可选
查询任务ID
text_control (string) 可选
文本控制情绪例如：我真的是服了你了！
key (string) *必填
API密钥

返回参数结构

msg (string)
状态信息
code (integer)
状态码
data (object)
返回内容
code (integer)
状态码，200表示成功
msg (string)
状态信息
data (object)
返回数据

示例结果

{"code":200,"msg":"任务完成","data":{"task_id":"任务ID","status":"success","audiopath":"http:\/\/127.0.0.1:8001\/cache\/audio\/2026-02-08\/f396eb0d-cc6f-4b0d-afe5-6629b62772c4.mp3"},"api_source":"官方API网:https:\/\/api.shuoxuai.top\/"}

在线测试工具

选择调用方式，填写参数后点击发送测试

还没有 API Key？立即注册

响应结果

暂无响应数据

示例代码下载

下载示例代码，快速集成 API 到您的项目中。

PHP 示例

使用 cURL

JavaScript 示例

使用 fetch API

Python 示例

使用 requests

所有示例代码均包含完整的请求和响应处理逻辑

错误码

错误码说明解决方案
400请求参数错误检查请求参数是否完整
401API密钥无效检查 API Key 是否正确
402余额不足请充值后重试
404模型或接口不存在检查 model 或 api_id
500服务器错误请联系技术支持