Velo Library API
Plain HTTPS. Images answer with the image itself, so an endpoint drops straight into an <img>, a Discord embed or a plugin.
Rate limits
| Tier | Requests | Item icons | Renders | Server pings | Heavy (spark, plugins) | Seed map |
|---|---|---|---|---|---|---|
| No key (per IP) | 30 / min | 300 / min | 15 / min | 5 / min | 2 / min | 60 / min |
| Free key | 300 / min | 1500 / min | 100 / min | 30 / min | 10 / min | 300 / min |
| Velo+ | 1500 / min | 5000 / min | 500 / min | 150 / min | 30 / min | 1000 / min |
Cached answers don't count. Answers carry X-RateLimit-Remaining and X-RateLimit-Tier; over the limit you get 429 with Retry-After. Send a key as Authorization: Bearer velo_… or ?key=velo_…. When the Library is paused or busy it answers 503 - try again later.
Endpoints
GET
UUID, name history, skins, cape, model
/v2/player/:nameGET
available / taken
/v2/name/:nameGET
the raw skin texture
/v2/skin/:name.pngGET
?size=8-1024 &overlay=false &style=3d
/v2/head/:name.pngGET
?pose= &yaw= &pitch= &size= &bg= &layers3d= &slim= &cape= - head/rarm/larm/rleg/lleg=x,y,z for custom poses
/v2/render/:name.png|.gifPOST
your own skin PNG as the body, same options
/v2/render/custom.pngGET
pose names
/v2/posesGET
item or block icon by name or 1.8 numeric id, ?size=16-512
/v2/item/:id.pngGET
search names and ids
/v2/items?q=GET
status: players, version, MOTD (plain, MiniMessage, legacy, HTML), icon, 24 h history
/v2/server/:addressGET
the server icon
/v2/server/:address/icon.pngGET
size, theme, c1, c2, accent, angle, texture, pattern, title, lines, icon, font, layout, players, ping, address, version, glow, radius, animate
/v2/banner/:address.png|.gifGET
a server list entry as PNG (mm = MiniMessage, or legacy=)
/v2/motd/render.png?mm=GET
MiniMessage -> plain, legacy, HTML
/v2/motd/convert?mm=GET
gradient / animation frames (mode=wave|shift|pulse|static, format=tab|minimessage|legacy)
/v2/gradient?text= &colors=GET
every colour format + nearest vanilla colour
/v2/color/:hexGET
JVM flags and start script
/v2/flags?ram= &software= &gc= &os=GET
spark profile analysis
/v2/spark/:idPOST
{"text": "/plugins output"} or {"plugins": [{name, version}]}
/v2/plugins/checkGET
slime chunks around a chunk
/v2/seed/:seed/slime?cx= &cz= &r=GET
biome tile (scale 1/4/16/64/256, x, z, w, h)
/v2/seed/:seed/tile.pngGET
x0, z0, x1, z1, types
/v2/seed/:seed/structuresGET
community presets (motd, tab, banner, pose, enchant, flags, seed)
/v2/presets?tool=GET
a hosted pack's info and server.properties lines
/v2/packs/:sha1