Developer API

How to send your API key, what limits apply, and the error codes you should handle.

API key

Send your key on every request in the Authorization header. The X-Api-Key header is accepted as an alternative.

Code
Authorization: Bearer YOUR_API_KEY

Keep the key on your server. Never put it in browser or mobile code. If it leaks, rotate it from the Developer API page in the JualGame portal; the old key stops working immediately.

Account

Code
GET https://api.jualgame.id/api/v1/me
FieldMeaning
tierYour plan. The Business Plan shows enterprise.
unlimitedtrue while a Business Plan is active: no credits are deducted.
credits_balanceRemaining credits, or null when unlimited.
plan_expires_atWhen the current plan ends, or null without an active plan.
rate_limit_per_minRequests allowed per 60 seconds.
max_concurrencyJobs you may have running at the same time.
webhook_urlWhere job results are sent, or null if not set.

Limits

Limits protect the service for everyone and apply to unlimited plans too. The Business Plan allows 600 requests per minute and 30 running jobs.

  • Rate limit: counted over the last 60 seconds. Every response carries X-RateLimit-Limit and X-RateLimit-Remaining. Over the limit you get 429 rate_limited with Retry-After.

  • Running jobs: creating a job while you are at your limit returns 429 too_many_jobs. Wait for a job to finish, then retry.

  • Request size: at most 200 MB per request.

Unlimited plan and credits

While a Business Plan is active nothing is deducted, whatever your usage. When it ends, the key falls back to your credit balance; with no credits left it answers 402 plan_expired until you renew.

Credit-based plans and packs are charged one credit per successful item: per source converted (audio), per file uploaded (uploader), per asset spoofed (spoofer). Failed items are not charged.

Error codes

StatusCodeWhat to do
401missing_api_keyAdd the Authorization header.
401invalid_api_keyThe key is wrong or was rotated.
402plan_expiredYour Business Plan ended. Renew it in the portal.
402insufficient_creditsTop up credits, or buy the Business Plan.
400validation codesFor example missing_url, unsupported_file, invalid_creator_id. Fix the request; do not retry unchanged.
404job_not_foundThe job ID is not yours, or belongs to another tool.
404file_not_foundThe file expired or the name is wrong.
413file_too_largeSend a smaller file.
422roblox_rejectedRoblox refused the credentials or the asset. The message comes from Roblox.
429rate_limitedWait for Retry-After seconds.
429too_many_jobsWait for a running job to finish.
502roblox_unreachableRoblox did not answer. Retry later.
500internal_errorRetry later; contact support if it continues.