Documentation

Getting Started

Copy page

Get up and running with the SLNG API in minutes. This guide covers authentication, your first API call, and next steps.

Prerequisites

• An SLNG API account
• An API key (get one at app.slng.ai)
• Basic knowledge of REST APIs or WebSockets

Authentication

All API requests require authentication using an API key in the Authorization header:

Code
 
Authorization: Bearer YOUR_API_KEY

Replace YOUR_API_KEY with your actual API key from the dashboard.

Your First Request

Let's start by making a simple Text-to-Speech (TTS) request using the HTTP API.

Text-to-Speech (HTTP)

Turn any text into an audio file, like this:

Code
 
curl https://api.slng.ai/v1/tts/slng/deepgram/aura:2 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from sunny Barcelona!",
  }'
  --output hello.wav

Replace the YOUR_API_KEY by the API key you were given and run this command in your terminal.

After a few seconds when the request completes, you should have a hello.wav audio file in the current directory.

It will sound like this:

Speech-to-Text (HTTP)

Now we want to transcribe an audio file. It turns the audio into a text we can manipulate and analyze later. First, you need to download this sample audio file on your machine.

And then run the following code snippet in your terminal:

Code
 
curl https://api.slng.ai/v1/stt/slng/deepgram/nova:3 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: multipart/form-data' \
  -F "[email protected] \
  --form language=en

And after a few seconds you should get the following response:

Code
 
{
  {
    "text": "is the micro machine man presenting the most midget miniature motorcade of micro machine each one has dramatic details terrific trim precision page outs plus incredible micro machine pocket play sets there's a police station fire station restaurant service station and more perfect pocket portables to take any place and there are many miniature play sets to play with it each one comes with its own special edition micro machine vehicle and fun fantastic features that miraculously move raise the bolt to fit the airport marina man the gun turret at the army base clean your car at the car wash raise the toll bridge and these play sets fit together to form a micro machine world micro machine pocket play sets so tremendously tiny so perfectly precise so dazzlingly detailed you wanna pocket them all micro machines and micro machine pocket play sets sold separately from galoob the smaller they are the better they are",
    "transcript": "is the micro machine man presenting the most midget miniature motorcade of micro machine each one has dramatic details terrific trim precision page outs plus incredible micro machine pocket play sets there's a police station fire station restaurant service station and more perfect pocket portables to take any place and there are many miniature play sets to play with it each one comes with its own special edition micro machine vehicle and fun fantastic features that miraculously move raise the bolt to fit the airport marina man the gun turret at the army base clean your car at the car wash raise the toll bridge and these play sets fit together to form a micro machine world micro machine pocket play sets so tremendously tiny so perfectly precise so dazzlingly detailed you wanna pocket them all micro machines and micro machine pocket play sets sold separately from galoob the smaller they are the better they are",
    "confidence": 0.9749991,
    "duration": 29.888374,
    "language": "en",
    "metadata": {
        "request_id": "f5778fa4-40f9-4d60-993b-2f43f0164221",
        "model": "nova-3",
        "duration": 29.888374,
        "channels": 1,
        "alternatives": [
            ...
        ]
    }
},

This works with local files but it also works with remote files by providing a URL instead of uploading the audio data directly. Here is how you would do that:

Code
 
curl https://api.slng.ai/v1/stt/slng/deepgram/nova:3 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"url":"https://docs.slng.ai/audio/micro-machines.wav", "language":"en"}'

Go Further

Now that you've made your first API calls, you can explore more advanced features and examples.