Integrations

1. Navigate to Lipsync Studio
2. Enable the ElevenLabs integration
3. Select text as your input type
4. Choose a voice from the available options
5. Generate your content and preview the results instantly

To use ElevenLabs with the API, include the following parameters in your request to the POST /generate endpoint:

1
{
2
  "input": [
3
    {
4
      "type": "text",                // Must be "text" for text-to-speech
5
      "provider": {
6
        "name": "elevenlabs",        // Specify ElevenLabs as the provider
7
        "voiceId": "voice_id",       // Replace with an actual ElevenLabs voice ID
8
        "script": "Your text here",  // The text to convert to speech (max 5,000 characters)
9
        "stability": 0.5,            // Optional: Voice stability (0.0-1.0, default: 0.5)
10
        "similarityBoost": 0.75      // Optional: Voice similarity (0.0-1.0, default: 0.75)
11
      }
12
    }
13
  ],
14
  // Other generation parameters...
15
}

Example API Request

1
import requests
2
3
api_key = "YOUR_API_KEY_HERE"
4
api_url = "https://api.sync.so/v2/generate"
5
6
payload = {
7
  "model": "lipsync-2",
8
  "input": [
9
    {
10
      "type": "text",
11
      "provider": {
12
        "name": "elevenlabs",
13
        "voiceId": "EXAVITQu4vr4xnSDxMaL",
14
        "script": "Welcome to Sync Labs integrations. This audio was generated with ElevenLabs.",
15
        "stability": 0.5,
16
        "similarityBoost": 0.75
17
      }
18
    },
19
    {
20
      "type": "video",
21
      "url": "https://assets.sync.so/docs/example-video.mp4"
22
    }
23
  ]
24
}
25
26
headers = {
27
  "x-api-key": api_key,
28
  "Content-Type": "application/json"
29
}
30
31
response = requests.post(api_url, json=payload, headers=headers)
32
print(response.json())

If you encounter issues when setting up or using the ElevenLabs integration, here are common problems and their solutions:

Empty Text or Formatting Directives Only

Error: “Your text contains only formatting directives (e.g., [smile]) without actual speech content. Please add some text to generate speech.”

Solution:

1. Add actual speech content alongside any formatting directives
2. Ensure your text isn’t just whitespace or formatting tags

Incorrect:

[smile the whole time]

Correct:

Hello, welcome to our video! [smile] We're excited to have you here.

API Key Permission Errors

Error: “Your ElevenLabs API key is missing required permissions. Please ensure the ‘User’ permission is enabled for your API key in your ElevenLabs settings.”

Solution:

1. Log in to your ElevenLabs account
2. Navigate to your API key settings
3. Ensure the “User” permission is enabled for your API key
4. If you need to create a new API key, make sure to enable the required permissions during creation

Invalid API Key Errors

Error: “Invalid API key. Please check your ElevenLabs API key and try again.”

Solution:

1. Verify that you’ve copied the API key correctly from your ElevenLabs account
2. Check that the API key hasn’t been revoked or expired
3. Ensure you’re using the correct API key format (ElevenLabs API keys typically start with sk__)
4. Try generating a new API key from your ElevenLabs dashboard if the issue persists

General Setup Tips

• Make sure your ElevenLabs account is in good standing and has sufficient credits
• Test your API key directly with ElevenLabs’ API before integrating with Sync Labs
• If using your own API key, ensure your ElevenLabs plan supports the features you’re trying to use