Skip to content

Aurora Avatar

Fresh

Purpose

Generate studio-grade, hyper-realistic avatar videos from a single image using Creatify's state-of-the-art Aurora model.

Prerequisites

  • Authenticated API access (Authentication SOP)
  • A single high-quality portrait image (or image URL)
  • Text script or audio URL
  • Sufficient credits

What Makes Aurora Different

Aurora is Creatify's SOTA (state-of-the-art) avatar model. Unlike v1/v2 lipsync which uses pre-made avatar templates, Aurora takes a single image and produces production-quality, lifelike avatar video with:

  • Natural head movements and micro-expressions
  • Studio-grade lighting and rendering
  • Minimal artifacts compared to standard lipsync

Procedure

Step 1: Prepare Your Image

Requirements for the input image:

  • Clear, front-facing portrait
  • Good lighting, minimal shadows
  • High resolution (minimum 512x512 recommended)
  • Single person in frame
  • Publicly accessible URL

Step 2: Create an Aurora Task

bash
curl --request POST \
  --url https://api.creatify.ai/api/aurora/ \
  --header "Content-Type: application/json" \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY" \
  --data '{
    "image_url": "https://example.com/portrait.jpg",
    "text": "Welcome to our company. I am excited to share our latest innovations with you today.",
    "voice_id": "voice-uuid-001",
    "aspect_ratio": "9:16"
  }'

Key parameters:

ParameterTypeRequiredDescription
image_urlstringYesURL of the portrait image
textstringYes (or audio_url)Script for the avatar to speak
audio_urlstringYes (or text)Pre-recorded audio URL
voice_idstringYes (with text)Voice for text-to-speech
aspect_ratiostringNo9:16, 16:9, or 1:1

Response:

json
{
  "id": "aurora-task-uuid",
  "status": "pending",
  "image_url": "https://example.com/portrait.jpg"
}

Step 3: Poll for Completion

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

TIP

Aurora processing may take longer than standard lipsync due to the higher quality rendering. Poll every 10-15 seconds.

Completed response:

json
{
  "id": "aurora-task-uuid",
  "status": "done",
  "output": "https://cdn.creatify.ai/videos/aurora-output.mp4",
  "duration": 20
}

Step 4: Download Output

Download the video from the output URL.

Credit Cost

OperationCredits
List aurora items0
Create with aurora_v11 credit per second
Create with aurora_v1_fast0.5 credits per second

WARNING

Aurora billing rounds partial seconds up to the next whole second. This per-second pricing replaced the older 15-second increments in May 2026. Check the official changelog before a paid production run.

Aurora vs Lipsync v1 vs v2

FeatureLipsync v1Lipsync v2Aurora
InputAvatar IDAvatar IDsAny image
QualityGoodGoodStudio-grade
Scenes1Multiple1
RealismTemplate-basedTemplate-basedGenerative
Processing timeFastMediumLonger
Use caseQuick avatar videosMulti-scene narrativesPremium content

Verification Checklist

  • [ ] Input image is high quality and front-facing
  • [ ] Image URL is publicly accessible
  • [ ] Task creation returns pending status
  • [ ] Final status is done with valid output URL
  • [ ] Video shows natural head movements and expressions
  • [ ] Lip sync matches the text/audio accurately
  • [ ] No visual artifacts around face/hair

Common Errors

ErrorCauseFix
Image not accessiblePrivate or broken URLUse a publicly accessible image URL
Low quality outputInput image too small or blurryUse a higher resolution, well-lit portrait
Face not detectedImage does not contain a clear faceUse a front-facing portrait photo

See Also