Developer API
Authentication, limits and errors
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.
Authorization: Bearer YOUR_API_KEYKeep 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
GET https://api.jualgame.id/api/v1/me| Field | Meaning |
tier | Your plan. The Business Plan shows enterprise. |
unlimited | true while a Business Plan is active: no credits are deducted. |
credits_balance | Remaining credits, or null when unlimited. |
plan_expires_at | When the current plan ends, or null without an active plan. |
rate_limit_per_min | Requests allowed per 60 seconds. |
max_concurrency | Jobs you may have running at the same time. |
webhook_url | Where 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-LimitandX-RateLimit-Remaining. Over the limit you get429 rate_limitedwithRetry-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
| Status | Code | What to do |
| 401 | missing_api_key | Add the Authorization header. |
| 401 | invalid_api_key | The key is wrong or was rotated. |
| 402 | plan_expired | Your Business Plan ended. Renew it in the portal. |
| 402 | insufficient_credits | Top up credits, or buy the Business Plan. |
| 400 | validation codes | For example missing_url, unsupported_file, invalid_creator_id. Fix the request; do not retry unchanged. |
| 404 | job_not_found | The job ID is not yours, or belongs to another tool. |
| 404 | file_not_found | The file expired or the name is wrong. |
| 413 | file_too_large | Send a smaller file. |
| 422 | roblox_rejected | Roblox refused the credentials or the asset. The message comes from Roblox. |
| 429 | rate_limited | Wait for Retry-After seconds. |
| 429 | too_many_jobs | Wait for a running job to finish. |
| 502 | roblox_unreachable | Roblox did not answer. Retry later. |
| 500 | internal_error | Retry later; contact support if it continues. |
