Laya Model. Aus Kontext werden Entscheidungen.

1. Schlüssel erstellen und verbinden

Melde dich an und erstelle in den Kontoeinstellungen unter API Keys einen Schlüssel. Halte ausreichend Credits bereit und sende eine POST-Anfrage an die folgende URL. Der API-Pfad hat auch auf übersetzten Seiten kein Sprachpräfix.

Rufe die API von deinem Anwendungsserver auf. Speichere den Schlüssel in der Server-Umgebungsvariable LAYA_API_KEY, niemals in Browsercode oder einem öffentlichen Repository. Die Spielwiese nutzt stattdessen deine angemeldete Sitzung.

2. Modell wählen und Anfrage definieren

Setze model auf english, multilingual oder typed-decisions. Alle drei Optionen unterstützen choice, score und noul.

3. Erste Anfrage senden

Setze LAYA_API_KEY auf deinen Schlüssel. Dieses Beispiel prüft eine Nachricht mit allen drei Fragetypen. JavaScript läuft unter Node.js 18+ als .mjs-Datei; Python 3 nutzt das integrierte urllib ohne zusätzliche Pakete.

export LAYA_API_KEY="YOUR_API_KEY"

curl --fail-with-body --request POST 'https://thejevai.com/laya/v1/systemone' \
  --header "Authorization: Bearer $LAYA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "english",
  "state": "I was charged twice for my subscription. Please refund the extra payment today.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this request?",
      "criteria": {
        "billing": "Payments and refunds",
        "technical": "Bugs and outages"
      }
    },
    "priority": {
      "type": "score",
      "instructions": "How urgent is this request?",
      "criteria": [
        "Low",
        "Medium",
        "High"
      ]
    },
    "refund": {
      "type": "noul",
      "instructions": "Is the customer requesting a refund?",
      "criteria": {
        "true": "A refund is requested",
        "false": "No refund is requested"
      }
    }
  }
}'

4. Antworten, Nutzung und Credits lesen

Prüfe den HTTP-Status und code === 0, bevor du Ergebnisse verwendest. Antworten befinden sich in data.result; es handelt sich nicht um Chat-Vervollständigung oder einen Textstream.

Beispielantwort: Entscheidungen, Token-Zahlen und Dauer variieren.

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "model": "english",
      "answers": {
        "department": {
          "type": "choice",
          "choice": "billing",
          "probabilities": {
            "billing": 0.97,
            "technical": 0.03
          }
        },
        "priority": {
          "type": "score",
          "score": 1.8,
          "legend": {
            "0": "Low",
            "1": "Medium",
            "2": "High"
          }
        },
        "refund": {
          "type": "noul",
          "noul": 0.98
        }
      },
      "usage": {
        "input_tokens": 1200,
        "output_tokens": 0
      },
      "elapsedMs": 142
    },
    "creditsUsed": 2
  }
}

data.result.answers

Suche Ergebnisse anhand deiner Frage-IDs. Lies je nach Typ choice, score oder noul; weitere Wahrscheinlichkeitsfelder können enthalten sein.

data.result.usage

input_tokens und output_tokens zeigen die gemessene Token-Nutzung. Die verbrauchten Credits stehen in data.creditsUsed.

data.result.elapsedMs

Bearbeitungsdauer in Millisekunden. Ein gemessener Wert, keine Latenzgarantie.

data.creditsUsed

Für diese Anfrage abgezogene Credits. Zeige damit die tatsächlichen Kosten in deiner Anwendung an.

Verwende für diesen Endpunkt die hier beschriebenen Anfrage- und Antwortformate. Beim Wechsel zu einem anderen Laya-Dienst prüfe dessen Authentifizierung und Antwortstruktur und passe deinen Client bei Bedarf an.

5. Limits und Fehler berücksichtigen

400

Ungültiges JSON, Modell, Kontext, Fragetyp oder Kriterien. Anfrage vor dem nächsten Versuch korrigieren.

401

Authentifizierung fehlt oder ist ungültig. Bearer-Schlüssel prüfen oder anmelden.

402

Nicht genügend Credits. Guthaben auffüllen und erneut versuchen.

413

Anfrage größer als 32 KiB. Kontext kürzen oder Anfrage teilen.

429

Anfragen folgen zu schnell. Warte entsprechend dem Retry-After-Header.

502

Inferenz fehlgeschlagen, Zeitlimit überschritten oder ungültiges Ergebnis. Meldung prüfen und gegebenenfalls erneut versuchen.

503

Der Dienst ist nicht verfügbar. Versuche es später oder kontaktiere den Support.

Lies bei Fehlern HTTP-Status und message. Der Endpunkt unterstützt keinen Idempotenzschlüssel: Wiederholungen nach einem Client-Timeout können erneut kostenpflichtig sein, falls die erste Anfrage bereits abgeschlossen wurde. Prüfe das Ergebnis vor einem erneuten Aufruf.