GET - 2D Avatars
Get a 2D render of an avatar for stickers or profile pictures.
get
https://models.readyplayer.me
Get avatar 2D render by id.
/avatarId.png
Example
ID of an avatar with .png file extension.
Expected values (String)
6185a4acfb622cf1cdc49348.png
It may take some time to render the image in the backend for the initial request. For subsequent requests, the images will be fetched from cache and delivered much faster.
Request avatar render by ID.
https://models.readyplayer.me/6185a4acfb622cf1cdc49348.png
Returned value
?scene
Example
Name of the portrait type to render.
Expected values (String)
fullbody-portrait-v1- Creates a portrait from a full-body avatar...fullbody-portrait-v1-transparent- ... with transparent background (default).halfbody-portrait-v1- Creates a portrait from a half-body avatar...halfbody-portrait-v1-transparent- ... with transparent background (default).fullbody-posture-v1-transparent- Creates a portrait with a pose from a full-body avatar.
Request avatar render with transparent fullbody posture
https://models.readyplayer.me/6185a4acfb622cf1cdc49348.png?scene=fullbody-posture-v1-transparent
Request avatar render for full body portrait on dark background
https://models.readyplayer.me/6185a4acfb622cf1cdc49348.png?scene=fullbody-portrait-v1
?blendShapes
Example
Map of 3D meshes to their blend shapes.
Expected values (String)
blendShapes[Wolf3D_Head][mouthSmile]=0.2 } Wolf3D_Headis the affected node in the avatar.mouthSmileis an example of a blend shape included in the avatar.
You can combine multiple blend shapes by concatenating them with '&' as shown in the following example:
?blendShapes[Wolf3D_Head][mouthSmile]=0.2&blendShapes[Wolf3D_Head][browInnerUp]=0.2Request a smiling avatar
https://models.readyplayer.me/6185a4acfb622cf1cdc49348.png?blendShapes[Wolf3D_Head][mouthSmile]=0.8
Returned value
You will receive a .png image of a smiling avatar.
Last modified 1mo ago