---
title: "Initialize character generation"
method: POST
path: "/v1/characters"
tags: ["Characters"]
---

# Initialize character generation

`POST /v1/characters`

## Headers

- `content-length` integer

## Request body

- ApiGenerateTalkingAvatarRequestBody
  - `text` string — text to convert to audio. Ignored if audio_source is not tts
  - `voiceId` string, nullable — Voice ID
  - `voiceUrl` string, nullable — URL of audio uploaded using the /v1/audio endpoint
  - `avatarImage` string, nullable — URL of image uploaded via /v1/portrait
  - `aspectRatio` '1:1' | '16:9' | '9:16' — URL of audio uploaded using the /v1/audio endpoint
  - `audioSource` 'tts' | 'audio' — `tts` for text to speech or `audio`
  - `avatarImageInput` AvatarImageInput
    - `seed` integer
    - `prompt` string, required

## Response `200`

Successful Response

- ApiProjectInitializationResponseBody
  - `jobId` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/hedra-labs/apis/hedra-api.md) · [All operations](https://skmtc.dev/hedra-labs/apis/hedra-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hedra-labs/hedra-api/revisions/ec0a74ecb65d/schema)