KonPro Logo

Add Motion to Photo Avatar

POSThttps://api.konpro.ai/v1/photo_avatar/add_motion

Enhance an existing photo avatar by adding motion animations. This will generate a new avatar ID representing the animated version.

Request History

Log in to see full request history

TIMESTATUSUSER AGENT
Make a request to see history.

0 Requests This Month

cURL Request

shell
curl --request POST \
--url https://api.konpro.ai/v1/photo_avatar/add_motion \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-api-key: <your-api-key>' \
--data '{
  "id": "photoAvatar123",
  "prompt": "Smooth walking motion with head tilt",
  "motion_type": "consistent"
}'

Request Body Parameters

FieldTypeDescription
idstringThe unique identifier of the photo avatar to animate (required)
promptstringText description of the motion or movement style desired (optional)
motion_typestringType of motion animation. Defaults to "consistent". Options: "consistent", "consistent_gen_3", "expressive", "hailuo_2", "veo2", "seedance_lite", "kling" (optional)

Response

Response Structure

Returns the ID of the newly created animated avatar. Error messages if motion addition fails.

Sample Successful Response

json
{
  "animated_avatar_id": "animatedAvatar456",
  "original_id": "photoAvatar123",
  "motion_type": "consistent",
  "prompt": "Smooth walking motion with head tilt",
  "status": "processing",
  "message": "Motion animation started successfully",
  "estimated_completion": "2024-01-15T12:15:00Z"
}

Notes

  • Requires API authentication.
  • The id must reference an existing photo avatar.
  • Motion addition is asynchronous and may take several minutes to complete.
  • Multiple motion types are available for different animation styles.
  • The prompt parameter allows customization of motion behavior.
  • Use the animated_avatar_id to reference the new animated version.
  • Refer to Error Responses for error information.

Example Usage

Shell
curl --request POST \
--url https://api.konpro.ai/v1/photo_avatar/add_motion \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-api-key: <your-api-key>' \
--data '{
  "id": "photoAvatar123",
  "prompt": "Smooth walking motion with head tilt",
  "motion_type": "consistent"
}'

LANGUAGE

CREDENTIALS

HEADER

RESPONSE

Examples

Choose an example:

application/json
200 - Success
400 - Bad Request
Generate Photo Avatar LooksAdd Sound Effect