Skip to main content

Big Ears

Sean Moore Lionel Quinn Lydia Ellis Bryan Phelps Ronald Frank Annette Klein Brent Hill Stanley Newman Grace Singleton

Implementation of Face Generator by The Visual Team. Licensed under CC BY 4.0.

note

While our code is MIT licensed, the design is licensed under CC BY 4.0. See license overview for more information.

Usage#

HTTP-API (recommended)#

Our free HTTP-API is the easiest way to use this avatar style. Just use the following URL as image source.

https://avatars.dicebear.com/api/big-ears/:seed.svg

See the HTTP API documentation for more information.

NPM#

Install the Avatars and this avatar style with the following command.

npm install --save @dicebear/avatars @dicebear/big-ears

Now you are ready to create your first Avatar.

import { createAvatar } from '@dicebear/avatars';
import * as style from '@dicebear/big-ears';
let svg = createAvatar(style, {
seed: 'custom-seed',
// ... and other options
});

Options#

Base options#

seed

Seed

Alias: s

Default: undefined

Type: string

dataUri

Data URI

Default: false

Type: boolean

flip

Flip

Default: false

Type: boolean

rotate

Rotate

Default: 0

Type: integer

Minimum: 0

Maximum: 360

scale

Scale

Default: 100

Type: integer

Minimum: 0

Maximum: 200

radius

Radius

Alias: r

Default: 0

Type: integer

Minimum: 0

Maximum: 50

size

Size

Default: undefined

Type: integer

Minimum: 1

backgroundColor

Background Color

Alias: b

Default: undefined

Type:

translateX

Translate X%

Default: 0

Type: integer

Minimum: -100

Maximum: 100

translateY

Translate Y%

Default: 0

Type: integer

Minimum: -100

Maximum: 100

Style options#

hair

Hair

Default: long20, long19, long18, long17, long16, long15, long14, long13, long12, long11, long10, long09, long08, long07, long06, long05, long04, long03, long02, long01, short20, short19, short18, short17, short16, short15, short14, short13, short12, short11, short10, short09, short08, short07, short06, short05, short04, short03, short02, short01

Type: array

Items:

Type: string

Enum: long20, long19, long18, long17, long16, long15, long14, long13, long12, long11, long10, long09, long08, long07, long06, long05, long04, long03, long02, long01, short20, short19, short18, short17, short16, short15, short14, short13, short12, short11, short10, short09, short08, short07, short06, short05, short04, short03, short02, short01

face

Face

Default: variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

Type: array

Items:

Type: string

Enum: variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

mouth

Mouth

Default: variant0708, variant0707, variant0706, variant0705, variant0704, variant0703, variant0702, variant0701, variant0405, variant0605, variant0604, variant0603, variant0602, variant0601, variant0505, variant0504, variant0503, variant0502, variant0501, variant0404, variant0403, variant0402, variant0401, variant0305, variant0304, variant0303, variant0302, variant0301, variant0205, variant0204, variant0203, variant0202, variant0201, variant0105, variant0104, variant0103, variant0102, variant0101

Type: array

Items:

Type: string

Enum: variant0708, variant0707, variant0706, variant0705, variant0704, variant0703, variant0702, variant0701, variant0405, variant0605, variant0604, variant0603, variant0602, variant0601, variant0505, variant0504, variant0503, variant0502, variant0501, variant0404, variant0403, variant0402, variant0401, variant0305, variant0304, variant0303, variant0302, variant0301, variant0205, variant0204, variant0203, variant0202, variant0201, variant0105, variant0104, variant0103, variant0102, variant0101

ear

Ear

Default: variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

Type: array

Items:

Type: string

Enum: variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

eyes

Eyes

Default: variant32, variant31, variant30, variant29, variant28, variant27, variant26, variant25, variant24, variant23, variant22, variant21, variant20, variant19, variant18, variant17, variant16, variant15, variant14, variant13, variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

Type: array

Items:

Type: string

Enum: variant32, variant31, variant30, variant29, variant28, variant27, variant26, variant25, variant24, variant23, variant22, variant21, variant20, variant19, variant18, variant17, variant16, variant15, variant14, variant13, variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

cheek

Cheek

Default: variant06, variant05, variant04, variant03, variant02, variant01

Type: array

Items:

Type: string

Enum: variant06, variant05, variant04, variant03, variant02, variant01

cheekProbability

Cheek Probability

Default: 50

Type: integer

Minimum: 0

Maximum: 100

nose

Nose

Default: variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

Type: array

Items:

Type: string

Enum: variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

sideburn

Sideburn

Default: variant07, variant06, variant05, variant04, variant03, variant02, variant01

Type: array

Items:

Type: string

Enum: variant07, variant06, variant05, variant04, variant03, variant02, variant01

frontHair

Front Hair

Default: variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

Type: array

Items:

Type: string

Enum: variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

hairColor

Hair Color

Default: variant01, variant02, variant03, variant04, variant05, variant06, variant07, variant08, variant09, variant10

Type: array

Items:

Type: string

Enum: variant01, variant02, variant03, variant04, variant05, variant06, variant07, variant08, variant09, variant10

or

Type: string

Pattern: ^#([a-fA-F0-9]{3}|[a-fA-F0-9]{4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$

skinColor

Skin Color

Default: variant01, variant02, variant03, variant04, variant05

Type: array

Items:

Type: string

Enum: variant01, variant02, variant03, variant04, variant05

or

Type: string

Pattern: ^#([a-fA-F0-9]{3}|[a-fA-F0-9]{4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$