---
title: "Create Face"
method: POST
path: "/v2/faces"
tags: ["Faces"]
---

# Create Face

`POST /v2/faces`

Creates a new face from training video or image URL for use in conversations. See [Which training path?](/sections/faces/which-training-path) for footage requirements and [Face overview](/sections/faces/overview#platform-policies) for rights and permissions.

## Request body

- object
  - `consent_video_url` string — **Legacy.** Optional URL to a separate consent recording used with older video-training flows. New integrations should not send this field. Ensure you have the necessary rights and permissions to use any training footage - see [Platform Policies](/sections/faces/overview#platform-policies).
  - `train_video_url` string — A direct download link such as a **presigned S3 URL** or other publicly reachable file used for video-based face training. Do not send `train_image_url` in the same request. The file must meet [training video requirements](/sections/troubleshooting/training-video-size). You must have the necessary rights and permissions to use the likeness, voice, and footage you submit. See [Platform Policies](/sections/faces/overview#platform-policies).
  - `train_image_url` string — A direct link to a publicly accessible image used for image-to-face training. Requires `voice_name`. Do not send `train_video_url` in the same request. You must have the necessary rights and permissions to use the likeness and image. See [Training from an image](/sections/faces/train-with-an-image) and [Platform Policies](/sections/faces/overview#platform-policies).
  - `voice_name` string — Required when `train_image_url` is set. Slug that selects the voice from an existing Tavus stock face (case-insensitive, e.g. `anna`). If supplied with `train_video_url`, the name is still validated when present. Use [List Voices](/api-reference/voices/list-voices) to discover valid slugs; see also [example `voice_name` values](/sections/faces/train-with-an-image#example-voice-name-table).
  - `auto_fix_training_image` boolean — When set to `true`, Tavus's AI Image Fixer instantly fixes any uploaded image to fit our [image requirements](/sections/faces/train-with-an-image#image-requirements), eliminating the need for editing or recapturing photos. Only applies to image-based training (`train_image_url`).
  - `callback_url` string — A url that will receive a callback on completion of face training or on error.
  - `face_name` string — A name for the face.
  - `model_name` string — The Phoenix model version used to train the face. Defaults to `phoenix-4`; set to `phoenix-3` for the older model.
  - `properties` object
    - `background_green_screen` boolean — If set to true, the face will have a green screen background.

## Response `200`

- object
  - `face_id` string — A unique identifier for the face.
  - `status` string — The status of the face. Possible values: `started`, `completed`, `error`.

## Other responses

- `400` — Bad Request
- `401` — UNAUTHORIZED

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)