{"slug":"avatar","domain":"media","title":"Talking-head video","summary":"A photo animated and lip-synced to a voice track, as an MP4 filed under a URL.","help":"avatar: a talking-head video from a photo and a voice track.\n\nUSAGE\n  avatar make PHOTO AUDIO OUT.mp4 [--resolution 720p|1080p] [--aspect 16:9|9:16|1:1] [--motion TEXT]\n  avatar wait JOB_ID OUT.mp4\n\nMAKE\n  Animates PHOTO, a PNG, JPEG or WebP of one person facing the camera, and\n  lip-syncs it to AUDIO, an MP3, WAV or M4A of at most 30 seconds: a `voice\n  say` take works. The video is as long as the track. Writes the MP4 to OUT\n  and prints `url: …`, presigned for seven days. --motion directs how they\n  move (\"calm, small nods, looks at the camera\"). The default is 720p, 16:9.\n\n  A clip takes about a minute to make. `make` waits up to four minutes; a job\n  still running then prints its id, and `avatar wait JOB_ID OUT.mp4` picks it\n  up. Asking again makes and bills nothing more.\n\n  For a longer video, cut the narration into takes of up to 30 seconds and\n  make one clip per take from the same photo.\n\n  Animate only a face whose owner has agreed to it.\n\nCOSTS\n  Billed as avatar_video, by the second of video made. A failed job is free.","example_command":"avatar make /tmp/me.jpg /tmp/line.mp3 /tmp/me.mp4 --aspect 1:1 --resolution 1080p","example_output":"job: 9f2c…\nmade 10.6s of video to /tmp/me.mp4 (4120 KB)\nurl: https://…/avatar/9f2c….mp4?…","cost_class":"upstream-fetch","tier":"metered","billing_items":["avatar_video"],"price_per_1k_calls":125,"price_is_from":false,"status":"available","commands":["avatar"],"default_enabled":false,"first_seen":"2026-11-03T10:05:47.874374Z","enabled":false}
