Eingebaute KI und E-Mail erfordern, dass Genie Cloud mit deinem Projekt verbunden ist. Falls noch nicht aktiviert, richte sie zuerst über Genie Cloud ein.
Was du sofort bekommst
Wenn Genie Cloud für dein Projekt bereitgestellt wird, fügt Genie deinem Projekt automatisch eine Reihe einsatzbereiter Zugangsdaten als Secrets hinzu. Du musst sie nicht erstellen und nirgends einfügen — der von Genie generierte Code liest sie von selbst.KI-Text (OpenAI)
Erzeuge Texte, Zusammenfassungen, Chat-Antworten und andere KI-Inhalte. Bereitgestellt über OpenAI via Genie.
E-Mail (Resend)
Versende transaktionale E-Mails — Bestätigungen, Benachrichtigungen, Nachrichten aus Kontaktformularen — über Resend.
ML-Inferenz (Hugging Face)
Führe Machine-Learning-Modelle für Aufgaben wie Klassifizierung oder Bildverarbeitung über Hugging Face aus.
| Secret | Wofür es dient |
|---|---|
OPENAI_API_KEY | KI-Texterstellung |
RESEND_API_KEY | E-Mail-Versand |
HF_TOKEN | Hugging-Face-Modellinferenz |
OPENAI_BASE_URL, RESEND_BASE_URL und HF_ENDPOINT. Diese weisen deine App an, Anfragen über Genie zu leiten. Lass sie unverändert, es sei denn, du wechselst zu deinem eigenen Schlüssel (siehe Eigene Schlüssel verwenden weiter unten).
Wie es funktioniert
Deine App hält niemals einen echten OpenAI- oder Resend-Schlüssel. Stattdessen sind die von Genie eingesetzten Zugangsdaten projektspezifische Zugriffstoken, die auf Genies sicheren Relay-Dienst zeigen. Wenn deine App eine Anfrage stellt:Deine App ruft den Dienst auf
Dein generierter Code ruft OpenAI, Resend oder Hugging Face ganz normal auf und verwendet dabei die eingesetzten Zugangsdaten.
Genie authentifiziert und leitet weiter
Die Anfrage erreicht Genie, das prüft, ob sie zu deinem Projekt gehört, und leitet sie dann mit Genies eigenem Anbieter-Schlüssel an den echten Anbieter weiter.
Nutzung und Limits
Die eingebauten Zugangsdaten sind heute ohne zusätzliche Gebühr pro Anfrage in Genie Cloud enthalten. Jede Anfrage, die deine App darüber stellt, wird erfasst — Anbieter, Endpunkt, Status und Zeitverhalten — damit Genie den Dienst überwachen kann und die Nutzung deinem Projekt zugeordnet werden kann. Diese erfasste Nutzung wird derzeit nicht pro Anfrage gemessen oder dir in Rechnung gestellt: Sie verringert nicht deine Credits und erscheint nicht als Posten auf deiner Rechnung. Die praktische Grenze der eingebauten Zugangsdaten ist ein Limit pro Projekt (eine Obergrenze an Anfragen pro Minute), keine Nutzungsgebühr. Normaler App-Verkehr bleibt deutlich darunter; wenn du mit dauerhaft hohem Volumen rechnest, verwende deinen eigenen Schlüssel oder kontaktiere den Support, um das Limit anzuheben.Eine Abrechnung pro Anfrage für die Nutzung der eingebauten KI und E-Mail könnte in Zukunft eingeführt werden. Sollte sich das ändern, wird es hier sowie auf den Seiten Credits und Tarife abgebildet. Damit deine Kosten vollständig planbar und unter deiner eigenen Kontrolle bleiben, verwende deinen eigenen Schlüssel — diese Anfragen werden direkt vom Anbieter an dich abgerechnet.
Grenzen der eingebauten Zugangsdaten
Die enthaltenen Zugangsdaten sind auf den Normalfall ausgelegt — Funktionen sofort und günstig zum Laufen zu bringen. Damit gehen einige Einschränkungen einher:KI-Modell
Die eingebauten OpenAI-Zugangsdaten sind auf Genies Standardmodell beschränkt, das so gewählt ist, dass es schnell und kostengünstig für typische App-Funktionen ist. Wenn deine App ein anderes Modell anfordert, wird die Anfrage abgelehnt. Um ein bestimmtes oder leistungsfähigeres Modell zu nutzen, verwende deinen eigenen OpenAI-Schlüssel.E-Mail-Absenderadresse
E-Mails, die über die eingebauten Resend-Zugangsdaten versendet werden, müssen Genies verifizierte Absenderadresse verwenden:email.genie-app.de ist die Domain, die Genie für die gemeinsame Nutzung verifiziert hat. Um von deiner eigenen Adresse oder Domain zu senden — zum Beispiel hello@deinefirma.com — verwende deinen eigenen Resend-Schlüssel.
Eigene Schlüssel verwenden
Du kannst jede der eingebauten Zugangsdaten jederzeit durch deine eigenen ersetzen. Das ist der richtige Schritt, wenn du ein bestimmtes KI-Modell, deine eigene E-Mail-Domain, deine eigenen Nutzungslimits oder die Abrechnung über dein eigenes Konto möchtest.Erstelle einen Schlüssel beim Anbieter
Registriere dich bei OpenAI, Resend oder Hugging Face und erstelle einen API-Schlüssel. Verifiziere bei Resend zuerst deine Absender-Domain in deren Dashboard.
Öffne die Secrets deines Projekts
Öffne in deinem Projekt Einstellungen → Secrets. Details findest du unter Secrets.
Ersetze den Wert
Bearbeite das jeweilige Secret —
OPENAI_API_KEY, RESEND_API_KEY oder HF_TOKEN — und füge deinen eigenen Schlüssel anstelle des eingebauten ein.Der Wechsel zurück zu den eingebauten Zugangsdaten erfolgt durch erneutes Bereitstellen des Projekts (der Button Bootstrap erneut ausführen im Cloud-Tab setzt die eingebauten Werte neu ein). Ein dedizierter Ein-Klick-Reset ist geplant.
Fehlerbehebung
| Was du siehst | Wahrscheinliche Ursache | Was zu tun ist |
|---|---|---|
| KI-Anfragen scheitern mit einem Fehler „ungültiges Modell” | Deine App hat ein Modell angefragt, das die eingebauten Zugangsdaten nicht erlauben | Stelle die Funktion auf Genies Standardmodell um oder verwende deinen eigenen OpenAI-Schlüssel |
| E-Mail wird mit einem Absender-/Domain-Fehler abgelehnt | Die App sendet von einer anderen Adresse als noreply@email.genie-app.de | Verwende die eingebaute Absenderadresse oder deinen eigenen Resend-Schlüssel mit verifizierter Domain |
| Ein Dienst funktioniert nach dem Bearbeiten eines Secrets nicht mehr | Die eingebauten Zugangsdaten wurden versehentlich geändert oder gelöscht | Führe im Cloud-Tab „Bootstrap erneut ausführen” aus, um die eingebauten Werte wiederherzustellen, oder füge einen gültigen eigenen Schlüssel ein |
| Anfragen scheitern bei hoher Last | Du hast das Limit pro Projekt erreicht | Reduziere das Anfragevolumen, verwende deinen eigenen Schlüssel oder kontaktiere den Support, um das Limit anzuheben |