---
title: "Talking Avatar"
method: POST
path: "/v1/video/talking-avatar"
tags: ["AI Video"]
---

# Talking Avatar

`POST /v1/video/talking-avatar`

## Request

- Base URL: `https://api.domoai.com`
- URL: `https://api.domoai.com/v1/video/talking-avatar`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/domoai/apis/domoai-enterprise-api/docs/v1/video/talking-avatar/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- CreateTalkingAvatarTaskIn: Input schema for creating a talking avatar task
  - `callback_url` string, uri, nullable: Callback notification URL for task results. If configured, the server will actively send notifications when the task status changes. The message schema of the notification can be found in the [Callback Protocol](/api-reference/callback/callback-protocol) section.
  - `prompt` string: Optional prompt for generation guidance.
  - `image` ImageInput
    - `domoai_uri` string, nullable
    - `bytes_base64_encoded` string, nullable
  - `video` VideoInput
    - `domoai_uri` string, nullable
    - `bytes_base64_encoded` string, nullable
  - `audio` AudioInput, required
    - `domoai_uri` string, nullable
    - `bytes_base64_encoded` string, nullable
  - `seconds` integer, required: Output video duration in seconds.
  - `aspect_ratio` '16:9' | '9:16' | '1:1' | '4:3' | '3:4'
  - `model` 'talking-avatar-v1'

## Response `200`

Successful Response

- DomoOutTaskOut
  - `code` integer
  - `data` TaskOut, required
    - `task_id` string, uuid, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/domoai/apis/domoai-enterprise-api.md) - [All operations](https://skmtc.dev/domoai/apis/domoai-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/domoai/apis/domoai-enterprise-api/revisions/287d41982970?raw)