Integrations

Getting Started

You can enable and manage all available integrations from the integrations page. Once enabled, you can:

Test integrations directly in the Studio
Preview available options (like voices for text-to-speech)
Generate ready-to-use code snippets via the View code button
Implement them in your API calls

API Key Options:

Use Sync’s internal integration (Usage costs will be reflected in your usage billing)
Use your own API keys (Available on Creator plan or higher)

Available Integrations

ElevenLabs

ElevenLabs provides state-of-the-art Text-to-Speech and AI Voice Generation capabilities. This integration extends Sync’s generation endpoint with powerful text-to-speech functionality.

Using ElevenLabs in the Studio

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

Using ElevenLabs via API

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
9       }
10     }
11   ],
12   // Other generation parameters...
13 }

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       }
16     },
17     {
18       "type": "video",
19       "url": "https://assets.sync.so/docs/example-video.mp4"
20     }
21   ]
22 }
23 
24 headers = {
25   "x-api-key": api_key,
26   "Content-Type": "application/json"
27 }
28 
29 response = requests.post(api_url, json=payload, headers=headers)
30 print(response.json())

Troubleshooting ElevenLabs Integration

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

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:

Log in to your ElevenLabs account
Navigate to your API key settings
Ensure the “User” permission is enabled for your API key
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:

Verify that you’ve copied the API key correctly from your ElevenLabs account
Check that the API key hasn’t been revoked or expired
Ensure you’re using the correct API key format (ElevenLabs API keys typically start with sk__)
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