Eingebaute KI, Bilderzeugung 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 & Anthropic)
Erzeuge Texte, Zusammenfassungen, Chat-Antworten und andere KI-Inhalte — und lies Bilder, PDFs oder Tabellen, die du ihr gibst. Bereitgestellt über OpenAI oder Anthropics Claude-Modelle via Genie.
Bilderzeugung (Replicate)
Erzeuge ein Bild aus einem Prompt oder bearbeite ein vorhandenes Bild — zum Beispiel den Hintergrund oder Stil eines Fotos ändern. Frag nach einem Logo oder Schriftzug, und Genie rendert den tatsächlich gewünschten Schriftzug, statt Text wegzulassen. Bereitgestellt über Googles Bildmodell via Replicate.
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.
Außerdem siehst du passende Einträge
OPENAI_BASE_URL, ANTHROPIC_BASE_URL, REPLICATE_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-, Anthropic-, Replicate- 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:1
Deine App ruft den Dienst auf
Dein generierter Code ruft OpenAI, Anthropic, Replicate, Resend oder Hugging Face ganz normal auf und verwendet dabei die eingesetzten Zugangsdaten.
2
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.
3
Die Antwort kommt zurück
Die Antwort des Anbieters wird unverändert direkt an deine App zurückgegeben. KI-Antworten werden Token für Token gestreamt, genau wie bei einem direkten Aufruf.
Nutzung und Limits
Jede Anfrage, die deine App über die eingebauten Zugangsdaten stellt, wird erfasst — Anbieter, Endpunkt, Status und Zeitverhalten — damit Genie den Dienst überwachen und die Nutzung deinem Projekt zuordnen kann. KI-Text (OpenAI oder Anthropic) sowie Bild-, Video- oder Audioerzeugung (Replicate) verringern deine Credits. Eine erfolgreiche Anfrage wird zum gleichen Satz pro Modell abgerechnet, mit dem auch dein Projekt-Chat abgerechnet wird, und erscheint in deinem Kontoauszug alsGenie proxy · <Anbieter> · <Modell>. Die Nutzung deiner laufenden App findest du unter Projekteinstellungen → Nutzung — eine tagesgenaue Aufschlüsselung mit einem 7/30/90-Tage-Umschalter — oder in deinem Kontoverlauf.
E-Mail (Resend) und Hugging-Face-Inferenz werden noch nicht gemessen und verringern derzeit keine Credits.
Eine Abrechnung greift erst, sobald Genie ein Modell bepreist hat — eine Anfrage an ein unbepreistes Modell wird mit null Credits berechnet. Sobald die Bepreisung auf weitere Modelle ausgeweitet wird, beginnt die Nutzung darüber automatisch, Credits zu verringern, ohne dass du etwas ändern musst.
Retrieval (RAG) mit Embeddings
Wenn deine App semantische Suche oder Retrieval-Augmented Generation (RAG) braucht — eine Nutzerfrage nach Bedeutung statt nach exakten Schlagwörtern mit deinen eigenen Inhalten abzugleichen —, kann Genie Text sofort in Embeddings (Vektor-Darstellungen) umwandeln, ganz ohne separaten OpenAI-Schlüssel. Bitte Genie um etwas wie „lass Nutzer:innen unsere FAQ nach Bedeutung durchsuchen” oder „beantworte Fragen anhand unserer hochgeladenen Dokumente”, und Genie richtet beide Hälften des Ablaufs ein:- Jeden Abschnitt deiner Inhalte beim Einlesen in einen Vektor umwandeln und das Ergebnis in deiner Genie-Cloud-Datenbank speichern (die dafür
pgvectorunterstützt). - Die Frage einer Nutzerin oder eines Nutzers zum Suchzeitpunkt in einen Vektor umwandeln und mit deinen gespeicherten Inhalten vergleichen, um die passendsten Treffer zu finden.
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. Die eingebauten Anthropic-Zugangsdaten funktionieren genauso und sind auf Genies Standard-Claude-Modell beschränkt. Wenn deine App ein anderes Modell anfordert, wird die Anfrage abgelehnt. Um ein bestimmtes oder leistungsfähigeres Modell zu nutzen, verwende deinen eigenen OpenAI- oder Anthropic-Schlüssel. Manche leistungsfähigeren Modelle — darunter bestimmte Claude-Modelle — sind möglicherweise auf bestimmte Tarife oder Konten beschränkt. Geh nicht davon aus, dass jedes Modell für jedes Projekt verfügbar ist.Bildmodell
Die eingebauten Replicate-Zugangsdaten sind auf eine kleine Auswahl von Genie-ausgewählten Bildmodellen beschränkt (Googles nano-banana-Familie, sowohl für die Erzeugung neuer Bilder als auch für die Bearbeitung vorhandener Bilder). Wenn deine App ein Modell außerhalb dieser Auswahl anfordert, wird die Anfrage abgelehnt. Um ein anderes Bildmodell zu nutzen, verwende deinen eigenen Replicate-Schlüssel.Tabellen-Anhänge
Kein KI-Modell liest eine.xlsx-Datei direkt, deshalb wandelt Genie sie automatisch in eine reine Text-Tabelle um, bevor sie im Rahmen einer eingebauten KI-Anfrage deiner App das Modell erreicht — dieselben Daten, nur in einem Format, das jedes Modell bereits lesen kann. Es gibt nichts einzurichten; das passiert bei jeder Anfrage über die eingebauten Zugangsdaten.
Sehr große Arbeitsmappen werden gekürzt, damit eine Anfrage eine vernünftige Größe behält: bis zu 8 MB pro Datei, 5 Dateien pro Anfrage, und es werden die ersten 10 Tabellenblätter (je 500 Zeilen × 30 Spalten) einbezogen, mit einem Hinweis, wo Inhalt gekürzt werden musste.
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.1
Erstelle einen Schlüssel beim Anbieter
Registriere dich bei OpenAI, Anthropic, Replicate, Resend oder Hugging Face und erstelle einen API-Schlüssel. Verifiziere bei Resend zuerst deine Absender-Domain in deren Dashboard.
2
Öffne die Secrets deines Projekts
Öffne in deinem Projekt Einstellungen → Secrets. Details findest du unter Secrets.
3
Ersetze den Wert
Bearbeite das jeweilige Secret —
OPENAI_API_KEY, ANTHROPIC_API_KEY, REPLICATE_API_TOKEN, RESEND_API_KEY oder HF_TOKEN — und füge deinen eigenen Schlüssel anstelle des eingebauten ein.4
Speichern
Speichere das Secret. Genie aktualisiert automatisch den passenden Base-URL-Eintrag, sodass er direkt auf den Anbieter zeigt und deine App mit deinem Schlüssel direkt mit dem Anbieter spricht, statt über Genies Relay zu laufen. Codeänderungen sind nicht nötig.
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.
