Skip to main content
GET
/
byId
Get Conversion by ID
curl --request GET \
  --url https://api.musicgpt.com/api/public/v1/byId \
  --header 'Authorization: <api-key>'
{
  "success": true,
  "conversion": {
    "task_id": "12345678-abcd-1234-efgh-567890abcdef",
    "conversion_id": "87654321-dcba-4321-hgfe-098765fedcba",
    "status": "COMPLETED",
    "status_msg": "Conversion successful",
    "audio_url": "https://musicgpt.s3.amazonaws.com/audiofile.mp3",
    "conversion_cost": 1.25,
    "title": "Generated Song",
    "lyrics": "[Verse 1]...",
    "music_style": "Pop",
    "createdAt": "2025-01-01T12:00:00Z",
    "updatedAt": "2025-01-01T12:05:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

Query Parameters

​
conversionType
enum<string>
required

The type of Conversion you want to get your details from.

Available options:
MUSIC_AI,
TEXT_TO_SPEECH,
VOICE_CONVERSION,
EXTRACTION,
COVER,
STEMS_SEPARATION,
VOCAL_EXTRACTION,
DENOISING,
DEECHO,
DEREVERB,
SOUND_GENERATOR,
AUDIO_TRANSCRIPTION,
AUDIO_SPEED_CHANGER,
AUDIO_MASTERING,
AUDIO_CUTTER,
REMIX,
FILE_CONVERT,
KEY_BPM_EXTRACTION,
AUDIO_TO_MIDI,
EXTEND,
INPAINT,
SING_OVER_INSTRUMENTAL,
LYRICS_GENERATOR
​
task_id
string

Task ID associated with the conversion. Note: You must provide either task_id or conversion_id, but not both.

​
conversion_id
string

Conversion ID to fetch details. Note: You must provide either task_id or conversion_id, but not both.

Response

Successful response

​
success
boolean
​
conversion
object