resourcepack.ai
DOCS

Packs

Download an asset file

The asset's own bytes, with the matching content type: PNG for textures and icons, JSON for models, Ogg Vorbis for sounds.

The path takes an asset's kind and name exactly as the asset listing reports them — texture/item:rusted_key for an item sprite, texture/gui:shop_menu for a GUI, vfx/frost_burst for a VFX — so copy both from there rather than building them from its type.

A shader, text effect, VFX, emote or emote group is a document rather than stored bytes, and format says how to have it. file (the default) is that document as JSON: a VFX's recipe (what its page's Download recipe saves), a shader object, an emote's keyframes, an emote group's parts. picture is a PNG drawn on the server: a VFX as six moments across its timeline, left to right, and a 3D shader object or a text effect as its card. animation is a GIF of a VFX or a text effect playing. A 2D shader overlay and an emote have no picture on the server (the browser draws them) and answer no_file for one. A stored asset always answers its own file, whatever format says.

Asking before it's ready answers 409 rather than handing back the placeholder that sits there while it generates — a blank PNG that looked like a result is the one genuinely misleading answer available here.

GET/packs/{pack}/assets/{kind}/{name}

Path parameters

packstringrequired

The pack's slug, as returned by the packs endpoints.

kindstringrequired

The asset's kind from the listing.

Options: texture, model, font, sound, shader, vfx, emote, emote_group

namestringrequired

The asset's stored name, from the listing.

Query parameters

formatstringdefault "file"

For a shader, text effect, VFX, emote or emote group: its JSON (file), a PNG of it (picture) or a GIF of it moving (animation). Ignored for every other kind.

Options: file, picture, animation

Response · 200

The file.

Error codes

Branch on error.code, never on the message.

invalid_request400

Something in the body or query is wrong. message says what.

no_file400

That asset has nothing in the format asked for: a 2D shader overlay and an emote have no picture on the server, and only a VFX and a text effect have an animation. message says what there is.

invalid_api_key401

The key isn't one of ours, or it has been revoked.

missing_api_key401

No Authorization: Bearer header was sent.

wrong_key_kind401

An MCP key sent to the REST API, or an API key sent to the MCP server. Each only opens its own.

account_suspended403

The account is suspended, so its keys open nothing. message says until when, if the suspension has an end date.

plan_required403

The key is valid, but its account's plan does not include the API.

not_found404

No such pack, asset or job.

generation_failed409

That asset's generation failed. Its job carries the reason.

still_generating409

The asset exists but isn't finished. Poll its job until it's ready.