---
title: "Changes to Create Video"
method: POST
path: "/v3/videos"
---

# Changes to Create Video

`POST /v3/videos`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `7dfa5e59b4f5`: 3 breaking, 50 info

## Changes

- **2026-11-03** `7dfa5e59b4f5`: 3 breaking, 50 info
  - removed the enum value `4:5` of the request property `oneOf[subschema #3: CreateVideoFromCinematicAvatar]/aspect_ratio`
  - removed the enum value `5:4` of the request property `oneOf[subschema #3: CreateVideoFromCinematicAvatar]/aspect_ratio`
  - removed the enum value `auto` of the request property `oneOf[subschema #3: CreateVideoFromCinematicAvatar]/aspect_ratio`
  - added the new optional request property `oneOf[subschema #1: CreateVideoFromAvatar]/brand_glossary_id`
  - added the new optional request property `oneOf[subschema #1: CreateVideoFromAvatar]/engine/anyOf[subschema #1]/oneOf[subschema #1: AvatarVEngineConfig]/more_blinking`
  - added the new optional request property `oneOf[subschema #1: CreateVideoFromAvatar]/folder_id`
  - added the new optional request property `oneOf[subschema #2: CreateVideoFromImage]/brand_glossary_id`
  - added the new optional request property `oneOf[subschema #2: CreateVideoFromImage]/folder_id`
  - added the new optional request property `oneOf[subschema #3: CreateVideoFromCinematicAvatar]/folder_id`
  - added the new optional request property `oneOf[subschema #3: CreateVideoFromCinematicAvatar]/model`
  - added the new optional request property `oneOf[subschema #4: CreateVideoFromStudio]/brand_glossary_id`
  - added the new optional request property `oneOf[subschema #4: CreateVideoFromStudio]/folder_id`
  - added the new optional request property `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #1: AvatarVideoScene]/input/engine/anyOf[subschema #1]/oneOf[subschema #1: AvatarVEngineConfig]/more_blinking`
  - added the new optional request property `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #1: AvatarVideoScene]/input/remove_background`
  - added the new optional request property `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #3: VideoScene]/playback/anyOf[subschema #1: PlaybackInput]/mode`
  - added `avatar, cinematic_avatar, image, studio` mapping keys to the request discriminator
  - added `asset_id, base64, url` discriminator mapping keys to the `oneOf[subschema #1: CreateVideoFromAvatar]/watermark/anyOf[subschema #1: WatermarkInput]/image` request property
  - added `asset_id, base64, url` discriminator mapping keys to the `oneOf[subschema #2: CreateVideoFromImage]/image` request property
  - added `asset_id, base64, url` discriminator mapping keys to the `oneOf[subschema #2: CreateVideoFromImage]/watermark/anyOf[subschema #1: WatermarkInput]/image` request property
  - added `asset_id, base64, url` discriminator mapping keys to the `oneOf[subschema #3: CreateVideoFromCinematicAvatar]/references/anyOf[subschema #1]/items/` request property
  - added `asset_id, base64, url` discriminator mapping keys to the `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #2: ImageScene]/source` request property
  - added `asset_id, base64, url` discriminator mapping keys to the `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #3: VideoScene]/source` request property
  - added `asset_id, base64, url` discriminator mapping keys to the `oneOf[subschema #4: CreateVideoFromStudio]/watermark/anyOf[subschema #1: WatermarkInput]/image` request property
  - added `avatar_iii, avatar_iv, avatar_v` discriminator mapping keys to the `oneOf[subschema #1: CreateVideoFromAvatar]/engine/anyOf[subschema #1]/` request property
  - added `avatar_iii, avatar_iv, avatar_v` discriminator mapping keys to the `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #1: AvatarVideoScene]/input/engine/anyOf[subschema #1]/` request property
  - added `avatar_video, image, video` discriminator mapping keys to the `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/` request property
  - added `color, image, video` discriminator mapping keys to the `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #1: AvatarVideoScene]/input/background/anyOf[subschema #1]/` request property
  - added `elevenlabs, fish, starfish` discriminator mapping keys to the `oneOf[subschema #1: CreateVideoFromAvatar]/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/` request property
  - added `elevenlabs, fish, starfish` discriminator mapping keys to the `oneOf[subschema #2: CreateVideoFromImage]/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/` request property
  - added `elevenlabs, fish, starfish` discriminator mapping keys to the `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #1: AvatarVideoScene]/input/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/` request property
  - added `elevenlabs, fish, starfish` discriminator mapping keys to the `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #2: ImageScene]/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/` request property
  - added `elevenlabs, fish, starfish` discriminator mapping keys to the `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #3: VideoScene]/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/` request property
  - added the new `eleven_v4` enum value to the request property `oneOf[subschema #1: CreateVideoFromAvatar]/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/oneOf[subschema #1: ElevenLabsEngineSettings]/model/anyOf[subschema #1: ElevenLabsModel]/`
  - added the new `eleven_v4` enum value to the request property `oneOf[subschema #2: CreateVideoFromImage]/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/oneOf[subschema #1: ElevenLabsEngineSettings]/model/anyOf[subschema #1: ElevenLabsModel]/`
  - added the new `eleven_v4` enum value to the request property `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #1: AvatarVideoScene]/input/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/oneOf[subschema #1: ElevenLabsEngineSettings]/model/anyOf[subschema #1: ElevenLabsModel]/`
  - added the new `eleven_v4` enum value to the request property `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #2: ImageScene]/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/oneOf[subschema #1: ElevenLabsEngineSettings]/model/anyOf[subschema #1: ElevenLabsModel]/`
  - added the new `eleven_v4` enum value to the request property `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #3: VideoScene]/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/oneOf[subschema #1: ElevenLabsEngineSettings]/model/anyOf[subschema #1: ElevenLabsModel]/`
  - added the new `s2.1-pro` enum value to the request property `oneOf[subschema #1: CreateVideoFromAvatar]/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/oneOf[subschema #2: FishEngineSettings]/model/anyOf[subschema #1: FishModel]/`
  - added the new `s2.1-pro` enum value to the request property `oneOf[subschema #2: CreateVideoFromImage]/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/oneOf[subschema #2: FishEngineSettings]/model/anyOf[subschema #1: FishModel]/`
  - added the new `s2.1-pro` enum value to the request property `oneOf[subschema #4: CreateVideoFromStudio]/scenes/items/oneOf[subschema #1: AvatarVideoScene]/input/voice_settings/anyOf[subschema #1: VoiceSettingsInput]/engine_settings/anyOf[subschema #1]/oneOf[subschema #2: FishEngineSettings]/model/anyOf[subschema #1: FishModel]/`
  - …13 more

---

[Operation](https://skmtc.dev/heygen/apis/heygen-external-api/docs/v3/videos/post.md) - [API](https://skmtc.dev/heygen/apis/heygen-external-api.md) - [Page](https://skmtc.dev/heygen/apis/heygen-external-api/changes/v3/videos/post)