Skip to main content
Novita AI bietet Ihnen gehostete Modell-APIs, Agent-Sandboxes und GPU-Infrastruktur. Folgen Sie dem Pfad, der zu Ihrer Aufgabe passt, und verifizieren Sie ein funktionierendes Ergebnis, bevor Sie zu den weiterführenden Anleitungen übergehen.
Wenn Sie Fragen haben, lesen Sie bitte zuerst unsere FAQs oder wenden Sie sich an unser Support-Team auf Discord.

​
1. Anmelden oder Konto erstellen

Melden Sie sich bei novita.ai an. Sie können die Authentifizierung über Google oder GitHub verwenden oder sich mit Ihrer E-Mail-Adresse registrieren.

​
2. API-Schlüssel erstellen

Novita AI authentifiziert API-Anfragen mit einem Bearer-API-Schlüssel. Öffnen Sie Schlüsselverwaltung, um einen Schlüssel zu erstellen oder zu verwalten, und befolgen Sie dann API-Schlüssel, um ihn sicher zu speichern. Übergeben Sie Ihren API-Schlüssel in diesen Beispielen nur über die Umgebungsvariable NOVITA_API_KEY. Legen Sie einen echten API-Schlüssel nicht in Quellcode, Dokumentation, Agent-Chats, Analysen, Screenshots oder Protokollen ab.

​
3. Verfügbares Guthaben prüfen

Prüfen Sie Ihr verfügbares Guthaben unter Abrechnung und Zahlungen, bevor Sie eine Anfrage senden. Produktguthaben und Modellzugriff können beeinflussen, ob eine Anfrage erfolgreich ist. Für eine längerfristige Nutzung siehe Automatisches Aufladen.

​
4. Erste LLM-Anfrage senden

Schließen Sie die oben genannten Schritte zu Konto, API-Schlüssel und Guthaben ab, bevor Sie dieses Beispiel ausführen. Es verwendet den OpenAI-kompatiblen Chat-Completions-Endpunkt und das Modell deepseek/deepseek-v4.1-flash:
Eine erfolgreiche Anfrage gibt HTTP 200 und einen nicht leeren choices[0].message.content-Wert zurück, z. B. "Hello!". Der genaue Wortlaut kann je nach Modell variieren. Fügen Sie --include zum cURL-Befehl hinzu, um sowohl den HTTP-Status als auch den Antwort-Body zu prüfen. Ein alleiniges HTTP 200 bestätigt keine gültige Modellantwort. Wenn die Anfrage fehlschlägt, verwenden Sie die passende Anleitung:
  • 401 Unauthorized: Prüfen Sie das Schlüsselformat und die API-Schlüsselkonfiguration.
  • 403 Forbidden: Das Novita-Gateway kann INVALID_API_KEY für einen fehlenden oder ungültigen Schlüssel zurückgeben; prüfen Sie zuerst den Schlüssel. Bei einem Modellzugriffsfehler prüfen Sie den Modellzugriff und ob eine Identitätsverifizierung erforderlich ist.
  • 429 Too Many Requests: Prüfen Sie die Ratenlimits.
  • 5xx: Prüfen Sie die häufigen Fehlercodes und die Hinweise zu Wiederholungsversuchen.
Für Python, JavaScript, Streaming und zusätzliche Anfrageoptionen fahren Sie mit dem LLM-API-Leitfaden fort.

​
5. Agent verwenden

Ihr Agent kann Ihnen helfen, die Anfrage zu erstellen und Novita AI zu integrieren. Schließen Sie die oben genannten Schritte zu Konto, API-Schlüssel und Guthaben ab und stellen Sie NOVITA_API_KEY in der Umgebung bereit, in der der Agent den Code ausführt. Bitten Sie ihn, den Novita AI Skill zu lesen:
Wenn Ihr Agent Skills unterstützt, können Sie ihn einmal installieren:
Skill auf GitHub ansehen →. Nachdem der Agent die Integration geschrieben hat, führen Sie die Anfrage aus und verifizieren Sie HTTP 200 mit nicht leerem choices[0].message.content. Wenn der Agent-Weg nicht funktioniert, kehren Sie zu der manuellen Anfrage zurück.

​
6. Fehlerbehebung

Wenn Sie die erste Anfrage nicht abschließen können, prüfen Sie Folgendes in dieser Reihenfolge:
  1. Die Umgebungsvariable NOVITA_API_KEY ist in der aktuellen Shell gesetzt.
  2. Der Schlüssel ist aktiv und hat Zugriff auf deepseek/deepseek-v4.1-flash.
  3. Ihr Konto verfügt über verfügbares Guthaben und hat alle erforderlichen Verifizierungen abgeschlossen.
  4. Endpunkt, Modell-ID und Anfrage-Body entsprechen dem Beispiel.
  5. Der zurückgegebene Statuscode wird in Häufige Fehlercodes behandelt.
Eine vollständige Liste der Endpunkte und Parameter finden Sie in der API-Referenz.
Zuletzt geändert am 17. September 2026