---
title: "Create avatar"
method: POST
path: "/video/CreateAvatar"
tags: ["Video"]
---

# Create avatar

`POST /video/CreateAvatar`

Create a new talking head avatar from text or image

## Request body

- object
  - `name` string, required — Name for the avatar
  - `imageUrl` string — Optional URL to an image to use as the base for the avatar
  - `prompt` string — Optional text prompt describing the avatar (used when imageUrl is not provided)
  - `voiceId` integer — Optional numeric voice id from /content/GetVoices to use for the avatar
  - `callbackData` string — Optional data to include in webhooks
  - `scheduledOn` string, date-time — Optional date/time to schedule the request for processing

## Response `200`

Request accepted

- object
  - `requestId` string — Request identifier
  - `status` integer — Initial status code (0 = pending)

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

---

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