Creatify Custom Avatar API (BYOA + DYOA)

Two methods to create custom AI avatars:

• BYOA (Bring Your Own Avatar): Upload consent + training videos of a real person. Processing: 1-2 business days.
• DYOA (Design Your Own Avatar): Describe appearance in text, AI generates the avatar. Processing: minutes.

BYOA vs DYOA Comparison

| Feature | DYOA | BYOA | |---------|------|------| | Input | Text description | Video recordings | | Processing time | Minutes | 1-2 business days | | Consent required | No | Yes (consent video) | | Realism | AI-generated appearance | Based on real person | | Best for | Fictional/branded avatars | Real spokesperson |

BYOA Workflow

1. Record consent video: face clearly visible, person reads Creatify consent statement aloud, good lighting and audio.
2. Record lipsync training videos: 2-5 minutes of natural speech, good lighting, head relatively still, MP4 format.
3. Submit BYOA request via POST /api/custom_avatars/ (v1) or /api/custom_avatars/v2/ (v2, higher quality).
4. Wait 1-2 business days, poll /api/custom_avatars/{id}/ for status.
5. Once status is "done", use the avatar ID as the "creator" parameter in lipsync endpoints.

BYOA v1 request body:

{
  "name": "My Custom Avatar",
  "consent_video_url": "https://example.com/consent-video.mp4",
  "training_video_urls": ["https://example.com/training-1.mp4"]
}

DYOA Workflow

DYOA avatar creation is managed through the Creatify dashboard (not via API). Steps:

1. Log in to creatify.ai, navigate to Avatars > Design Your Own.
2. Describe the avatar: age, gender, ethnicity, hair, clothing, setting.
3. AI generates the avatar.
4. Once approved, it appears in your API avatar list via GET /api/dyoa/.

Use the DYOA avatar ID as the "creator" parameter in lipsync calls.

Managing Custom Avatars

• List all: GET /api/custom_avatars/
• Get by ID: GET /api/custom_avatars/{id}/
• Delete: DELETE /api/custom_avatars/{id}/
• List DYOA: GET /api/dyoa/