Developer API
Audio Converter
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/jobsSend JSON to convert from a link, or multipart/form-data to convert a file you upload.
| Field | Type | Notes |
url | string | A supported media link, for example a YouTube link. Use this or urls or file. |
urls | string[] | Up to 6 links in one job. |
file | file | Multipart only. mp3, wav, ogg, m4a, flac, aac, opus or webm, at most 100 MB. |
format | string | mp3 (default), ogg or wav. |
roblox_speed | number | 1.5 to 3, default 2.3. The audio is sped up by this factor. |
amplify_db | number | -20 to 0, default -4. |
max_duration | number | Seconds per output file, 30 to 420, default 420. Longer audio is split into parts. |
external_id | string | Your 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"
}
}| Field | Meaning |
status | processing, completed or failed. Use this to decide what to do. |
stage | Detail for display: queued, downloading, converting, done, error, or expired once the files are gone. |
playback_speed | Set this as PlaybackSpeed on the Sound in Roblox so the sped-up audio plays at normal speed. |
files | One 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.mp3Upload a result to Roblox
Code
POST https://api.jualgame.id/api/v1/audio/jobs/{job_id}/upload| Field | Notes |
filename | Required. One filename from the job. |
roblox_api_key | Required. A Roblox Open Cloud API key with Assets read and write access. |
creator_id | Required. Numeric Roblox user ID or group ID that will own the asset. |
creator_type | user (default) or group. |
display_name | Asset name on Roblox, at most 50 characters. Defaults to the filename. |
description | Asset 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.
