Account

Οι περιγραφές των endpoints και των πεδίων εμφανίζονται στα αγγλικά, όπως ακριβώς τις δημοσιεύει το API. Είναι επιλογή μας, ώστε να διαβάζετε εδώ ό,τι θα δείτε και στις αποκρίσεις.

POST /v1/sessions/local#

Mint a local session. Mints a short-lived session token + broker WebSocket URLs for driving an agent locally (used by the SDK's local mode).

Σώμα αιτήματος

application/json Σχήμα: SessionLocalRequest

Αποκρίσεις

Παράδειγμα αιτήματος

curl -X POST "https://api.voiceland.ai/v1/sessions/local" \
  -H "Authorization: Bearer VL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "agent": "front-desk"
}'

Η επιτυχής απόκριση επιστρέφει ένα SessionLocalResponse.

Παράδειγμα απόκρισης

{
  "api_version": "2026-04-26",
  "token": "…"
}

GET /v1/tenant#

Get your tenant profile. Your tenant slug, default API version, inbound SIP trunk, and (when configured) the outbound trunk state.

Αποκρίσεις

Παράδειγμα αιτήματος

curl "https://api.voiceland.ai/v1/tenant" \
  -H "Authorization: Bearer VL_API_KEY"

Η επιτυχής απόκριση επιστρέφει ένα Response.

Παράδειγμα απόκρισης

{
  "default_api_version": "2026-04-26",
  "slug": "acme"
}

GET /v1/voices#

List voices. The catalog of available voices you can set on an agent (use voice_id in voice.voice_id). Each voice carries its languages, gender (male, female or neutral), age band and a short description. The list is ordered the way the console shows it: Greek voices first, male and then female, followed by every other voice by language. The order is presentation only: an agent created without a voice gets its language's default voice, whatever its position.

Αποκρίσεις

Παράδειγμα αιτήματος

curl "https://api.voiceland.ai/v1/voices" \
  -H "Authorization: Bearer VL_API_KEY"

Παράδειγμα απόκρισης

{
  "items": [
    {
      "age_band": "middle",
      "description": "Native Greek male, narrational, assertive and warm, broadcast grade. Default for Greek agents.",
      "display_name": "Theos",
      "gender": "male",
      "languages": [
        "el"
      ],
      "model": "eleven_turbo_v2_5",
      "provider": "elevenlabs",
      "voice_id": "n0vzWypeCK1NlWPVwhOc"
    },
    {
      "age_band": "young",
      "description": "Young native Greek female, soft, calm and narrational.",
      "display_name": "Eleni",
      "gender": "female",
      "languages": [
        "el"
      ],
      "model": "eleven_turbo_v2_5",
      "provider": "elevenlabs",
      "voice_id": "aTP4J5SJLQl74WTSRXKW"
    },
    {
      "age_band": "middle",
      "description": "Bright, firm American tenor that cuts through. Good first pick for English assistants.",
      "display_name": "Adam",
      "gender": "male",
      "languages": [
        "en"
      ],
      "model": "eleven_multilingual_v2",
      "provider": "elevenlabs",
      "voice_id": "pNInz6obpgDQGcFmaJgB"
    }
  ]
}

Σχήματα#

Error#

Error envelope returned for non-2xx responses.

OutboundView#

Response#

SessionLocalRequest#

SessionLocalResponse#