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

# Download MP3

> Use this operation when you need an MP3 file. A song’s playback URL may contain M4A audio.

> Operations are enabled individually by server configuration. Disabled operations return 503 without a task. Music credit deduction is currently disabled.

## Using this operation

Use this operation when you need an MP3 file. A song’s playback URL may contain M4A audio.

* 1. Prepare the fields shown in the example below. Replace sample URLs and IDs with resources you can access.
* 2. Set model to suno\_export\_mp3 and place the parameters inside input. Submit once and save the returned task\_id.
* 3. Query the saved task or receive its callback. A processing result is not a reason to submit the operation again.
* Read download\_url from result and save the file before expires\_at. Reusing an export does not reset its expiry.

## Create task

Send model and input to the common task endpoint. callback\_url is an optional top-level public HTTPS address. All resource IDs are APIstable IDs owned by your account. Music credit deduction is currently disabled.

```json theme={null}
{
  "model": "suno_export_mp3",
  "input": {
    "audio_id": "YOUR_AUDIO_ID"
  }
}
```

## Acceptance response

HTTP 200 confirms acceptance, not completion. Query GET /api/v1/tasks/\{task\_id} until data.status is succeeded or failed. Read data.result only after success; a failed task has its error in data.message.

```json theme={null}
{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "YOUR_TASK_ID"
  }
}
```

## Parameter reference

| Field | Type | Required | Description and limits |
| - | - | - | - |
| audio\_id | string | Yes | APIstable song ID belonging to your account. Cover/extend accept this ID only, without a source task\_id or external URL. maxLength: 200 |

## Inputs and limits

The schema lists supported fields, types and basic limits. Also follow Important conditions: cross-field and source-resource checks are not fully represented in JSON Schema. Unknown parameters are rejected. URL fields accept public HTTPS URLs, never file objects.

```json theme={null}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "audio_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "APIstable song ID belonging to your account. Cover/extend accept this ID only, without a source task_id or external URL."
    }
  },
  "required": [
    "audio_id"
  ],
  "additionalProperties": false
}
```

## Important conditions

* If the source is already MP3, its existing file may be reused without extending its expiry. M4A is converted through the export operation; changing a filename does not convert its format.
* Uploaded files last 24 hours, generated files 14 days and task details 30 days. Reused files keep their original expiry. Valid Voice/Persona identity mappings are separate from task-log cleanup. Download files you need to retain.

## Result schema

The creation response is \{code:200,msg:"success",data:\{task\_id}}. Poll GET /api/v1/tasks/\{task\_id}. On success, data.result is an object matching the schema below; it is otherwise null. input remains a JSON string.

```json theme={null}
{
  "type": "object",
  "required": [
    "audio_id",
    "download_url",
    "expires_at"
  ],
  "properties": {
    "audio_id": {
      "type": "string"
    },
    "download_url": {
      "type": "string"
    },
    "expires_at": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

## Related workflows

[Voice: all four steps](https://docs.apistable.com/en/suno-voice-workflow.md)
[File uploads](https://docs.apistable.com/en/file-upload.md)
[Callbacks](https://docs.apistable.com/en/webhooks.md)


## OpenAPI

````yaml openapi-suno-export-mp3.json POST /api/v1/tasks/create_task
openapi: 3.1.0
info:
  title: APIstable API
  version: 1.0.0-preview
  description: >-
    Public /api/v1 protocol. Valid API keys have the same account-scoped access.
    No client submission idempotency or max_credits. Enabled Suno operations use
    PayAPI and durable task processing. Media uses R2: uploads 24 hours,
    generated files 14 days, task logs 30 days. Music credit deduction is
    disabled. Unconfigured operations and LLM return 503.
servers:
  - url: https://apistable.com
    description: APIstable API
security: []
paths:
  /api/v1/tasks/create_task:
    post:
      summary: Download MP3
      description: >-
        Use this operation when you need an MP3 file. A song’s playback URL may
        contain M4A audio.
      operationId: suno_export_mp3
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - input
              additionalProperties: false
              properties:
                model:
                  type: string
                  enum:
                    - suno_export_mp3
                  example: suno_export_mp3
                input:
                  $schema: https://json-schema.org/draft/2020-12/schema
                  type: object
                  properties:
                    audio_id:
                      type: string
                      minLength: 1
                      maxLength: 200
                      description: >-
                        APIstable song ID belonging to your account.
                        Cover/extend accept this ID only, without a source
                        task_id or external URL.
                  required:
                    - audio_id
                  additionalProperties: false
                callback_url:
                  type: string
                  format: uri
                  description: >-
                    Optional public HTTPS endpoint for signed completion
                    callbacks; no redirects or private IPs.
            example:
              model: suno_export_mp3
              input:
                audio_id: YOUR_AUDIO_ID
      responses:
        '200':
          description: Accepted task. Poll the common task endpoint or use callback_url.
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - msg
                  - data
                additionalProperties: false
                properties:
                  code:
                    const: 200
                  msg:
                    const: success
                  data:
                    type: object
                    required:
                      - task_id
                    additionalProperties: false
                    properties:
                      task_id:
                        type: string
        '400':
          description: >-
            40001 invalid JSON, 40002 invalid input/callback, 40003 unsupported
            parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Invalid or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: '40201: Insufficient credits (live acceptance).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: '40401: Unknown model or resource not found in this account.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: '40901: Resource belongs to a different provider account.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '410':
          description: '41001: Source audio or temporary resource has expired.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: '41301: Request too large.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: '42201: Requested music combination is not enabled.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: '42901: Rate/concurrency limit (live acceptance).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: '50301: Service/provider unavailable. No live submission or charge.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    Error:
      type: object
      required:
        - code
        - msg
        - data
      properties:
        code:
          type: integer
        msg:
          type: string
        data:
          type: 'null'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Every valid key can submit and query its own account. Revoked keys are
        rejected.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.