Avatar Motion
Places one portrait in a birthday or zodiac-season scene and writes your caption into the set, such as an age in gold balloons or a sign name as the title, then animates it.
Overview
Avatar Motion with Caption makes a short birthday or zodiac-season clip from one portrait and a word or number you type, and the text becomes part of the scene. In the samples, "30" floats behind the subject as gold foil balloons while confetti falls, and the zodiac scenes spell out the sign in large gold letters, as in "Leo Season". The person is first placed into a styled still, which is then animated.
Choosing a variant: Avatar Motion has no caption field but more than 250 effects, from stadium fan cams to toy figures. Pick this page when the words in the frame are the point of the video.
What you can build
- Birthday videos with the person's age in the balloons
- Zodiac-season posts, one for each sign
- A greeting feature in a messaging app that takes a selfie and an age
Inputs
- A portrait of one person, as a file or link. JPG, PNG, WEBP, GIF and HEIC are accepted.
- Caption: one or two words are suggested, such as Alex or 20. It starts at "30".
- Effect Type: Woman Birthday Mode, Man Birthday Mode, Woman Zodiac Season or Man Zodiac Season.
- Video Mode, required: Standard (default) or Pro.
- Advanced: Output Type, plus a seed from 0 to 9,999,999 that defaults to 42.
Outputs
A run returns the styled still and the clip unless Output Type limits it to one. The four sample clips are vertical and last roughly five seconds. The subject smiles and shifts a little while confetti or sparkles drift; in the man's birthday clip the camera also pushes in.
Recommended settings
For the zodiac effects, type only the sign, since the scene adds "Season" after it. Birthday sets show the caption as number balloons, so an age fits best. Match the Woman or Man version to the subject; in the birthday samples she wears a white off-shoulder satin dress and he a black suit with a turtleneck.
Limitations
- Four effects, all built around the caption, and no free prompt.
- One photo of one person per run.
Safety & compliance
Only animate portraits of people who have agreed to it.
API quick start
Run Man Birthday Mode with a single API call.
{
"caption": 30,
"videoMode": "standard",
"inputImage": "https://your-cdn.com/input.png",
"effectType": "birthdaymode-woman-birthday-mode"
}curl -X POST "https://api.wiro.ai/v1/Run/wiro/avatarmotion-with-caption" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_WIRO_API_KEY" \
--data-binary @- <<'JSON'
{
"caption": 30,
"videoMode": "standard",
"inputImage": "https://your-cdn.com/input.png",
"effectType": "birthdaymode-woman-birthday-mode"
}
JSON