---
title: "Add Motion to Photo Avatar"
method: POST
path: "/v2/photo_avatar/add_motion"
tags: ["Avatar"]
---

# Add Motion to Photo Avatar

`POST /v2/photo_avatar/add_motion`

## Request

- Base URL: `https://api.jogg.ai`
- URL: `https://api.jogg.ai/v2/photo_avatar/add_motion`
- Auth: API key in header `x-api-key`

Add motion to a photo avatar to make it animated

## Request body

- object
  - `image_url` string, uri, required: Photo avatar image URL
  - `photo_id` string: Photo ID from photo generation
  - `name` string, required: Avatar name
  - `voice_id` string, required: Voice ID to associate with avatar
  - `model` '2.0-Pro', required: Motion 1.0, 2.0, and 3.0 have been discontinued by the official model provider. Only Motion 2.0 Pro remains available.
  - `description` string: Avatar description
  - `welcome_msg` string: Welcome message for the avatar

## Response `200`

Success

- object
  - `code` integer, required: Business status code: * 0 - Success * 10104 - Record not found * 10105 - Invalid API key * 18020 - Insufficient credit * 18025 - No permission to call APIs * 40000 - Parameter error * 50000 - System error
  - `msg` string, required: Response message
  - `data` object
    - `avatar_id` integer: Avatar ID
    - `motion_id` string: Motion ID for tracking generation status
    - `status` 'pending' | 'processing' | 'completed' | 'failed': Motion generation status

## Changes

- **2026-11-03** `22021dd81934`: 3 breaking
  - removed the enum value `1.0` of the request property `model`
  - removed the enum value `2.0` of the request property `model`
  - removed the enum value `3.0` of the request property `model`

[Operation history](https://skmtc.dev/jogg/apis/joggai-openapi-v2/changes/v2/photo_avatar/add_motion/post.md)

---

[API](https://skmtc.dev/jogg/apis/joggai-openapi-v2.md) - [All operations](https://skmtc.dev/jogg/apis/joggai-openapi-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/jogg/apis/joggai-openapi-v2/revisions/22021dd81934?raw)