MeduxMedux

Clone > Create Avatar by Image

Create Avatar by Image

Create a reusable avatar asset from an uploaded image file.

POST/api/app/v1/clone/avatar/by_image

Examples

curl -X POST https://api.medux.io/api/app/v1/clone/avatar/by_image \
  -H 'Authorization: Bearer $MEDUX_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"file_id":"FILE_ID","title":"Demo title"}'

Media Samples

Approved examples for understanding request inputs, response shape, and official example output.

Official avatar clone from image

This example uses avatar-image-clone-standard.

Sample request

Clone a reusable avatar from a portrait image.

file_id{file_id}sourceOfficial sample portrait image for testingtitleOfficial avatar image clone samplemodel_idavatar-image-clone-standard

Sample response

Official example output for preview only. It is not a user Media Result.

avatar_asset_idofficial_avatar_demo_image_001

Example output

Auth Requirements

Authentication is required via Authorization header.

Preconditions

Requires a valid image file_id.

Use a clear portrait-style image for best results.

Request

Body

application/json
Authorizationstringrequired

Bearer token or API key.

Location: HEADER

file_idstringrequired

No description provided.

Location: BODY

titlestringoptional

No description provided.

Location: BODY

Response

Response

application/json
codeint32optional

Application response code.

CodeMeaning
0OK
12Invalid input
1401Insufficient credits
1402Asset category does not match this operation
1404Provider returned an error
1405Provider request timed out
13Authentication is required
16Rate limit exceeded
99Server error

Available options: 0 12 1410 1409 1401 1406 1402 1404 1405 13 16 99

Location: RESPONSE

data.assetobjectoptional

No description provided.

Location: RESPONSE

data.paid_plan_requiredobjectoptional

No description provided.

Location: RESPONSE

data.taskobjectoptional

No description provided.

Location: RESPONSE

messagestringoptional

No description provided.

Available options: ok invalid input invalid model paid plan required insufficient credits asset limit reached asset category mismatch provider error provider timeout unauthenticated rate limit server error

Location: RESPONSE

MCP Tool

This endpoint is also available through the Medux-hosted remote MCP service.

Avatar / Clone by Image

Clone a reusable avatar from a portrait image file.

Invocation Example

Clone a reusable avatar from the uploaded portrait image {file_id}. Title it Official avatar image clone sample.

medux_avatar_clone_by_imageResult: avatar_asset
file_id{file_id}titleOfficial avatar image clone sample