What causes "D-ID Face Detection Error (No Face Detected)"?

Face turned sideways, tilted or too far from the camera Blur, heavy shadows or low light Sunglasses, hair, hands or a mask covering part of the face Image too small (head under ~200x200 px) or over the 10 MB limit Non-human or heavily stylised character the model can't map

How do I fix "D-ID Face Detection Error (No Face Detected)"?

1. Use a front-facing, well-lit photo: Pick a medium shot where the person looks straight at the camera Use a neutral expression with the mouth closed Make sure lighting is even, with no heavy shadow across the face 2. Remove anything covering the face: Avoid sunglasses, hats pulled low, hair over the eyes or hands near the face Crop out other people so only one face is in the frame 3. Check size and file limits: Make sure the head is at least 200x200 px in the image Keep the file under 10 MB Upscale or re-export a low-resolution image before uploading 4. Make stylised characters more human-like: Paintings, statues and cartoon faces can work, but only if eyes, nose and mouth are clearly drawn Refine or regenerate the image so it more closely resembles a real human face, then upload again

// troubleshooting guide · d-id

D-ID Face Detection Error (No Face Detected)

Status: Workaround available
platforms:: Web (D-ID Studio), API, mobile app
updated:: November 15, 2026
reports:: 3
Method: how we research

RUNBOOK · d-id/face-detection-error4 FIXES

// quick answer

D-ID shows a face detection error (FaceError: "No valid face detected") when it can't find a clear, animatable face in your image. A sharp, front-facing photo with nothing covering the face and a head of at least 200x200 px almost always fixes it.

Most likely fix: Use a front-facing, well-lit photo

How to fix it

// try these in order, the most common fix is first

FIX 1Use a front-facing, well-lit photo
1. 01Pick a medium shot where the person looks straight at the camera
2. 02Use a neutral expression with the mouth closed
3. 03Make sure lighting is even, with no heavy shadow across the face
Did this fix it?
FIX 2Remove anything covering the face
1. 01Avoid sunglasses, hats pulled low, hair over the eyes or hands near the face
2. 02Crop out other people so only one face is in the frame
Did this fix it?
FIX 3Check size and file limits
1. 01Make sure the head is at least 200x200 px in the image
2. 02Keep the file under 10 MB
3. 03Upscale or re-export a low-resolution image before uploading
Did this fix it?
FIX 4Make stylised characters more human-like
1. 01Paintings, statues and cartoon faces can work, but only if eyes, nose and mouth are clearly drawn
2. 02Refine or regenerate the image so it more closely resembles a real human face, then upload again
Did this fix it?

Symptoms

After uploading a photo in D-ID Studio you get "face not detected" or a face detection error, or an API job ends with status error and kind FaceError.