TAtavus
Faces

List Faces

Changed on

Returns all faces (realistic or stylized human likenesses trained with Phoenix) created by the account associated with the API key.

Legacy: /v2/replicas and replica_id / replica_ids remain supported as aliases.

get/v2/faces

Request

  • Base URL
    https://tavusapi.com
  • URL
    https://tavusapi.com/v2/faces
  • Auth
    API key in header x-api-key

Query parameters

limitinteger

The number of faces to return per page.

pageinteger

The page number to return

verboseboolean

If set to true, the response will include additional face data such as the face type.

face_type'user' | 'system'

If set to user, the response will only include user faces. If set to system, the response will only include stock faces.

face_idsstring

A comma separated list of face ids to filter the response by. Example: face_ids=rc9cff32ceba

model_namestring

Filter the list to faces trained on a specific Phoenix model (phoenix-4.5, phoenix-4, or phoenix-3 legacy).

Response

total_countinteger

The total number of faces given the filters provided.

Example response

{
  "data": [
    {
      "face_id": "rc9cff32ceba",
      "face_name": "My Face",
      "default_voice_id": "v0a1b2c3d4e5f",
      "original_voice_id": "v0a1b2c3d4e5f",
      "training_progress": "100/100",
      "status": "completed",
      "finetune_status": "training",
      "face_type": "user'",
      "model_name": "phoenix-4.5"
    }
  ],
  "total_count": 42
}

Changes

  • 932c24e63be2Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status