---
title: "POST /createAvatar"
method: POST
path: "/createAvatar"
---

# POST /createAvatar

`POST /createAvatar`

Create an avatar

## Request body

- CreateAvatarRequestBody
  - `ttsName` string, required — TTS name, select the public TTS voice. See at Settings -> Avatar creator -> Select voice
  - `conversationId` string, required — The conversation ID. Value is required when using public AI avatar Get Conversation ID
  - `coverImage` string — A value is needed if you are using images to customize your AI avatar. Base64 format. e.g. `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgA`
  - `defaultSpeakingLanguage` string — Default speaking language. default English
  - `greetings` string — Enter a greeting for your AI avatar’s first words, If not, the system will generate it randomly
  - `name` string — Enter a name for your AI avatar. If not, the system will generate it randomly
  - `profile` string — Enter a description of personality and preferences you’d love your AI avatar to have.. If not, the system will generate it randomly

## Response `200`

plant response

- CreateAvatarResponses
  - `code` string — Response code.
  - `msg` string — Response message.
  - `success` boolean — Indicates whether the request succeeded.
  - `data` object — Response payload containing avatar details.
    - `taskId` string — The task ID of create AI avatar.

---

[API](https://skmtc.dev/duix/apis/duix-openapi-v2.md) · [All operations](https://skmtc.dev/duix/apis/duix-openapi-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/duix/duix-openapi-v2/revisions/4ac8f73b87fe/schema)