Avatar Assets¶

Avatar assets bind a visual identity to the selected talking-head backend. A model may be connected, but session creation still fails or looks wrong if the avatar bundle does not match that model.

Minimal rule¶

The avatar manifest.json must declare a model_type compatible with the selected session model:

Model	Typical avatar requirement
`mock`	Preview/reference image only.
`wav2lip`	Reference frames or prepared Wav2Lip frame assets.
`quicktalk`	`metadata.asset_root` and `metadata.template_video`.
`flashhead`	Reference image for the FlashHead session.
`flashtalk`	Portrait/reference image compatible with the backend service.

Example manifest¶

examples/avatars/quicktalk-demo/manifest.json

{
  "id": "quicktalk-demo",
  "name": "QuickTalk Demo",
  "model_type": "quicktalk",
  "fps": 25,
  "sample_rate": 16000,
  "width": 512,
  "height": 512,
  "metadata": {
    "asset_root": "/absolute/path/to/models/quicktalk/hdModule",
    "template_video": "/absolute/path/to/template.mp4"
  }
}

Prepare and validate¶

Use the existing avatar guide for the complete schema and preparation scripts:

Verify the server sees the avatar:

terminal

curl -s http://127.0.0.1:8000/avatars | jq

When troubleshooting, check three values together: session model, avatar model_type, and /models backend.