Quick Start

You can browse example projects using the Resemble API and SDKs at resemble/resemble-examples on GitHub. For an example of using the streaming API please see resemble-ai/resemble-streaming-demo.

Getting started with Resemble API

This guide will get you familiar with the basics of using Resemble's APIs as quickly as possible. We will be using Python for this guide.

1. If not already done, sign up for a Resemble account.
2. Find your API key here.
3. Scaffold a new python project and install the Resemble library:

pip install resemble

4. Now you are ready to authenticate and interact with the Resemble platform using the API key you generated in step 2:

from resemble import Resemble
Resemble.api_key('YOUR_API_KEY')

# Get your default Resemble project.
project_uuid = Resemble.v2.projects.all(1, 10)['items'][0]['uuid']

# Get your Voice uuid. In this example, we'll obtain the first.
voice_uuid = Resemble.v2.voices.all(1, 10)['items'][0]['uuid']

# Let's create a clip!
body = 'This is a test'
response = Resemble.v2.clips.create_sync(project_uuid,
                                         voice_uuid,
                                         body,
                                         title=None,
                                         sample_rate=None,
                                         output_format=None,
                                         precision=None,
                                         include_timestamps=None,
                                         is_public=None,
                                         is_archived=None,
                                         raw=None)

print(clip['audio_src'])

You have now taken your first steps into the expansive capabilities of the Resemble API. This guide aimed to provide you with a swift and straightforward initiation to kickstart your journey. To dive deeper and unlock the full potential of our API, continue reading further documentation.

If you encounter any problems, please to reach out to us at team@resemble.ai.