Regenerate song

December 13, 2024 (January 21, 2026)

Table of contents

  1. Request Headers
  2. Request Body
  3. Responses
  4. Model
  5. Examples
  6. Try It

https://api.useapi.net/v1/mureka/music/regenerate

Request Headers 
Authorization: Bearer {API token}
Content-Type: application/json
# Alternatively you can use multipart/form-data
# Content-Type: multipart/form-data
Request Body 
{
    "song_id": 123456789,
    "start_milliseconds": 123456
}
  • song_id is required.
    The song_id value returned by one of the following endpoints:

  • start_milliseconds is required. Define a starting point for the extension.

  • async is optional, enables fire-and-forget mode (default: false). When true, returns immediately with 201 Created and job metadata. Poll GET /jobs/jobid for completion status. Useful for avoiding long request timeouts since music generation takes 30-90 seconds.

  • replyUrl is optional, webhook URL for job status callbacks. Receives POST requests with job status updates (created, completed, failed). The JSON payload shape matches GET /jobs/jobid response.

  • replyRef is optional, custom reference string passed back in webhook callbacks. Useful for tracking jobs on your end.
Responses

  • 200 OK

    {
    "jobid": "j0121061432017475905m-u777-a12345678901234-bot:mureka",
    "feed_id": 11223344,
    "state": 3,
    "songs": [
        {
            "song_id": "user:777-mureka:123456789-song:33445566",
            "title": "<title>",
            "version": "1.1.1",
            "is_regenerate": true,
            "regenerate_from": 123456,            
            "duration_milliseconds": 234567,
            "generate_at": 12345677,
            "genres": [
                "electronic",
                "indie"
            ],
            "moods": [
                "quirky",
                "angry",
                "restless"
            ],
            "mp3_url": "https://<download link>.mp3",
            "share_key": "<share key>",
            "recall": true,
            "machine_audit_state": 1,
            "credit_type": 1,
            "cover": "https://<cover image>.png",
            "share_link": "https://<share link>"
        },
        {
            "song_id": "user:777-mureka:123456789-song:33445566",
            "title": "<title>",
            "version": "1.1.2",
            "is_regenerate": true,
            "regenerate_from": 123456,            
            "duration_milliseconds": 1234567,
            "generate_at": 12345667,
            "genres": [
                "electronic",
                "world-music"
            ],
            "moods": [
                "dark",
                "quirky",
                "energetic"
            ],
            "mp3_url": "https://<download link>.mp3",
            "share_key": "<share key>",
            "machine_audit_state": 1,
            "credit_type": 1,
            "cover": "https://<cover image>.png",
            "share_link": "https://<share link>"
        }
    ]
}

  • 201 Created

    Job created in async mode (async: true). Music regeneration is processing in the background.

    Use GET /jobs/jobid to poll for completion status.

    {
    "jobid": "j0121061432017475905m-u777-a12345678901234-bot:mureka",
    "verb": "music/regenerate",
    "jobType": "music",
    "status": "created",
    "created": "2026-01-20T12:34:56.789Z",
    "request": {
        "account": "12345678901234",
        "song_id": "user:777-mureka:123456789-song:33445566",
        "start_milliseconds": 123456,
        "async": true,
        "replyUrl": "https://your-domain.com/webhook",
        "replyRef": "my-custom-ref-123"
    }
}

  • 400 Bad Request

    {
  "error": "<Error message>",
  "code": 400
}

  • 401 Unauthorized

    {
  "error": "Wrong username/password combination.",
  "code": 401
}

  • 429 Too Many Requests

    • Rate limit exceeded.
      Endpoint called too frequently. Wait at least 3 seconds before making another call. 
      {
"code": 9008,
"msg": "Too frequently, please try again later."
}
    • Concurrent job limit exceeded. All job slots are taken (typically 10 concurrent generations per account). Wait at least 5 seconds before retrying. 
      {
"error": "Generate multiple task exceed limit. (6323)"
}

  • 596 Account Error

    Returned when the account has an error state preventing API calls.

    {
    "error": "Session refresh failed 2026-01-19T14:31:15.000Z, manual update required",
    "code": "REFRESH_FAILED"
}

    Possible error codes:

    • ACCOUNT_ERROR - Account has a blocking error
    • REFRESH_FAILED - Automatic token refresh failed
    • REFRESH_IN_PROGRESS - Token refresh already in progress, retry shortly
    • SESSION_EXPIRED - Session expired and no auto-refresh available
    • COOKIE_EXPIRED - Google cookie has expired

    To resolve, update your account configuration via POST /accounts.

Model

  • Music regeneration completed. Returns full song data with MP3 URLs.

    {
    jobid: string                              // Job identifier (for later lookup)
    feed_id: number
    state: number
    songs?: {
        song_id: string
        title: string
        version: string
        is_regenerate: boolean
        regenerate_from: number
        duration_milliseconds: number
        generate_at: number
        genres: string[]
        moods: string[]
        mp3_url: string
        share_key: string
        machine_audit_state: number
        credit_type: number
        cover: string
        share_link: string
    }[]
    error?: string
    code?: number
    msg?: string
}

  • Job created and processing in background. Structure matches GET /jobs/jobid response.

    {
    jobid: string                              // Job identifier
    verb: 'music/regenerate'                         // Job verb
    jobType: 'music'                           // Job type
    status: 'created'                          // Job status
    created: string                            // ISO 8601 timestamp
    request: {
        account?: string
        song_id: string
        start_milliseconds: number
        async: true
        replyUrl?: string
        replyRef?: string
    }
}

  • Error response structure (applies to both sync and async modes).

    {
    jobid?: string                             // Present for job-related errors
    error: string                              // Error summary message
    code?: number                              // HTTP status code or error code
    msg?: string                               // Additional error message
    rawData?: string                           // Raw error data (if available)
}
Examples 
  • curl -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer …" \
     -X POST https://api.useapi.net/v1/mureka/music/regenerate \
     -d '{"song_id": …, "start_milliseconds": …}'

  • const song_id = 123456789;      
const start_milliseconds = 123456; 
const apiUrl = `https://api.useapi.net/v1/mureka/music/regenerate`; 
const api_token = "API token";
const data = { 
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${api_token}`,
    'Content-Type': 'application/json' }
};
data.body = JSON.stringify({ 
  song_id, start_milliseconds
});
const response = await fetch(apiUrl, data);
const result = await response.json();
console.log("response", {response, result});

  • import requests
song_id = 123456789
start_milliseconds = 123456
apiUrl = f"https://api.useapi.net/v1/mureka/music/regenerate" 
api_token = "API token"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {api_token}"
}
body = {
    "song_id": song_id,
    "lyrics": start_milliseconds
}
response = requests.post(apiUrl, headers=headers, json=body)
print(response, response.json())
Try It