AI Voice Cloner API Reference - Magic Hour Docs

Clone a voice from an audio sample and generate speech.

• Each character costs 0.05 credits.
• The cost is rounded up to the nearest whole number

POST /v1/ai-voice-cloner

Python

Python

from magic_hour import Client
from os import getenv

client = Client(token=getenv("API_TOKEN"))
res = client.v1.ai_voice_cloner.create(
    assets={"audio_file_path": "api-assets/id/1234.mp3"},
    style={"prompt": "Hello, this is my cloned voice."},
    name="My Voice Cloner audio",
)

200

{
  "id": "cuid-example",
  "credits_charged": 1
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <api_key>, where <api_key> is your API key. To get your API key, go to Developer Hub and click "Create new API Key".

Body

application/json

Body

assets · object · required

Provide the assets for voice cloning.

Show child attributes

style · object · required

Show child attributes

name · string · default: Voice Cloner - dateTime

Give your audio a custom name for easy identification.

Example:

"My Voice Cloner audio"

Response

200

application/json

Success

Success

id · string · required

Unique ID of the audio. Use it with the Get audio Project API to fetch status and downloads.

Example:

"cuid-example"

credits_charged · integer · required

The amount of credits deducted from your account to generate the audio. We charge credits right when the request is made.

If an error occurred while generating the audio, credits will be refunded and this field will be updated to include the refund.

Example:

1