---
title: "Create a WebM Video"
method: POST
path: "/v1/video.webm"
tags: ["Videos"]
---

# Create a WebM Video

`POST /v1/video.webm`

Generates a webm video with transparent background and an avatar speaking the input text. You can customize the avatar's pose, style, and voice, as well as the dimensions of the video.

## Headers

- `x-api-key` string

## Request body

- object
  - `avatar_pose_id` string — The ID of the avatar's pose. You can specify this field from the response of avatar.list API
  - `avatar_style` 'normal' | 'closeUp' — The style of the avatar. Can be "normal" or other styles supported by the API. 'circle', 'closeUp', 'normal', 'voiceOnly'.
  - `input_text` string — The text that the avatar will speak in the video.
  - `voice_id` string — The ID of the voice that the avatar will use.
  - `input_audio` string — input audio url. Specify either input_text/voice_id or input_audio.
  - `dimension` object — The dimensions of the output video will be scaled by the height of the original avatar size.
    - `width` integer
    - `height` integer

## Response `200`

200

## 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)