---
title: "Generate Voiceover Audio"
method: POST
path: "/api/projects/{project_id}/scenes/{scene_id}/audio-clips/generate-voiceover"
---

# Generate Voiceover Audio

`POST /api/projects/{project_id}/scenes/{scene_id}/audio-clips/generate-voiceover`

## Request

- Base URL: `https://api.latted.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.latted.com/api/projects/{project_id}/scenes/{scene_id}/audio-clips/generate-voiceover`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Generate a voiceover audio clip using Hume AI text-to-speech.

This endpoint:
1. Validates the project, scene, and voice
2. Calls Hume TTS API to generate audio
3. Uploads audio to CDN
4. Creates AudioClip record in database
5. Returns the created audio clip

## Path parameters

- `project_id` string, required
- `scene_id` string, required

## Request body

- GenerateVoiceoverRequest: Request schema for generating a voiceover audio clip
  - `script` string, required: The text to be spoken
  - `voiceId` string, required: ID of the custom voice to use
  - `startTimestamp` integer, required: Start time in milliseconds
  - `speed` number, nullable: Speech speed multiplier (0.5-2.0)

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/latted/apis/motion-graphics-designer-api.md) · [All operations](https://skmtc.dev/latted/apis/motion-graphics-designer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/latted/apis/motion-graphics-designer-api/revisions/cf96730699f5?raw)