---
title: "Create Avatar Video (V2)"
method: POST
path: "/v2/video/generate"
tags: ["Videos"]
---

# Create Avatar Video (V2)

`POST /v2/video/generate`

This API now generates videos with our New AI Studio backend.

## Request body

- object
  - `caption` boolean — Whether to add a caption to the video.
  - `title` string — Title of this video
  - `callback_id` string — A custom ID for callback purposes.
  - `dimension` object, required
    - `width` integer
    - `height` integer
  - `video_inputs` object[], required
    - `character` object — Could be an `avatar` or `talking photo`.
      - `type` 'avatar' | 'talking_photo' — Could be either `avatar` or `talking_photo`(for photo avatars).
      - `avatar_id` string — Provide either `avatar_id` or `talking_photo_id`.
      - `talking_photo_id` string — Provide either `avatar_id` or `talking_photo_id`.
      - `scale` number, float — _applies to both `avatar` and `talking_photo` type._
      - `avatar_style` 'circle' | 'closeUp' | 'normal' — _applies to this `avatar` type._
      - `offset` object — _applies to both `avatar` and `talking_photo` type._
        - `x` number, float
        - `y` number, float
      - `matting` string — _applies to both `avatar` and `talking_photo` type._
      - `circle_background_color` string — _applies to both `avatar` and `talking_photo` type._
      - `talking_photo_style` string — _applies to this `talking_photo` type._
      - `talking_style` 'stable' | 'expressive' — _applies to this `talking_photo` type._
      - `expression` 'default' | 'happy' — _applies to this `talking_photo` type._
      - `super_resolution` string — _applies to this `talking_photo` type._
    - `voice` object — could be TextVoiceSettings or AudioVoiceSettings or SilenceVoiceSettings
      - `type` string — must be text
      - `voice_id` string — voice id
      - `input_text` string — script to drive the voice
      - `speed` number, float — Voice speed, value between 0.5 and 1.5. Default is 1.
      - `pitch` integer — Voice pitch, value between -50 and 50. Default is 0.
      - `emotion` 'Excited' | 'Friendly' | 'Serious' | 'Soothing' | 'Broadcaster' — Voice emotion, if voice support emotion.
      - `locale` string — Allows to specify voice accents/locales for multilingual voices. (e.g., en-US, en-IN, pt-PT, pt-BR )
    - `background` object — could be ColorBackground, ImageBackground or VideoBackground
      - `type` 'color' | 'image' | 'video' — could be `color`, `image`, `video`
      - `value` string — _applies to `color` type._
      - string
  - `folder_id` string — Allows them to specify the video output folder destination.
  - `callback_url` string — A custom curl for callback

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/heygen/apis/heygen-api.md) · [All operations](https://skmtc.net/heygen/apis/heygen-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heygen/heygen-api/revisions/2f19176d6d56/schema)