Voice Cloning Workflow - Zyphra Zonos API

Who is this for?

This workflow is designed for developers, content creators, and businesses looking to automate high-quality voice synthesis using AI voice cloning technology.

What problem does this solve?

It automates the process of generating natural-sounding speech from text using a sample voice file, eliminating the need for manual voice recording and providing consistent voice output for applications like audiobooks, virtual assistants, or content localization.

What this workflow does

The workflow receives text and voice cloning parameters via webhook, reads a sample voice file from your storage, sends the data to Zyphra's Zonos API for voice synthesis, and saves the generated audio file to your specified output location.

Prerequisites

You'll need:

• API key from Zyphra (obtain from https://playground.zyphra.com/settings/api-keys)
• Account registration at https://playground.zyphra.com
• Sample voice file stored on accessible disk/cloud storage
• n8n instance running with webhook capabilities

Setup

1. Configure your Zyphra API key in the "Call Zyphra Clone API" node under Header Parameters (Name: X-API-Key, Value: your-api-key)
2. Ensure your sample voice files are accessible at the paths you'll specify
3. Test the webhook endpoint is accessible

Supported Audio Formats

The API supports multiple output formats through the mime_type parameter:

• WebM (default) - audio/webm
• Ogg - audio/ogg
• WAV - audio/wav
• MP3 - audio/mp3 or audio/mpeg
• MP4/AAC - audio/mp4 or audio/aac

Usage Example

Endpoint: POST http://localhost:5678/webhook-test/voice-clone

Headers: Content-Type: application/json

Request Body:
{
"text": "Hello there! This voice sounds just like the sample!",
"speaking_rate": 18,
"sample_voice_path": "/data/output/sampleVoice.wav",
"output_path": "/data/output/",
"language_iso_code": "en-us",
"mime_type": "audio/wav",
"model": "zonos-v0.1-transformer",
"emotion": {
"happiness": 0.8,
"neutral": 0.3,
"sadness": 0.05,
"disgust": 0.05,
"fear": 0.05,
"surprise": 0.05,
"anger": 0.05,
"other": 0.5
}
}

Parameters

Required Parameters

• text : Text to synthesize into speech
• sample_voice_path : Path to your voice sample file
• output_path : Directory where generated audio will be saved

Optional Parameters (with defaults)

• speaking_rate : 15 - Speech speed
• language_iso_code : "en-us" - Language code
• mime_type : "audio/wav" - Output audio format
• model : "zonos-v0.1-transformer" - AI model to use
• emotion : Object with emotion levels (0-1 scale)