Erste Schritte

Dieser Leitfaden führt einen Self-Service-Benutzer von der Registrierung bis zur ersten API-Anfrage. Wenn Ihre Organisation von OmevAI angebunden wird, verwenden Sie den Zugang und den Schlüssel, die während des Managed Setups bereitgestellt wurden; die folgenden API-Schritte sind identisch.

1. Ein Self-Service-Konto erstellen

1. Öffnen Sie cabinet.omev.be und wählen Sie Kostenlosen Test starten.
2. Geben Sie Ihre geschäftliche E-Mail-Adresse ein und beschreiben Sie, wie Sie KI einsetzen. Angaben zum Unternehmen und zum erwarteten monatlichen Volumen sind optional.
3. Schließen Sie die Browser-Prüfung ab und senden Sie das Formular ab.
4. Öffnen Sie die E-Mail von OmevAI. Sie enthält einen Anmelde-Link und einen sechsstelligen Code; beide Methoden funktionieren.
5. Nach der Verifizierung erstellt das Cabinet das Konto und zeigt den ersten API-Schlüssel an.

Der Self-Service-Testzeitraum umfasst 5 USD Guthaben für 10 Tage und erfordert keine Zahlungskarte. Die Text-API und die API für natürliche Sprache funktionieren mit jedem Schlüssel; Bilder, Video und die Rechercheprodukte werden für einen Schlüssel auf Anfrage freigeschaltet.

2. Den Schlüssel speichern

Kopieren Sie den vollständigen Schlüssel direkt in Ihren Passwort-Manager oder Ihr System zur Verwaltung von Geheimnissen (Secret-Management-System). Für den ersten Schlüssel bietet der Bildschirm Keys möglicherweise eine zusätzliche Aktion Schlüssel einmalig anzeigen. Nachdem diese verbleibende Anzeige genutzt wurde, ist nur noch eine Maske verfügbar. Ein Schlüssel, der später in einem Organisationsbildschirm erstellt wird, muss während der Erstellung kopiert werden.

Speichern Sie einen Schlüssel niemals in clientseitigem JavaScript, einer mobilen Anwendung, einem öffentlichen Repository, einem Screenshot oder einer Support-Nachricht. Die folgenden Beispiele gehen davon aus, dass der Schlüssel auf dem Server als OMEV_API_KEY gespeichert ist.

3. Prüfen, was der Schlüssel verwenden kann

curl -sS https://llmapi.omev.be/v1/models \
  -H "Authorization: Bearer $OMEV_API_KEY"

Entwickeln Sie nur gegen die dokumentierten öffentlichen omev-*-Namen, die für Ihren Schlüssel zurückgegeben werden. Bildprodukte erscheinen erst, nachdem ihr Zugang freigeschaltet wurde. Die Preise aller Produkte finden Sie unter Modelle und Preise.

4. Die erste Textanfrage senden

curl -sS https://llmapi.omev.be/v1/chat/completions \
  -H "Authorization: Bearer $OMEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omev-lite",
    "messages": [
      {"role": "system", "content": "Follow the requested format carefully."},
      {"role": "user", "content": "Summarise this text in five bullets: ..."}
    ],
    "temperature": 0.2,
    "max_tokens": 500,
    "stream": false
  }'

Die Antwort befindet sich in choices[0].message.content. Informationen zu Python, Modellauswahl, Streaming und strukturiertem JSON finden Sie unter Modelle.

5. Eine exakte Anfrage im Playground testen

Öffnen Sie Playground im Web-Cabinet, wenn Sie denselben JSON-Body testen möchten, den Ihre Anwendung senden wird. Sie können einen bestehenden curl-Befehl einfügen oder eine Anfrage im Formular erstellen. Playground zeigt die Antwort, die Token-Anzahl, die Dauer, den Anfrage-Body und Codebeispiele für curl, Python und NodeJS an.

Der Schlüssel im kopierten Code ist maskiert. Ersetzen Sie die Maske durch OMEV_API_KEY oder einen Verweis auf Ihren Secret-Manager, bevor Sie das Beispiel außerhalb des Browsers ausführen.

6. Nutzung und Kosten überprüfen

Self-Service-Konten nutzen Dashboard, Usage, Journal und Billing im Web-Cabinet. Es kann einige Minuten dauern, bis aktuelle Aufrufe angezeigt werden.

Unternehmenskunden erhalten ebenfalls Zugang zu usage.omev.be, nachdem die Organisation und der erste genehmigte Eigentümer (Owner) provisioniert wurden. Der Owner kann weitere Personen einladen, ohne dass OmevAI jede E-Mail-Adresse manuell eingeben muss.

7. Sicher fortfahren

• Verwenden Sie separate Schlüssel, wenn das Cabinet und Ihre Rolle dies zulassen und eine getrennte Steuerung sinnvoll ist.
• Setzen Sie max_tokens, um die berechneten Ausgabetoken zu begrenzen, legen Sie Zeitüberschreitungen (Timeouts) fest und verwenden Sie eine kleine maximale Anzahl von Wiederholungsversuchen.
• Wiederholen Sie Anfragen bei 429-Fehlern, temporären 5xx-Antworten und vorübergehenden Netzwerkfehlern mit zunehmender Verzögerung. Wiederholen Sie eine unveränderte 400-, 401-, 403-, 404- oder 413-Anfrage nicht.
• Validieren Sie strukturierte Ausgaben in Ihrer eigenen Anwendung.
• Bewahren Sie Anfrage-IDs und Schlüsselmasken in Protokollen auf, niemals vollständige Schlüssel oder vertrauliche Prompts.

Bei Fragen zum Zugang oder bei einem ungelösten Problem kontaktieren Sie support@omev.be. Geben Sie die E-Mail-Adresse des Kontos, die ungefähre Zeit und Zeitzone, den Endpunkt, das öffentliche Modell, den Status, die Anfrage-ID (sofern verfügbar) und ein bereinigtes Beispiel an.