API Reference

Making your first requests

Once you have acquired your keys, you can begin making requests. For each request you make, you have to include your Client ID in the X-Client-ID header, and the API Key in the X-API-Key header respectively:

curl -i -X POST \
   -H "X-Client-Key:xxxxxxxxxx-xxxxxxxxxx-xxxxxxxxxx" \
   -H "X-Api-Key:yyyyyyyyyy-yyyyyyyyyy-yyyyyyyyyy" \
 'https://api.gemelo.ai/v1/endpoint'

Before you request TTS or VC, you have to query the available voices first, and include the chosen voice's ID in the subsequent request.

TTS Example

Querying TTS voices

curl -i -X GET \
   -H "X-Client-Key:xxxxxxxxxx-xxxxxxxxxx-xxxxxxxxxx" \
   -H "X-Api-Key:yyyyyyyyyy-yyyyyyyyyy-yyyyyyyyyy" \
 'https://api.gemelo.ai/v1/tts/voices'

Available voices response (example)

[
  {
    "id": 24,
    "name": "John Doe",
    "description": "Hoarse voice of an elderly man."
  },
  {
    "id": 35,
    "name": "Jane Doe",
    "description": "Warm and friendly female voice."
  }
]

Actual TTS request

curl -X POST \
   -H "X-Client-Key:xxxxxxxxxx-xxxxxxxxxx-xxxxxxxxxx" \
   -H "X-Api-Key:yyyyyyyyyy-yyyyyyyyyy-yyyyyyyyyy" \
   -d '{"voiceId": 35, "text": "Hello world!"}' \
   -o output.wav \
 'https://api.gemelo.ai/v1/tts/convert'

Running this will save the response as output.wav file in the active location.

VC Example

Querying TTS voices

curl -i -X GET \
   -H "X-Client-Key:xxxxxxxxxx-xxxxxxxxxx-xxxxxxxxxx" \
   -H "X-Api-Key:yyyyyyyyyy-yyyyyyyyyy-yyyyyyyyyy" \
 'https://api.gemelo.ai/v1/vc/voices'

Available voices response (example)

[
  {
    "id": 24,
    "name": "John Doe",
    "description": "Hoarse voice of an elderly man."
  },
  {
    "id": 35,
    "name": "Jane Doe",
    "description": "Warm and friendly female voice."
  }
]

Actual VC request

Make sure that the following params are correctly filled:

  • Client Key
  • API Key
  • Input file location (audio.wav in the example)
  • voiceID (in the URL query params)
curl -X POST \
     -H "Content-Type: multipart/form-data" \
     -H "X-Client-Key: xxx" \
     -H "X-Api-Key: yyy" \
     -F "[email protected]" \
     -o output.wav \
     "https://api.gemelo.ai/v1/vc/convert?voiceId=133"

Running this will save the response as output.wav file in the active location.