resourcepack.ai
DOCS

Errors

When a call fails, the HTTP status says roughly what kind of problem it is, and the body says exactly which. Every failure has the same shape:

{
  "error": {
    "code": "insufficient_credits",
    "message": "You don't have enough AI Credits for this."
  }
}

Branch on code, never on message. The wording can change; the code won't. message is safe to show to a person.

StatusCodeWhat happened
400invalid_requestSomething in the body or query is wrong; message says what
400invalid_jsonThe body wasn't a JSON object
400invalid_job_handleA job handle that isn't <pack>:<kind>:<name> or <pack>:import
400file_fetch_failedA file given by url couldn't be downloaded
400not_a_packAn import's file isn't a resource pack, or holds nothing usable
400no_fileThat asset has nothing in the format asked for: a 2D shader overlay and an emote have no picture, and only a VFX and a text effect have an animation
400nothing_to_exportThe pack holds nothing that export format is built from yet, or it is all still generating
401missing_api_keyNo Authorization: Bearer header
401invalid_api_keyThe key isn't one of ours, or has been revoked
401wrong_key_kindAn MCP key sent to the REST API, or an API key sent to the MCP server
402insufficient_creditsNot enough AI Credits. Nothing was started or charged
402distribution_capThis month's players are at your plan's limit, so a new release can't be published
403plan_requiredThe key is valid but the account's plan does not include the API
403account_suspendedThe account is suspended; message says until when
403forbiddenValid key, but not allowed to do this in this pack
403pack_limit_reachedYour plan's pack limit
403asset_limit_reachedThis pack's asset limit
404not_foundNo such pack, asset or job
404job_not_foundNo job by that handle
404upload_not_foundNo upload by that id. Uploads expire after 15 minutes and can be used once
404no_such_playerNo account has verified that Minecraft username; invite them by email instead
409conflictThat vanilla target is already reskinned in this pack
409already_runningAn AI edit or generation of that asset is still running
409not_a_vehicleThe model isn't a vehicle yet
409not_linkedNobody is linked to receive a push; get a code from GET /packs/{pack}/link
409skin_limit_reachedThe account holds as many skins as it may
409server_limit_reachedThe pack is bound to as many servers as it may
409still_generatingYou asked for an asset's file before it was ready
409generation_failedThat asset's generation failed; its job has the reason
413file_too_largeThe file is over the limit for its use; message says the limit
429rate_limitedOver this key's budget; see Rate limits
429too_many_invitesThe pack has as many invitations waiting as it may
429daily_limitPublishing to the gallery: today's free title and description writing is used up. Send title, description and tags yourself, or try tomorrow
500export_failedThe export couldn't be built
500request_failedSomething went wrong with no more specific code
502push_failedThe pack was built but the player's server couldn't be reached, or refused it
503unavailableThe feature behind this endpoint is switched off

Each endpoint page lists the codes it can return, under Error codes.

Credits and failures#

A generation reserves its credits when the job is accepted, not when it finishes. If the run fails, the credits are refunded automatically and the asset stays in the pack with the error on it. So a 402 means nothing started, and a job that ends in error has already been refunded by the time you read it.