跳转到主要内容
GET
/
api
/
open-api
/
v1
/
audios
/
{id}
SoundClone - 查询结果
curl --request GET \
  --url https://www.jimmyai.cn/api/open-api/v1/audios/{id} \
  --header 'Authorization: Bearer <token>'
{
  "code": 20000,
  "msg": "ok",
  "data": {
    "id": "audio_16b635ba-5889-4fa5-bbcc-bf67a38c353a",
    "object": "audio",
    "created": 1781777280,
    "model": "soundCloningClone",
    "status": "completed",
    "modelId": "model_123456789",
    "audioUrl": "https://example.com/preview-audio.mp3",
    "error": null
  }
}
使用提交 试听任务 或 正式音频任务 返回的 id 查询任务状态与结果。本路径专用于 SoundClone 声音克隆任务。响应格式：{ "code": 20000, "msg": "ok", "data": { ... } }。

​
路径参数

参数类型必填说明
idstring是任务 ID，来自提交试听或提交音频生成接口返回的 id。

​
响应字段

字段类型说明
idstring任务 ID
objectstring固定为 audio
createdinteger任务创建时间戳
modelstringsoundCloningClone（试听）或 soundCloningAudio（正式音频）
statusstringqueued / processing / completed / failed
modelIdstring试听任务完成后返回，供正式音频接口使用
audioUrlstring试听或正式音频地址
subtitleFilestring开启字幕且任务完成后返回字幕文件地址
errorstring失败时的错误信息

​
任务状态

status说明
queued排队中
processing处理中
completed已完成，可读取 audioUrl（试听任务同时返回 modelId）
failed失败，查看 error

​
轮询建议

建议每 5–10 秒 查询一次；当 status 为 completed 或 failed 时停止轮询。

​
示例请求

curl --request GET \
  --url 'https://www.jimmyai.cn/api/open-api/v1/audios/audio_16b635ba-5889-4fa5-bbcc-bf67a38c353a' \
  --header 'Authorization: Bearer sk_xxx'

​
响应示例

处理中 
{
  "code": 20000,
  "msg": "ok",
  "data": {
    "id": "audio_16b635ba-5889-4fa5-bbcc-bf67a38c353a",
    "object": "audio",
    "created": 1781777280,
    "model": "soundCloningClone",
    "status": "processing",
    "error": null
  }
}
试听任务已完成 
{
  "code": 20000,
  "msg": "ok",
  "data": {
    "id": "audio_16b635ba-5889-4fa5-bbcc-bf67a38c353a",
    "object": "audio",
    "created": 1781777280,
    "model": "soundCloningClone",
    "status": "completed",
    "modelId": "model_123456789",
    "audioUrl": "https://example.com/preview-audio.mp3",
    "error": null
  }
}
正式音频任务已完成（含字幕） 
{
  "code": 20000,
  "msg": "ok",
  "data": {
    "id": "audio_764fb3e7-8af2-4d2d-89a0-e58f8f3eb9c4",
    "object": "audio",
    "created": 1781777280,
    "model": "soundCloningAudio",
    "status": "completed",
    "audioUrl": "https://example.com/generated-audio.mp3",
    "subtitleFile": "https://example.com/subtitle.srt",
    "error": null
  }
}

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

​
id
string
必填

任务 ID，来自提交试听或提交音频生成接口

响应

200 - application/json

任务状态与结果

​
code
integer
示例:

20000

​
msg
string
示例:

"ok"

​
data
object
示例:
{
  "id": "audio_16b635ba-5889-4fa5-bbcc-bf67a38c353a",
  "object": "audio",
  "created": 1781777280,
  "model": "soundCloningClone",
  "status": "queued",
  "error": null
}