# KeenFace API

> A REST API that reconstructs a 3D head mesh and texture from a handful of photos, with usage-based credit billing.

Automatic multi-view 3D head reconstruction: send a few photos from any angle and get back a MetaHuman-compatible mesh, texture, and ARKit blendshapes, with no calibration, rigs, or depth-sensing hardware required.

Base URL: https://api.keenface.ai. Authenticate with `Authorization: Bearer <API key>`; keys are issued at https://keenface.ai/api-keys. Flow: `POST /v2/heads` with 1-15 photos (multipart, or `ph_…` ids from `POST /v2/photos`) → wait with `GET /v2/heads/{id}?wait=600`, the event stream, or a webhook → `GET /v2/heads/{id}/model` → download the signed URL it returns. Set `scan_reconstruction: true` for a deliberately captured multi-angle photo set.

## Docs
- [API reference (Markdown)](https://keenface.ai/docs/reference.md): full endpoint reference
- [OpenAPI spec](https://keenface.ai/docs/schema.yaml)

## Pricing
- [Pricing](https://keenface.ai/pricing): usage-based credits, pay only for the operations each request runs

## Solutions
- [MetaHumans](https://keenface.ai/solutions/metahumans): shortcut character creation by delivering MetaHuman topology straight into your character pipeline
- [Medical & Healthcare](https://keenface.ai/solutions/medical): convert more patients by visualising their treatment outcome before they commit
- [3D Characters](https://keenface.ai/solutions/cg-vfx): free up sculpting time with a 70-80% accurate base mesh and matched cameras
- [Gaming](https://keenface.ai/solutions/gaming): improve players' experience by personalising in-game characters at scale
- [Enterprise Avatars](https://keenface.ai/solutions/digital-humans): hyper-realistic digital human agents, without scanning, CG artists and the wait
- [Virtual Try-On](https://keenface.ai/solutions/virtual-try-on): help customers make the right decision on their own head

## Optional
- [Interactive reference](https://keenface.ai/docs): Scalar UI, requires JavaScript
- [API reference (HTML)](https://keenface.ai/docs/reference): the same reference as a web page
- [API v1 reference (Markdown)](https://keenface.ai/docs/v1/reference.md): the previous API, still served for existing integrations