Custom Avatar (BYOA)

Fresh

Purpose

Create a custom AI avatar by uploading consent and lipsync training videos (Bring Your Own Avatar) through the Creatify API. Processing takes 1-2 business days.

Prerequisites

• Authenticated API access (Authentication SOP)
• Consent video: person reading the consent statement on camera
• Lipsync training videos: person speaking naturally on camera (multiple angles recommended)
• All videos must feature the same person

Procedure

Step 1: Record Consent Video

The consent video must show:

• The person's face clearly visible
• Person reading the Creatify consent statement aloud
• Good lighting and audio quality
• No background noise

WARNING

Creatify requires explicit consent from the person whose likeness will be used. Without a valid consent video, the custom avatar request will be rejected.

Step 2: Record Lipsync Training Videos

For best results:

• Record 2-5 minutes of natural speech
• Use good lighting (front-facing, no harsh shadows)
• Keep the head relatively still
• Speak at a normal pace
• Upload as MP4 format

Step 3: Submit BYOA Request

v1 Custom Avatar:

curl --request POST \
  --url https://api.creatify.ai/api/custom_avatars/ \
  --header "Content-Type: application/json" \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY" \
  --data '{
    "name": "My Custom Avatar",
    "consent_video_url": "https://example.com/consent-video.mp4",
    "training_video_urls": [
      "https://example.com/training-video-1.mp4",
      "https://example.com/training-video-2.mp4"
    ]
  }'

v2 Custom Avatar (higher quality):

curl --request POST \
  --url https://api.creatify.ai/api/custom_avatars/v2/ \
  --header "Content-Type: application/json" \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY" \
  --data '{
    "name": "My Custom Avatar v2",
    "consent_video_url": "https://example.com/consent-video.mp4",
    "training_video_urls": [
      "https://example.com/training-video-1.mp4",
      "https://example.com/training-video-2.mp4"
    ]
  }'

Response:

{
  "id": "custom-avatar-uuid",
  "name": "My Custom Avatar",
  "status": "processing"
}

Step 4: Wait for Processing

Custom avatars take 1-2 business days to process. Creatify's team reviews the consent video and trains the model on your lipsync videos.

Step 5: Check Status

curl --request GET \
  --url https://api.creatify.ai/api/custom_avatars/custom-avatar-uuid/ \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY"

Completed response:

{
  "id": "custom-avatar-uuid",
  "name": "My Custom Avatar",
  "status": "done",
  "thumbnail": "https://cdn.creatify.ai/avatars/custom-avatar.jpg"
}

Step 6: Use Your Custom Avatar

Once ready, use the id as the creator parameter in:

• AI Avatar v1 -- "creator": "custom-avatar-uuid"
• AI Avatar v2 -- in each scene's creator field

Managing Custom Avatars

List all custom avatars:

curl --request GET \
  --url https://api.creatify.ai/api/custom_avatars/ \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY"

Delete a custom avatar:

curl --request DELETE \
  --url https://api.creatify.ai/api/custom_avatars/custom-avatar-uuid/ \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY"

Credit Cost

Operation	Credits
Submit BYOA request	Varies (check plan)
List custom avatars	0
Delete custom avatar	0

Verification Checklist

• [ ] Consent video clearly shows the person and audible consent statement
• [ ] Training videos are high quality with good lighting
• [ ] All videos feature the same person
• [ ] Submission returns a valid ID with processing status
• [ ] After 1-2 days, status changes to done
• [ ] Custom avatar produces realistic lipsync when used

---

See Also

• Design Your Own Avatar SOP -- AI-generated avatar (no video upload needed)
• AI Avatar v1 SOP -- Use custom avatar in single-scene videos
• AI Avatar v2 SOP -- Use custom avatar in multi-scene videos