Images to 3D head

Automatic multi-view 3D head reconstruction technology, delivered as a REST API that brings likeness-driven digital people to your applications and pipelines.

Try in Playground

Loading preview...

# 1. Open a session. Returns an avatar id and photo upload URLs
curl -X POST https://api.cloud.keentools.io/v1/avatar/init \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "image_count": 5 }'

# 2. Upload each photo to its pre-signed URL
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo-1.jpg

# 3. Start reconstruction on the session.
#    BILLABLE: every /process call is charged to your credit wallet.
#    Call it once per head and poll for the result (step 4); do not retry it.
curl -X POST https://api.cloud.keentools.io/v1/avatar/$AVATAR_ID/process \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "focal_length_type": { "focal_length_type": "estimate_common" } }'

# 4. Poll until "status": "completed" (free), then download OBJ + texture as a ZIP
curl -X GET https://api.cloud.keentools.io/v1/avatar/$AVATAR_ID/get-status \
  -H "Authorization: Bearer $API_KEY"

curl -L -X GET "https://api.cloud.keentools.io/v1/avatar/$AVATAR_ID/get-3d-model?mesh_format=obj&texture=jpg" \
  -H "Authorization: Bearer $API_KEY" \
  -o head.zip

# 5. Parameters, formats, pricing and the full API reference: https://cloud.keentools.io/docs