​
🚀 Introduction

With Bring Your Own Avatar (BYOA), you can upload your own consent and lipsync videos to create a personalized speaking avatar within the Creatify platform. This feature is designed for users who want to go beyond default personas and introduce custom characters for more control and brand alignment.

​
🧾 Step 1: Submit a BYOA Request

Use the POST /api/personas_v2/ endpoint to upload your custom avatar assets. This must be a multipart/form-data request.

​
✅ Required Fields

  • lipsync_input – MP4 file used for lipsync training (e.g., a person speaking plain text)
  • consent_video – MP4 file granting usage rights
  • creator_name – Name for the avatar (e.g., “James”)
  • gender – Gender identifier (e.g., “m”, “f”)
  • video_scene – Context or background category (e.g., “office”)

​
📤 Example Curl Request

curl -X POST https://api.creatify.ai/api/personas_v2/ \
  -H "X-API-ID: <api-id>" \
  -H "X-API-KEY: <api-key>" \
  -F "lipsync_input=@./lipsync_input.mp4" \
  -F "consent_video=@./consent_video.mp4" \
  -F "creator_name=James" \
  -F "gender=m" \
  -F "video_scene=office"
🎬 Ensure both video files are valid formats: video/mp4 or video/quicktime

​
🔍 Step 2: Check BYOA Status

After submission, use GET /api/personas/{id}/ to check the approval status of your avatar.

​
Example Request

curl --request GET \
  --url https://api.creatify.ai/api/personas/{id}/ \
  --header 'X-API-ID: <your-api-id>' \
  --header 'X-API-KEY: <your-api-key>'

​
What to Look For

  • "is_active": false – Avatar is still under review by Creatify
  • "is_active": true – Avatar has been approved and is ready for use
⏱️ Reviews are typically completed within 24 hours

​
📌 Notes

  • You can retrieve your avatars using GET /api/personas_v2/
  • Your approved BYOA avatar can then be used in any compatible API such as Lipsync, Lipsync V2, or Create Video from URL

​
🤝 Need Help?

If you have any issues or need assistance, please contact api@creatify.ai