---
title: "Your own filmed video speaks a new script (voice + lip-sync onto your clip). For an AI presenter use POST /videos with mode talking-head"
method: POST
path: "/videos/talking-avatar"
tags: ["Videos"]
---

# Your own filmed video speaks a new script (voice + lip-sync onto your clip). For an AI presenter use POST /videos with mode talking-head

`POST /videos/talking-avatar`

## Request

- Base URL: `https://app.makeaivideo.ai/api/v1`
- URL: `https://app.makeaivideo.ai/api/v1/videos/talking-avatar`
- Auth: HTTP bearer

## Request body

- object
  - `avatar_video_key` string, required: From /uploads/video-avatar or /uploads/video-from-url
  - `script` string, required
  - `voice_id` string, required
  - `add_broll` boolean
  - `title` string
  - `idempotency_key` string

## Response `202`

Accepted

- object
  - `data` VideoCreated
    - `video_id` string
    - `status` 'generating' | 'draft'
    - `title` string, nullable
    - `scene_count` integer, nullable
    - `poll_after_seconds` integer, nullable
    - `next` string
  - `error` unknown
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `402`: Not enough credits

---

[API](https://skmtc.dev/makeaivideo/apis/makeaivideo-api.md) · [All operations](https://skmtc.dev/makeaivideo/apis/makeaivideo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/makeaivideo/apis/makeaivideo-api/revisions/8c6351087d6d?raw)