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

# Talking Avatar

`POST /v1/video/talking-avatar`

## 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.net/domoai/apis/domoai-enterprise-api.md) · [All operations](https://skmtc.net/domoai/apis/domoai-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/domoai/domoai-enterprise-api/versions/287d41982970/schema)