Developer API

Convert a link or an audio file into Roblox-ready audio, download the result, and optionally upload it to Roblox.

Create a job

Code
POST https://api.jualgame.id/api/v1/audio/jobs

Send JSON to convert from a link, or multipart/form-data to convert a file you upload.

FieldTypeNotes
urlstringA supported media link, for example a YouTube link. Use this or urls or file.
urlsstring[]Up to 6 links in one job.
filefileMultipart only. mp3, wav, ogg, m4a, flac, aac, opus or webm, at most 100 MB.
formatstringmp3 (default), ogg or wav.
roblox_speednumber1.5 to 3, default 2.3. The audio is sped up by this factor.
amplify_dbnumber-20 to 0, default -4.
max_durationnumberSeconds per output file, 30 to 420, default 420. Longer audio is split into parts.
external_idstringYour own ID for this job, at most 100 characters. Returned in every response and webhook.
From a link
curl -X POST https://api.jualgame.id/api/v1/audio/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=...", "format": "mp3", "external_id": "order-123"}'
From a file
curl -X POST https://api.jualgame.id/api/v1/audio/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "format=mp3" \
  -F "external_id=order-123"

The answer is 202 with the job. status starts as processing.

Read a job

Code
GET https://api.jualgame.id/api/v1/audio/jobs/{job_id}
Response
{
  "success": true,
  "data": {
    "job_id": "cmutty9s10001oi2j696p2kgb",
    "external_id": "order-123",
    "status": "completed",
    "stage": "done",
    "progress": 100,
    "error": null,
    "title": "song",
    "format": "mp3",
    "playback_speed": 0.43,
    "files": [
      {
        "filename": "song.mp3",
        "title": "song",
        "duration": "1:18",
        "source_url": null,
        "download_url": "https://api.jualgame.id/api/v1/audio/jobs/cmutty9s10001oi2j696p2kgb/files/song.mp3"
      }
    ],
    "created_at": "2026-10-04T13:02:11.000Z",
    "finished_at": "2026-10-04T13:02:19.000Z",
    "files_expire_at": "2026-10-04T15:02:11.000Z"
  }
}
FieldMeaning
statusprocessing, completed or failed. Use this to decide what to do.
stageDetail for display: queued, downloading, converting, done, error, or expired once the files are gone.
playback_speedSet this as PlaybackSpeed on the Sound in Roblox so the sped-up audio plays at normal speed.
filesOne entry per output file. Long audio produces several parts.

Download a file

Use the download_url from the job, with your API key. Files are deleted 2 hours after the job was created, so copy what you need to your own storage.

Code
curl -L "https://api.jualgame.id/api/v1/audio/jobs/{job_id}/files/song.mp3" \
  -H "Authorization: Bearer YOUR_API_KEY" -o song.mp3

Upload a result to Roblox

Code
POST https://api.jualgame.id/api/v1/audio/jobs/{job_id}/upload
FieldNotes
filenameRequired. One filename from the job.
roblox_api_keyRequired. A Roblox Open Cloud API key with Assets read and write access.
creator_idRequired. Numeric Roblox user ID or group ID that will own the asset.
creator_typeuser (default) or group.
display_nameAsset name on Roblox, at most 50 characters. Defaults to the filename.
descriptionAsset description.
Response
{
  "success": true,
  "data": {
    "job_id": "cmutty9s10001oi2j696p2kgb",
    "external_id": "order-123",
    "filename": "song.mp3",
    "asset_id": "1234567890",
    "moderation_status": "COMPLETED",
    "operation_id": "9f1c..."
  }
}

This call waits for Roblox, usually a few seconds and at most about 75. moderation_status is COMPLETED, REVIEWING or REJECTED. If asset_id is null, Roblox was still processing: check the operation_id with the Roblox Open Cloud operations API using your own key.