Using ElevenLabs Voices

This guide shows you how to use any voice from the ElevenLabs catalog in your Pictory videos. Simply pass the ElevenLabs voice ID as the speaker value; Pictory will automatically discover and add the voice to your library.

How It Works

Find a voice on ElevenLabs

Browse the ElevenLabs Voice Library and copy the voice ID of any voice you want to use.

Pass the voice ID as speaker

Use the ElevenLabs voice ID directly in your API request as the speaker value.

Automatic discovery

If the voice is not already in your Pictory library, it will be automatically discovered and added from ElevenLabs. No manual setup required.

Finding an ElevenLabs Voice ID

You can find voice IDs from:

ElevenLabs Voice Library: Browse voices at elevenlabs.io/voice-library. The voice ID is shown on each voice’s detail page.
ElevenLabs API: Use the ElevenLabs Voices API to list available voices programmatically.
Pictory Voiceover Tracks API: Use the Get Voiceover Tracks endpoint to list voices already in your library, including ElevenLabs voices with their voice field containing the ElevenLabs voice ID.

Basic Example

import axios from "axios";

const API_BASE_URL = "https://api.pictory.ai/pictoryapis";
const API_KEY = "YOUR_API_KEY";

async function createVideoWithElevenLabsVoice() {
  const response = await axios.post(
    `${API_BASE_URL}/v2/video/storyboard/render`,
    {
      videoName: "elevenlabs_voice_demo",
      voiceOver: {
        enabled: true,
        aiVoices: [
          {
            speaker: "pNInz6obpgDQGcFmaJgB",  // ElevenLabs voice ID for "Adam"
            speed: 100,
            amplificationLevel: 0,
          },
        ],
      },
      scenes: [
        {
          story: "Welcome to our product demo. Today we'll show you how easy it is to create professional videos with ultra-realistic AI narration.",
          createSceneOnEndOfSentence: true,
        },
      ],
    },
    {
      headers: {
        "Content-Type": "application/json",
        Authorization: API_KEY,
      },
    }
  );

  console.log("Job ID:", response.data.data.jobId);
}

createVideoWithElevenLabsVoice();

import requests

API_BASE_URL = "https://api.pictory.ai/pictoryapis"
API_KEY = "YOUR_API_KEY"

def create_video_with_elevenlabs_voice():
    response = requests.post(
        f"{API_BASE_URL}/v2/video/storyboard/render",
        json={
            "videoName": "elevenlabs_voice_demo",
            "voiceOver": {
                "enabled": True,
                "aiVoices": [
                    {
                        "speaker": "pNInz6obpgDQGcFmaJgB",  # ElevenLabs voice ID for "Adam"
                        "speed": 100,
                        "amplificationLevel": 0,
                    }
                ],
            },
            "scenes": [
                {
                    "story": "Welcome to our product demo. Today we'll show you how easy it is to create professional videos with ultra-realistic AI narration.",
                    "createSceneOnEndOfSentence": True,
                }
            ],
        },
        headers={
            "Content-Type": "application/json",
            "Authorization": API_KEY,
        },
    )
    response.raise_for_status()
    print(f"Job ID: {response.json()['data']['jobId']}")

create_video_with_elevenlabs_voice()

Ways to Reference a Voice

The speaker field accepts multiple formats:

Format	Example	Description
Voice name	`"Brian"`	Matches by voice name in your library
Track ID	`"1776425060651"`	Numeric track ID from your library
ElevenLabs voice ID	`"pNInz6obpgDQGcFmaJgB"`	ElevenLabs UUID, auto-discovered if not in library

Resolution Order

When you pass a speaker value, Pictory resolves it in this order:

Track ID: If numeric, searches by track ID
Voice name: Searches by voice name (case-insensitive)
Voice ID: Searches by the voice provider’s ID (e.g., ElevenLabs UUID)
Auto-discovery: If not found, attempts to discover and add the voice from ElevenLabs

Using Previously Discovered Voices

Once a voice is discovered and added to your library, you can reference it by name or track ID in future requests, just like any other voice. Use the Get Voiceover Tracks endpoint to see all voices in your library:

curl --request GET \
  --url https://api.pictory.ai/pictoryapis/v1/voiceovers/tracks \
  --header 'Authorization: YOUR_API_KEY'

ElevenLabs voices in the response will have "service": "elevenlabs" and the original voice ID in the voice field.

Premium Voice Settings

For ElevenLabs voices, you can fine-tune the voice output using premiumVoiceSettings:

{
  voiceOver: {
    enabled: true,
    aiVoices: [{
      speaker: "pNInz6obpgDQGcFmaJgB",
      speed: 100,
      amplificationLevel: 0,
      premiumVoiceSettings: {
        modelId: "eleven_multilingual_v2",  // ElevenLabs model
        stability: 50,                      // 0-100, higher = more consistent
        similarityBoost: 75,                // 0-100, higher = closer to original
        style: 0,                           // 0-100, higher = more expressive
        useSpeakerBoost: true               // Enhance voice clarity
      }
    }]
  }
}

Premium Voice Settings Reference

Parameter	Type	Range	Description
`modelId`	string	-	ElevenLabs model ID (e.g., `eleven_multilingual_v2`, `eleven_v3`)
`stability`	number	0-100	Voice consistency. Lower values produce more variation.
`similarityBoost`	number	0-100	How closely the output matches the original voice.
`style`	number	0-100	Expressiveness. Higher values add more emotion.
`useSpeakerBoost`	boolean	-	Enhances voice clarity and presence.

premiumVoiceSettings only work with ElevenLabs voices. Using them with AWS or Google voices will return a validation error.

Troubleshooting

Voice Not Found Error

Cause: The ElevenLabs voice ID is invalid or the voice does not exist.Resolution:

Verify the ElevenLabs voice ID is correct
Check that the voice exists in the ElevenLabs Voice Library
Ensure your Pictory subscription includes ElevenLabs voice access

Voice Sounds Different Than Expected

Cause: Default voice settings may not match the ElevenLabs preview.Resolution:

Adjust premiumVoiceSettings: increase similarityBoost for closer matching
Try a different modelId: eleven_multilingual_v2 and eleven_v3 produce different results
Adjust stability: lower values produce more natural variation

Next Steps

Get Voiceover Tracks

List all voices in your library

AI Voiceover Guide

Complete guide to AI voiceover in videos

Multi-Level Voice-Over

Use different voices for different scenes

Pronunciation Guide

Control how words are pronounced

Getting started

Text to Video

Video with Avatar

Article to Video

Presentation to Video

Audio to Video

Video to Shorts

AI-Generated Visuals

Video Story CoPilot

Smart Layouts

Captions

Branding & Customization

Template to Video

AI Studio

Background Music

Video Storyboard

Voice-Over

Advanced Features

End-to-End Recipes

Using ElevenLabs Voices

How It Works

Finding an ElevenLabs Voice ID

Basic Example

Ways to Reference a Voice

Resolution Order

Using Previously Discovered Voices

Premium Voice Settings

Premium Voice Settings Reference

Troubleshooting

Next Steps

Get Voiceover Tracks

AI Voiceover Guide

Multi-Level Voice-Over

Pronunciation Guide

​How It Works

​Finding an ElevenLabs Voice ID

​Basic Example

​Ways to Reference a Voice

​Resolution Order

​Using Previously Discovered Voices

​Premium Voice Settings

​Premium Voice Settings Reference

​Troubleshooting

​Next Steps

Get Voiceover Tracks

AI Voiceover Guide

Multi-Level Voice-Over

Pronunciation Guide

How It Works

Finding an ElevenLabs Voice ID

Basic Example

Ways to Reference a Voice

Resolution Order

Using Previously Discovered Voices

Premium Voice Settings

Premium Voice Settings Reference

Troubleshooting

Next Steps