Registru de provideri

6 endpoint-uri. Fiecare cale de mai jos este relativă la URL-ul de bază al API-ului și include deja prefixul /api/v1 — vezi convențiile pentru autentificare, paginare, erori și idempotență.

	Endpoint
GET	`/registry`	The whole registry in one call: providers, models, voices, telephony
GET	`/registry/model-providers`	LLM providers that CallAgent can actually talk to today
GET	`/registry/models`	List LLM models with capability, context window and pricing metadata, filterable by provider
GET	`/registry/telephony`	Telephony providers and what each one can do (§8)
GET	`/registry/transcribers`	Transcriber providers and their models (§27)
GET	`/registry/voices`	The voice catalogue plus this organization's cloned voices (§28)

Endpoint-uri

The whole registry in one call: providers, models, voices, telephony

GET/registry

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/registry" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/registry`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/registry');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/registry",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped object

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "model_providers": [
      {}
    ],
    "transcriber_providers": [
      {}
    ],
    "voice_providers": [
      {}
    ],
    "telephony_providers": [
      {}
    ]
  }
}

LLM providers that CallAgent can actually talk to today

GET/registry/model-providers

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/registry/model-providers" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/registry/model-providers`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/registry/model-providers');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/registry/model-providers",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped array

Exemplu de răspuns, generat din schemă:

json

{
  "data": [
    {
      "slug": "string",
      "name": "Support Line",
      "api_style": "string",
      "default_base_url": "https://example.com/hook",
      "supports_byo_key": true,
      "supports_custom_base_url": true,
      "credential_fields": []
    }
  ]
}

List LLM models with capability, context window and pricing metadata, filterable by provider

GET/registry/models

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.
Query filters are provider and voice_only. pricing_verified:false means the price is unconfirmed and must be shown as an estimate.

Parametri de interogare

Nume	Tip	Obligatoriu	Note
`voice_only`	boolean	—	default `false`

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/registry/models?voice_only=false" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/registry/models?voice_only=false`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/registry/models?voice_only=false');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/registry/models?voice_only=false",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped array

Exemplu de răspuns, generat din schemă:

json

{
  "data": [
    {
      "provider": "string",
      "slug": "string",
      "name": "Support Line",
      "family": "string",
      "capabilities": [],
      "context_window": 1,
      "max_output": 1,
      "input_price_per_million": "string",
      "output_price_per_million": "string",
      "currency": "string",
      "pricing_verified": true,
      "recommended_for_voice": true,
      "deprecated": true
    }
  ]
}

Telephony providers and what each one can do (§8)

GET/registry/telephony

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/registry/telephony" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/registry/telephony`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/registry/telephony');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/registry/telephony",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped array

Exemplu de răspuns, generat din schemă:

json

{
  "data": [
    {
      "slug": "string",
      "name": "Support Line",
      "supports_inbound": true,
      "supports_outbound": true,
      "supports_number_purchase": true,
      "supports_sms": true,
      "supports_sip_trunk": true,
      "supports_media_streams": true,
      "credential_fields": []
    }
  ]
}

Transcriber providers and their models (§27)

GET/registry/transcribers

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.
data is an object with providers and models, not a flat list. The provider filter narrows only models. pricing_verified:false marks an unconfirmed price.

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/registry/transcribers" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/registry/transcribers`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/registry/transcribers');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/registry/transcribers",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped object

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "providers": [
      {}
    ],
    "models": [
      {}
    ]
  }
}

The voice catalogue plus this organization's cloned voices (§28)

GET/registry/voices

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.
Filterable with provider. Cloned voices belonging to this organization are mixed into the same list, flagged by is_cloned.

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/registry/voices" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/registry/voices`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/registry/voices');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/registry/voices",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped array

Exemplu de răspuns, generat din schemă:

json

{
  "data": [
    {
      "provider": "string",
      "voice_id": "01JQ0000000000000000000000",
      "name": "Support Line",
      "model": "string",
      "gender": "string",
      "accent": "string",
      "languages": {},
      "preview_url": "https://example.com/hook",
      "is_cloned": true
    }
  ]
}

Registru de provideri ​

Endpoint-uri ​

The whole registry in one call: providers, models, voices, telephony ​

LLM providers that CallAgent can actually talk to today ​

List LLM models with capability, context window and pricing metadata, filterable by provider ​

Telephony providers and what each one can do (§8) ​

Transcriber providers and their models (§27) ​

The voice catalogue plus this organization's cloned voices (§28) ​

Registru de provideri

Endpoint-uri

The whole registry in one call: providers, models, voices, telephony

LLM providers that CallAgent can actually talk to today

List LLM models with capability, context window and pricing metadata, filterable by provider

Telephony providers and what each one can do (§8)

Transcriber providers and their models (§27)

The voice catalogue plus this organization's cloned voices (§28)