Häufig gestellte Fragen

Authentifizierung & Zugang

Wie erhalte ich API-Anmeldedaten?

Gehen Sie zu Service Accounts in der neuroflash App und erstellen Sie einen neuen Service Account. Sie erhalten eine client_id und ein client_secret. Die vollständige Einrichtungsanleitung finden Sie unter Authentifizierung.

Wie lange sind Access Tokens gültig?

Access Tokens sind ungefähr 4 Stunden (14.399 Sekunden) gültig. Wenn Ihr Token abläuft, gibt die API eine 401 Unauthorized-Antwort zurück. Fordern Sie einen neuen Token mit demselben Client-Credentials-Flow an.

Sie sollten Ihren Token cachen und wiederverwenden, bis er abläuft — es ist nicht notwendig, für jeden API-Aufruf einen neuen Token anzufordern.

Kann ich die API aus clientseitigem/Browser-Code verwenden?

Nein. Ihr client_secret muss vertraulich bleiben und darf niemals in clientseitigem Code, mobilen Apps oder Browser-JavaScript offengelegt werden. Rufen Sie die neuroflash API immer von einem Backend-Server aus auf.

Workspaces & Kontingente

Wie finde ich meine Workspace-ID?

Rufen Sie den Endpoint Workspaces auflisten auf:

GET https://app.neuroflash.com/api/workspace-service/v1/workspaces

Die Antwort enthält alle Workspaces, auf die Ihr Service Account Zugriff hat. Verwenden Sie das id-Feld des Workspaces, mit dem Sie arbeiten möchten. Ein vollständiges Beispiel finden Sie im Schnellstart.

Was ist der Unterschied zwischen täglichen und monatlichen Limits?

Ihr Workspace hat sowohl ein monatliches Limit (limitAmount) als auch ein tägliches Limit (limitAmountDaily). Das tägliche Limit verhindert übermäßige Nutzung an einem einzelnen Tag, während das monatliche Limit die Gesamtnutzung für den Abrechnungszeitraum begrenzt. Für eine erfolgreiche Anfrage muss bei beiden noch Kapazität verfügbar sein.

Überprüfen Sie Ihre aktuelle Nutzung mit dem Kontingente-Endpoint.

Was passiert, wenn mein Kontingent zurückgesetzt wird?

Monatliche Kontingente werden zu Beginn jedes Abrechnungszeitraums zurückgesetzt. Tägliche Kontingente (usedAmountDaily) werden jeden Tag zurückgesetzt. Das Feld dailyRefreshed in der Kontingent-Antwort zeigt das Datum der letzten täglichen Zurücksetzung.

Was bedeutet fairUseLimitReached?

Wenn fairUseLimitReached den Wert true hat, hat Ihr Workspace den Schwellenwert der Fair-Use-Richtlinie erreicht. Dies ist unabhängig von Ihren regulären Kontingentlimits und dient dazu, Missbrauch zu verhindern. Die API gibt eine 403 Forbidden-Antwort zurück, bis das Limit zurückgesetzt wird. Wenn Sie glauben, dass dies ein Fehler ist, wenden Sie sich an den Support.

Content-Generierung

Welche KI-Modelle sind verfügbar?

Die verfügbaren Modelle hängen vom Abonnementplan Ihres Workspaces ab. Rufen Sie den Modelle-Endpoint auf, um die Modelle aufzulisten, auf die Sie Zugriff haben. Modelle von Anbietern wie OpenAI (GPT), Anthropic (Claude), Google (Gemini) und Mistral können verfügbar sein.

Wie funktioniert die Wortverbrauchserfassung?

Jede Content-Generierungsanfrage verbraucht Wörter aus dem Kontingent Ihres Workspaces. Die Anzahl der verbrauchten Wörter hängt von der Länge des generierten Inhalts ab. Überprüfen Sie Ihr verbleibendes Wortguthaben mit dem Kontingente-Endpoint.

Kann ich Antworten streamen?

Der Chat-Completions-Endpoint unterstützt Streaming über Server-Sent Events. Setzen Sie "stream": true in Ihrem Request Body, um inkrementelle Antworten zu erhalten, während diese generiert werden.

Allgemein

Welches Format haben Request- und Response-Bodies?

Alle Request- und Response-Bodies verwenden JSON. Setzen Sie den Header Content-Type: application/json bei Anfragen, die einen Body enthalten. Antworten liefern immer JSON mit Content-Type: application/json zurück.

Wie melde ich ein Problem oder erhalte Support?

• Bei Problemen mit der API-Dokumentation erstellen Sie ein Issue im Dokumentations-Repository
• Bei API-Fehlern oder Kontoproblemen kontaktieren Sie den neuroflash-Support über die App
• Fügen Sie bei der Meldung von Problemen den x-request-id-Header aus der API-Antwort bei — siehe Debugging für Details