JOjogg
Avatar

Add Motion to Photo Avatar

Changed on

Add motion to a photo avatar to make it animated

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

Request body

image_urlstring uri required

Photo avatar image URL

photo_idstring

Photo ID from photo generation

namestring required

Avatar name

voice_idstring 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.

descriptionstring

Avatar description

welcome_msgstring

Welcome message for the avatar

Example request

{
  "image_url": "https://res.jogg.ai/photo.jpg",
  "name": "My Photo Avatar",
  "voice_id": "en-US-ChristopherNeural",
  "model": "2.0-Pro",
  "welcome_msg": "Hello, welcome!"
}

Response

Success

codeinteger 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
msgstring required

Response message

Example response

{
  "msg": "Success",
  "data": {
    "avatar_id": 123,
    "motion_id": "motion_456",
    "status": "processing"
  }
}

Changes

  • 22021dd81934Revision changes
    • breaking

      removed the enum value 1.0 of the request property

    • breaking

      removed the enum value 2.0 of the request property

    • breaking

      removed the enum value 3.0 of the request property