Parameter reference for the Minecraft skin render API

Every query parameter of the Minecraft skin render API: size, camera yaw and pitch, fov, layers, capes, poses, per-joint angles and fallbacks, from the code.

This page is rendered from src/lib/render/params.ts, the same table the query parser reads. 53 parameters, 24 aliases, 7 groups. If it is documented here, it exists; if it is not, it does not.

Quick table

Group	Parameters
Output	`sizewidthheightbgaacropmarginmirrordownloadfilename`
Camera	`yawpitchrollfovzoomoffsetXoffsetYfit`
Model	`modelskincape`
Layers	`overlayhatjacketleftSleeverightSleeveleftPantsrightPants`
Lighting	`shadingshadow`
Pose	`poseframeunitsheadPitchheadYawheadRollbodyPitchbodyYawbodyRollleftArmPitchleftArmYawleftArmRollrightArmPitchrightArmYawrightArmRollleftLegPitchleftLegYawleftLegRollrightLegPitchrightLegYawrightLegRollcapeAngle`
Fallback	`default`

General rules

Names are case-insensitive. Each parameter is listed under its canonical name; aliases are accepted and produce the identical image.
Booleans accept 1/0, true/false, yes/no, on/off. A bare key with no value (?crop) means true.
Angles are degrees between -360 and 360 unless units=rad. Values outside that range wrap around instead of failing.
Sizes are integers from 8 to 1024. size is the height; width and height override it.
Unknown parameters are ignored and echoed in the X-Ignored-Params response header, so a typo never breaks an image but is easy to spot.
Out-of-range values (a size of 5000, an aa of 9) answer 400 with a plain-text message naming the parameter.
A parameter that does not apply to the requested type is ignored and listed in X-Ignored-Params as well; yaw on a face render does nothing to the image.

The order of parameters in a URL does not matter, but for cache hit rates it helps to build URLs the same way every time. The playground and every example in these docs emit canonical names in table order with defaults omitted; the libraries page has URL-builder snippets you can adapt.

equivalent URLs

https://skinrender.dev/render/069a79f444e94726a5befca90e38aaf5/body?yaw=-45&pose=wave
https://skinrender.dev/render/069a79f444e94726a5befca90e38aaf5/body?rotate=-45&POSE=wave&units=deg

Output

Size, background and how the file is delivered.

size

int

Height of the image in pixels. Width follows the render type’s aspect ratio unless width is given.

Default: face 256head 256bust 256body 512front 512back 512skin 256cape 256
Range: 8 – 1024
Applies to: all types
Example: size=512

width

int alias: w

Explicit width in pixels. Overrides the aspect ratio derived from size.

Default: none
Range: 8 – 1024
Applies to: all types
Example: width=400

height

int alias: h

Explicit height in pixels. Overrides size.

Default: none
Range: 8 – 1024
Applies to: all types
Example: height=600

bg

color alias: background

Background colour as 3, 4, 6 or 8 hex digits (with or without #), or transparent.

Default: none
Range: hex colour
Applies to: all types
Example: bg=1e1e2e

aa

int

Supersampling factor for smoother edges. 1 disables anti-aliasing and is fastest. Lowered automatically so that aa² × width × height stays within 4,194,304 (2048×2048) pixels.

Default: 2
Range: 1 – 4
Applies to: head bust body
Example: aa=3

crop

bool

Trim fully transparent rows and columns from the edges of the finished image.

Default: false
Range: true | false
Applies to: head bust body
Example: crop=true

margin

number

Fraction of the canvas kept empty around the auto-framed model.

Default: 0.05
Range: 0 – 0.45
Applies to: head bust body
Example: margin=0.1

mirror

bool alias: flip

Mirror the finished image horizontally.

Default: false
Range: true | false
Applies to: all types
Example: mirror=true

download

bool alias: dl

Send the image as an attachment so browsers save it instead of displaying it.

Default: false
Range: true | false
Applies to: all types
Example: download=true

filename

string

File name used with download. Letters, digits, dashes and underscores; .png is added.

Default: none
Range: text
Applies to: all types
Example: filename=my-avatar

Camera

Where the model is viewed from. 3D renders only.

yaw

number aliases: rotateangle

Turn the model about its vertical axis, in degrees. 0 faces the camera; positive turns its right side toward you.

Default: 35
Range: -360 – 360
Applies to: head bust body
Example: yaw=-45

pitch

number alias: tilt

Tip the model toward or away from the camera, in degrees. Positive looks down on it from above.

Default: 12
Range: -360 – 360
Applies to: head bust body
Example: pitch=-20

roll

number

Rotate the whole image about the viewing axis, in degrees.

Default: 0
Range: -360 – 360
Applies to: head bust body
Example: roll=15

fov

number alias: perspective

Vertical field of view in degrees. 0 is orthographic; 30–50 gives a natural perspective, larger values exaggerate it.

Default: 0
Range: 0 – 120
Applies to: head bust body
Example: fov=40

zoom

number alias: scale

Multiplier on the auto-framed size. 2 doubles the model on the canvas.

Default: 1
Range: 0.1 – 8
Applies to: head bust body
Example: zoom=1.5

offsetX

number alias: ox

Shift the model horizontally by this fraction of the canvas width.

Default: 0
Range: -2 – 2
Applies to: head bust body
Example: offsetX=0.1

offsetY

number alias: oy

Shift the model vertically by this fraction of the canvas height. Positive moves it down.

Default: 0
Range: -2 – 2
Applies to: head bust body
Example: offsetY=-0.1

fit

bool

Auto-frame the posed model so it fills the canvas. With fit=false the camera stays fixed, so animations do not jitter between frames.

Default: true
Range: true | false
Applies to: head bust body
Example: fit=false

Model

Which texture and arm width to render.

model

enum alias: variant

Arm width. auto uses the profile’s own setting (or detects it from the texture); classic is 4 px wide, slim 3 px.

Default: auto
Values: auto | classic | slim
Applies to: head bust body front back
Example: model=slim

skin

string alias: texture

Render this texture instead of the profile’s skin: a textures.minecraft.net hash or URL.

Default: none
Range: text
Applies to: all types
Example: skin=d5c4ee5ce20aed9e33e866c66caa37178606234b3721084bf01d13320fb2eb3f

cape

bool

Draw the profile’s cape when it has one.

Default: true
Range: true | false
Applies to: head bust body front back
Example: cape=false

Layers

Toggle the second skin layer per body part.

overlay

bool alias: layers

Master switch for the second skin layer (hat, jacket, sleeves and trousers). false hides them all.

Default: true
Range: true | false
Applies to: face head bust body front back
Example: overlay=false

hat

bool alias: helmet

Show the head overlay layer.

Default: true
Range: true | false
Applies to: face head bust body front back
Example: hat=false

jacket

bool

Show the torso overlay layer.

Default: true
Range: true | false
Applies to: head bust body front back
Example: jacket=false

leftSleeve

bool

Show the left arm overlay layer.

Default: true
Range: true | false
Applies to: bust body front back
Example: leftSleeve=false

rightSleeve

bool

Show the right arm overlay layer.

Default: true
Range: true | false
Applies to: bust body front back
Example: rightSleeve=false

leftPants

bool alias: leftTrousers

Show the left leg overlay layer.

Default: true
Range: true | false
Applies to: body front back
Example: leftPants=false

rightPants

bool alias: rightTrousers

Show the right leg overlay layer.

Default: true
Range: true | false
Applies to: body front back
Example: rightPants=false

Lighting

Shading and shadow.

shading

number alias: light

Strength of the per-face shading that gives the render depth. 0 is flat, 1 matches the in-game inventory look.

Default: 1
Range: 0 – 1
Applies to: head bust body
Example: shading=0.5

shadow

bool

Draw a soft drop shadow under the feet.

Default: false
Range: true | false
Applies to: body
Example: shadow=true

Pose

Named poses and per-joint rotations, in degrees by default.

pose

enum

A named pose. Any explicit joint parameter below overrides that joint of the named pose.

Default: default
Values: default | walk | run | wave | sit | sneak | point | dab | zombie | tpose | cheer | think | flex | salute | dance | punch | shrug | jump
Applies to: bust body
Example: pose=wave

frame

number

Phase of an animated pose (walk, run, dance, wave) from 0 to 1. Step it to render the frames of a GIF.

Default: 0
Range: 0 – 1
Applies to: bust body
Example: frame=0.25

units

enum

Unit for every angle parameter: degrees or radians.

Default: deg
Values: deg | rad
Applies to: head bust body
Example: units=rad

headPitch

number

Rotation of the head about its side-to-side axis. Positive swings it forward (limbs) or tips it down (head).

Default: 0
Range: -360 – 360
Applies to: bust body
Example: headPitch=45

headYaw

number

Twist of the head about its vertical axis.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: headYaw=20

headRoll

number

Rotation of the head about its front-to-back axis. For arms and legs, positive moves the limb outward, away from the body.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: headRoll=30

bodyPitch

number

Rotation of the torso about its side-to-side axis. Positive swings it forward (limbs) or tips it down (head).

Default: 0
Range: -360 – 360
Applies to: bust body
Example: bodyPitch=45

bodyYaw

number

Twist of the torso about its vertical axis.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: bodyYaw=20

bodyRoll

number

Rotation of the torso about its front-to-back axis. For arms and legs, positive moves the limb outward, away from the body.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: bodyRoll=30

leftArmPitch

number alias: leftArm

Rotation of the left arm about its side-to-side axis. Positive swings it forward (limbs) or tips it down (head).

Default: 0
Range: -360 – 360
Applies to: bust body
Example: leftArmPitch=45

leftArmYaw

number

Twist of the left arm about its vertical axis.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: leftArmYaw=20

leftArmRoll

number

Rotation of the left arm about its front-to-back axis. For arms and legs, positive moves the limb outward, away from the body.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: leftArmRoll=30

rightArmPitch

number alias: rightArm

Rotation of the right arm about its side-to-side axis. Positive swings it forward (limbs) or tips it down (head).

Default: 0
Range: -360 – 360
Applies to: bust body
Example: rightArmPitch=45

rightArmYaw

number

Twist of the right arm about its vertical axis.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: rightArmYaw=20

rightArmRoll

number

Rotation of the right arm about its front-to-back axis. For arms and legs, positive moves the limb outward, away from the body.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: rightArmRoll=30

leftLegPitch

number alias: leftLeg

Rotation of the left leg about its side-to-side axis. Positive swings it forward (limbs) or tips it down (head).

Default: 0
Range: -360 – 360
Applies to: bust body
Example: leftLegPitch=45

leftLegYaw

number

Twist of the left leg about its vertical axis.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: leftLegYaw=20

leftLegRoll

number

Rotation of the left leg about its front-to-back axis. For arms and legs, positive moves the limb outward, away from the body.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: leftLegRoll=30

rightLegPitch

number alias: rightLeg

Rotation of the right leg about its side-to-side axis. Positive swings it forward (limbs) or tips it down (head).

Default: 0
Range: -360 – 360
Applies to: bust body
Example: rightLegPitch=45

rightLegYaw

number

Twist of the right leg about its vertical axis.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: rightLegYaw=20

rightLegRoll

number

Rotation of the right leg about its front-to-back axis. For arms and legs, positive moves the limb outward, away from the body.

Default: 0
Range: -360 – 360
Applies to: bust body
Example: rightLegRoll=30

capeAngle

number

How far the cape swings out from the back, in degrees.

Default: 10
Range: 0 – 90
Applies to: bust body
Example: capeAngle=35

Fallback

What happens when a skin cannot be found.

default

enum alias: fallback

What to render when the player has no custom skin or cannot be found. auto picks Steve or Alex the way the game does; none answers 404 instead.

Default: auto
Values: auto | steve | alex | none
Applies to: all types
Example: default=alex