curl --request POST \
  --url https://api.mage.space/v1/minimax_music/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
  "duration": "120",
  "lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe"
}
'

import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('minimax_music', {
  prompt: 'Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.',
  duration: '120',
  lyrics: '[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe',
});

console.log(request.result.url);

from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("minimax_music", {
    "prompt": "Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.",
    "duration": "120",
    "lyrics": "[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe",
})

print(request["result"]["url"])

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'Acoustic pop, 96 BPM, C major, warm and intimate, building into the chorus. Soft female lead, close and breathy, light harmonies in the chorus. Fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.',
    duration: '120',
    lyrics: '[verse]\nMorning light filtering through the pine\nEvery quiet street is yours and mine\n[chorus]\nSoftly the world begins to breathe'
  })
};

fetch('https://api.mage.space/v1/minimax_music/generate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
  "status": "in_progress",
  "architecture": "minimax_music",
  "model_id": "minimax-music-3",
  "created_at": "2026-09-17T14:52:48.000Z",
  "updated_at": "2026-09-17T14:52:49.000Z",
  "billing": {
    "mode": "gems",
    "gems_charged": 125
  },
  "result": null,
  "error": null,
  "status_url": "https://api.mage.space/v1/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/status",
  "cancel_url": "https://api.mage.space/v1/requests/d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff/cancel"
}

{
  "error": {
    "code": "invalid_config",
    "message": "`resolution` must be one of: 768P, 2K."
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "The API key is invalid or has been revoked."
  }
}

{
  "error": {
    "code": "insufficient_gems",
    "message": "This generation costs 40 gems and the account balance is too low.",
    "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff",
    "gems_required": 40
  }
}

{
  "error": {
    "code": "content_blocked",
    "message": "The request was blocked by Mage's content policy.",
    "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff"
  }
}

{
  "error": {
    "code": "architecture_retired",
    "message": "This architecture has been retired.",
    "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff"
  }
}

{
  "error": {
    "code": "too_many_requests",
    "message": "At most 20 generations may be in flight at once for this account; 20 are running now."
  }
}

{
  "error": {
    "code": "content_blocked",
    "message": "The request was blocked by an external content restriction.",
    "request_id": "d7e6c0f3-6699-4f6c-bb45-2ad7fd9158ff"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side. Retry, and contact support if it persists."
  }
}