Skip to main content
GET
/
api
/
open-api
/
v1
/
audios
/
{id}
SoundClone - Query Result
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
  }
}
Query preview or production audio tasks by the id returned from Create Preview or Create Audio. This path is dedicated to SoundClone tasks.Response envelope: { "code": 20000, "msg": "ok", "data": { ... } }.

Path parameters

ParameterTypeRequiredDescription
idstringYesTask ID from create preview or create audio response.

Response fields

FieldTypeDescription
idstringTask ID
objectstringAlways audio
createdintegerCreation timestamp
modelstringsoundCloningClone (preview) or soundCloningAudio (production)
statusstringqueued / processing / completed / failed
modelIdstringReturned when preview completes; use in create audio
audioUrlstringPreview or production audio URL
subtitleFilestringSubtitle file URL when subtitle generation was enabled
errorstringError message on failure

Task status

statusMeaning
queuedWaiting in queue
processingIn progress
completedDone — read audioUrl (and modelId for preview)
failedFailed — read error

Polling

Poll every 5–10 seconds until status is completed or failed.

Example

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

Response examples

Processing
{
  "code": 20000,
  "msg": "ok",
  "data": {
    "id": "audio_16b635ba-5889-4fa5-bbcc-bf67a38c353a",
    "object": "audio",
    "created": 1781777280,
    "model": "soundCloningClone",
    "status": "processing",
    "error": null
  }
}
Preview completed
{
  "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
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Task ID from create preview or create audio

Response

200 - application/json

Task status and result

code
integer
Example:

20000

msg
string
Example:

"ok"

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