---
title: "Generate music"
method: POST
path: "/music/generations"
tags: ["Music"]
---

# Generate music

`POST /music/generations`

## Request

- Base URL: `https://www.aimagicx.com/api/v1`
- URL: `https://www.aimagicx.com/api/v1/music/generations`
- Auth: HTTP bearer

Creates original music tracks from text descriptions using Stable Audio and other models.

## Query parameters

- `async` boolean

## Request body

- MusicGenerationRequest
  - `prompt` string, required: Description of the music
  - `model` string
  - `duration_seconds` number
  - `mode` 'text_to_music' | 'audio_to_audio'
  - `source_audio` string, uri, nullable
  - `output_format` 'mp3' | 'wav'
  - `negative_prompt` string, nullable

## Response `200`

Successful response

- union
  - MusicGenerationResponse
    - `created` integer
    - `data` object
      - `audio_url` string, uri
      - `duration_seconds` number
    - `model` string
    - `model_tier` string
    - `usage` Usage
      - `credits_used` integer
      - `credits_breakdown` object
      - `prompt_tokens` integer
      - `completion_tokens` integer
      - `total_tokens` integer
  - AsyncJobResponse
    - `id` string: Job ID for polling
    - `status` 'pending' | 'processing' | 'completed' | 'failed'
    - `created` integer
    - `model` string
    - `estimated_credits` integer

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - invalid or missing API key

---

[API](https://skmtc.dev/aimagicx/apis/ai-magicx-api.md) - [All operations](https://skmtc.dev/aimagicx/apis/ai-magicx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aimagicx/apis/ai-magicx-api/revisions/08210272abb4?raw)