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 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: “Script contains only formatting directives or empty text.”

Solution:

1. Ensure the script field contains actual text content, not just whitespace or formatting characters
2. Remove any HTML tags, markdown formatting, or special characters that don’t include readable text
3. The script must contain at least one word of spoken content for voice generation

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
• If using your own API key, ensure your ElevenLabs plan supports the features you’re trying to use