> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jimmyai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Query SoundClone Task

> Query preview or production SoundClone task status and results.

<Note>
  Query preview or production audio tasks by the `id` returned from [Create Preview](/en/api-reference/sound-clone/clone-create) or [Create Audio](/en/api-reference/sound-clone/audio-create). This path is dedicated to **SoundClone** tasks.

  Response envelope: `{ "code": 20000, "msg": "ok", "data": { ... } }`.
</Note>

## Path parameters

| Parameter | Type   | Required | Description                                           |
| --------- | ------ | -------- | ----------------------------------------------------- |
| `id`      | string | Yes      | Task ID from create preview or create audio response. |

## Response fields

| Field          | Type    | Description                                                       |
| -------------- | ------- | ----------------------------------------------------------------- |
| `id`           | string  | Task ID                                                           |
| `object`       | string  | Always `audio`                                                    |
| `created`      | integer | Creation timestamp                                                |
| `model`        | string  | `soundCloningClone` (preview) or `soundCloningAudio` (production) |
| `status`       | string  | `queued` / `processing` / `completed` / `failed`                  |
| `modelId`      | string  | Returned when preview completes; use in create audio              |
| `audioUrl`     | string  | Preview or production audio URL                                   |
| `subtitleFile` | string  | Subtitle file URL when subtitle generation was enabled            |
| `error`        | string  | Error message on failure                                          |

## Task status

| status       | Meaning                                            |
| ------------ | -------------------------------------------------- |
| `queued`     | Waiting in queue                                   |
| `processing` | In progress                                        |
| `completed`  | Done — read `audioUrl` (and `modelId` for preview) |
| `failed`     | Failed — read `error`                              |

## Polling

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

## Example

```bash theme={null}
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**

```json theme={null}
{
  "code": 20000,
  "msg": "ok",
  "data": {
    "id": "audio_16b635ba-5889-4fa5-bbcc-bf67a38c353a",
    "object": "audio",
    "created": 1781777280,
    "model": "soundCloningClone",
    "status": "processing",
    "error": null
  }
}
```

**Preview completed**

```json theme={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
  }
}
```


## OpenAPI

````yaml en/api-reference/openapi.json GET /api/open-api/v1/audios/{id}
openapi: 3.1.0
info:
  title: Jimmy AI OpenAPI
  description: API for Jimmy AI video generation services
  version: 1.0.0
servers:
  - url: https://www.jimmyai.cn
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/open-api/v1/audios/{id}:
    get:
      summary: SoundClone - Query Result
      description: Query preview or production SoundClone task status and results.
      operationId: querySoundCloneResult
      parameters:
        - name: id
          in: path
          required: true
          description: Task ID from create preview or create audio
          schema:
            type: string
          example: audio_16b635ba-5889-4fa5-bbcc-bf67a38c353a
      responses:
        '200':
          description: Task status and result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SoundCloneQueryApiResponse'
              examples:
                completed:
                  summary: Preview completed
                  value:
                    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
components:
  schemas:
    SoundCloneQueryApiResponse:
      type: object
      properties:
        code:
          type: integer
          example: 20000
        msg:
          type: string
          example: ok
        data:
          $ref: '#/components/schemas/SoundCloneQueryData'
    SoundCloneQueryData:
      allOf:
        - $ref: '#/components/schemas/SoundCloneTaskData'
        - type: object
          properties:
            modelId:
              type: string
            audioUrl:
              type: string
            subtitleFile:
              type: string
    SoundCloneTaskData:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
          example: audio
        created:
          type: integer
          format: int64
        model:
          type: string
          enum:
            - soundCloningClone
            - soundCloningAudio
        status:
          type: string
          enum:
            - queued
            - processing
            - completed
            - failed
        error:
          type:
            - string
            - 'null'
      example:
        id: audio_16b635ba-5889-4fa5-bbcc-bf67a38c353a
        object: audio
        created: 1781777280
        model: soundCloningClone
        status: queued
        error: null
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````