Get model

Get model

curl --request GET \
  --url https://{region}.api.slng.ai/v1/catalog/models/{model_code} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://{region}.api.slng.ai/v1/catalog/models/{model_code}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{region}.api.slng.ai/v1/catalog/models/{model_code}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{region}.api.slng.ai/v1/catalog/models/{model_code}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{region}.api.slng.ai/v1/catalog/models/{model_code}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{region}.api.slng.ai/v1/catalog/models/{model_code}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": "deepgram/aura:2",
  "name": "Aura 2",
  "service_type": "tts",
  "provider_code": "deepgram",
  "provider": {
    "code": "<string>",
    "name": "<string>",
    "website": "<string>",
    "logo_url": "<string>"
  },
  "hosted_by": "<string>",
  "short_description": "<string>",
  "long_description": "<string>",
  "best_for": "<string>",
  "use_cases": [
    "<string>"
  ],
  "capabilities": [
    "<string>"
  ],
  "languages": [
    "<string>"
  ],
  "streaming": true,
  "batch": true,
  "accuracy": 123,
  "voice_count": 123,
  "api_path": "<string>",
  "code_example": "<string>",
  "code_examples": {},
  "docs_url": "<string>",
  "tags": [
    "<string>"
  ],
  "family_code": "<string>",
  "family_name": "<string>",
  "available_regions": [
    "au",
    "eu-west",
    "in",
    "us-east"
  ],
  "region_details": [
    {
      "code": "<string>",
      "country": "<string>",
      "world_part_code": "<string>",
      "world_part_label": "<string>",
      "latency_ms": 123,
      "price": 123,
      "discounted_price": 123
    }
  ],
  "region_picker_options": [
    {
      "code": "<string>",
      "label": "<string>",
      "flag": "<string>",
      "min_price": 123,
      "discounted_min_price": 123,
      "latency_ms_avg": 123
    }
  ],
  "served_regions": [
    "eu-north",
    "eu-west",
    "gb"
  ],
  "served_region_details": [
    {
      "code": "<string>",
      "country": "<string>",
      "world_part_code": "<string>",
      "world_part_label": "<string>",
      "latency_ms": 123,
      "price": 123,
      "discounted_price": 123
    }
  ],
  "served_region_picker_options": [
    {
      "code": "<string>",
      "label": "<string>",
      "flag": "<string>",
      "min_price": 123,
      "discounted_min_price": 123,
      "latency_ms_avg": 123
    }
  ],
  "supported_protocols": [
    "https"
  ],
  "voices": [
    {
      "voice_id": "aura-2-amalthea-en",
      "name": "Amalthea",
      "language": "en",
      "gender": "<string>",
      "tone": "<string>",
      "use_case": "<string>",
      "age_range": "<string>",
      "preview_url": "<string>",
      "enabled": true
    }
  ],
  "similar_models": [
    {
      "code": "<string>",
      "name": "<string>",
      "provider_name": "<string>",
      "service_type": "<string>",
      "description": "<string>"
    }
  ],
  "pricing": {},
  "agent_availability": [
    {
      "region": "eu-west",
      "language": "en",
      "voice_ids": [
        "<string>"
      ]
    }
  ]
}

GET

catalog

models

{model_code}

Get model

curl --request GET \
  --url https://{region}.api.slng.ai/v1/catalog/models/{model_code} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://{region}.api.slng.ai/v1/catalog/models/{model_code}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{region}.api.slng.ai/v1/catalog/models/{model_code}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{region}.api.slng.ai/v1/catalog/models/{model_code}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{region}.api.slng.ai/v1/catalog/models/{model_code}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{region}.api.slng.ai/v1/catalog/models/{model_code}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "code": "deepgram/aura:2",
  "name": "Aura 2",
  "service_type": "tts",
  "provider_code": "deepgram",
  "provider": {
    "code": "<string>",
    "name": "<string>",
    "website": "<string>",
    "logo_url": "<string>"
  },
  "hosted_by": "<string>",
  "short_description": "<string>",
  "long_description": "<string>",
  "best_for": "<string>",
  "use_cases": [
    "<string>"
  ],
  "capabilities": [
    "<string>"
  ],
  "languages": [
    "<string>"
  ],
  "streaming": true,
  "batch": true,
  "accuracy": 123,
  "voice_count": 123,
  "api_path": "<string>",
  "code_example": "<string>",
  "code_examples": {},
  "docs_url": "<string>",
  "tags": [
    "<string>"
  ],
  "family_code": "<string>",
  "family_name": "<string>",
  "available_regions": [
    "au",
    "eu-west",
    "in",
    "us-east"
  ],
  "region_details": [
    {
      "code": "<string>",
      "country": "<string>",
      "world_part_code": "<string>",
      "world_part_label": "<string>",
      "latency_ms": 123,
      "price": 123,
      "discounted_price": 123
    }
  ],
  "region_picker_options": [
    {
      "code": "<string>",
      "label": "<string>",
      "flag": "<string>",
      "min_price": 123,
      "discounted_min_price": 123,
      "latency_ms_avg": 123
    }
  ],
  "served_regions": [
    "eu-north",
    "eu-west",
    "gb"
  ],
  "served_region_details": [
    {
      "code": "<string>",
      "country": "<string>",
      "world_part_code": "<string>",
      "world_part_label": "<string>",
      "latency_ms": 123,
      "price": 123,
      "discounted_price": 123
    }
  ],
  "served_region_picker_options": [
    {
      "code": "<string>",
      "label": "<string>",
      "flag": "<string>",
      "min_price": 123,
      "discounted_min_price": 123,
      "latency_ms_avg": 123
    }
  ],
  "supported_protocols": [
    "https"
  ],
  "voices": [
    {
      "voice_id": "aura-2-amalthea-en",
      "name": "Amalthea",
      "language": "en",
      "gender": "<string>",
      "tone": "<string>",
      "use_case": "<string>",
      "age_range": "<string>",
      "preview_url": "<string>",
      "enabled": true
    }
  ],
  "similar_models": [
    {
      "code": "<string>",
      "name": "<string>",
      "provider_name": "<string>",
      "service_type": "<string>",
      "description": "<string>"
    }
  ],
  "pricing": {},
  "agent_availability": [
    {
      "region": "eu-west",
      "language": "en",
      "voice_ids": [
        "<string>"
      ]
    }
  ]
}

For workflow examples, see the Catalog API guide.

Authorizations

Authorization

string

header

required

Optional SLNG API key, sent as Authorization: Bearer $SLNG_API_KEY. Returns your organization's models and pricing. An invalid key returns 401; it never falls back to the public catalog.

Path Parameters

model_code

string

required

Full model code, including slashes and the version suffix.

Example:

"deepgram/aura:2"

Query Parameters

surface

enum<string>

Set to agent to list only the models enabled for agents and to add agent_availability to each model. Omit for the general catalog.

Available options:

agent

agent_region

string

Agent region code, for example eu-west or us-east-slng. Requires surface=agent. This is the agent's region, not a gateway code or a model hosting region. An unknown code returns an empty list. See Agent regions.

Maximum string length: 50

Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Example:

"eu-west"

language

string[]

Language code, for example en. Repeat the parameter for several languages, up to 16. With surface=agent, matches the languages an agent can use the model in.

Maximum array length: 16

Maximum string length: 35

Pattern: ^[a-zA-Z]{2,8}(?:-[a-zA-Z0-9]{1,8})*$

Example:

["en"]

protocol

enum<string>

Return models that support this protocol.

Available options:

https,

wss

Response

The model.

code

string

required

Model code. Use it in API paths, and in an agent's models.stt, models.llm, or models.tts.

Example:

"deepgram/aura:2"

name

string

required

Example:

"Aura 2"

service_type

enum<string>

required

Available options:

stt,

llm,

tts

Example:

"tts"

provider_code

string | null

Example:

"deepgram"

provider

object | null

Show child attributes

hosted_by

string | null

Who hosts the model.

short_description

string | null

long_description

string | null

best_for

string | null

use_cases

string[]

capabilities

string[]

languages

string[]

Supported language codes. With surface=agent, the languages agents can use the model in, within the selected filters.

streaming

boolean

batch

boolean

accuracy

number | null

voice_count

integer | null

Number of voices. With surface=agent, the number of voices available for the selected region and language.

api_path

string | null

code_example

string | null

code_examples

object | null

Show child attributes

docs_url

string | null

Speech to text

Context Router (LLM)

Text to speech

Agents

Unified API

Metadata API

Authorizations

Path Parameters

Query Parameters

Response