Getting Started

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.

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

The script field has a maximum length of 10,000 characters. If you need to process longer text, consider breaking it into smaller segments.

Example API Request

1import requests
2
3api_key = "YOUR_API_KEY_HERE"
4api_url = "https://api.sync.so/v2/generate"
5
6payload = {
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
24headers = {
25  "x-api-key": api_key,
26  "Content-Type": "application/json"
27}
28
29response = requests.post(api_url, json=payload, headers=headers)
30print(response.json())

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:

  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