Skip to main content
In the widget editor, choose Avatar → Choose avatar → My avatars → Create custom avatar. Enter a name and upload a photo or use your webcam. Use a sharp square JPEG, PNG or WebP image up to 4.5 MB, ideally at least 1152 × 1152 pixels, with room around the head and shoulders. Confirm that you have the rights and permission to use it. Creation has a one-time credit price, shown before confirmation. Credits are reserved while processing and charged once after success. Definite failures release the reservation. An uncertain result stays in processing while it is checked; reuse the same request ID instead of starting another paid creation. If no result can be confirmed within 24 hours, the reservation is released and any late result is deleted. Stored avatars have no recurring storage charge. Live avatar usage is billed separately. If credits are insufficient, an enabled saved automatic top-up rule is tried using its existing payment terms. Otherwise choose Add credits, then refresh the balance and retry. A top-up payment must be credited to the workspace before creation can proceed. New custom avatars are private to the workspace that creates them. The shared avatar library shows the avatars available to your workspace. In My avatars, select a ready avatar and confirm with Use avatar, just like in the avatar library. To delete an avatar, use the trash icon on its picture, after selecting another avatar in every widget using it. Deletion does not refund creation credits. In Choose avatar, use the Style filter to narrow the avatar library. Select Custom or choose a named style available to your workspace.

API, MCP, CLI and SDK

The catalog returns styles on every page. Pass an exact value from that list as style to filter the next request. REST: GET /api/v1/avatars/capability, POST /api/v1/avatars/uploads, POST /api/v1/avatars, GET /api/v1/avatars, GET /api/v1/avatars/{id}, DELETE /api/v1/avatars/{id}, GET /api/v1/avatars/catalog. MCP: get_avatar_capability, create_avatar_upload, submit_avatar, list_avatars, get_avatar, delete_avatar, list_avatar_catalog.