Skip to main content
Wenn deine App Texte mit KI erzeugen, ein Bild erstellen oder bearbeiten oder eine E-Mail versenden muss, spricht sie normalerweise mit einem externen Dienst wie OpenAI, Replicate oder Resend — und bei jedem dieser Dienste musst du dich erst registrieren, deine Angaben verifizieren und einen API-Schlüssel erstellen, bevor irgendetwas funktioniert. Genie nimmt dir diesen Schritt ab. Jedes Projekt mit aktivierter Genie Cloud kommt mit bereits eingerichteten, funktionierenden Zugangsdaten für diese Dienste, sodass KI-Funktionen, Bilderzeugung und transaktionale E-Mails schon beim ersten Mal funktionieren — ohne dass du dich irgendwo anmeldest.
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.
In deinem Secrets-Tab erscheinen die folgenden Einträge, bereits ausgefüllt: 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).
Beschreibe einfach, was du möchtest — „fasse jedes Support-Ticket zusammen”, „erzeuge ein Hero-Bild von einem Sonnenuntergang über Bergen”, „ändere den Hintergrund dieses Fotos zu einem Strand”, „gestalte einen Schriftzug-Logo mit dem Text Nova Studio”, „beantworte Fragen zu diesem hochgeladenen PDF”, „schick mir eine E-Mail, wenn jemand das Formular absendet” — und Genie baut die Funktion mit diesen eingebauten Zugangsdaten. API-Schlüssel musst du gar nicht erwähnen.

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.
Durch dieses Design bleiben die echten Anbieter-Schlüssel auf Genies Seite — sie werden nie in deinem Projekt abgelegt, wo sie gelesen oder geleakt werden könnten — während trotzdem jede Anfrage deinem Projekt zugeordnet wird, sodass die Nutzung fair gemessen werden kann.

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 als Genie 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.
Die praktische Grenze der eingebauten Zugangsdaten ist außerdem ein Limit pro Projekt (eine Obergrenze an Anfragen pro Minute), unabhängig von der Credit-Abrechnung. 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.
Dein eigener Schlüssel hält die Kosten vollständig unter deiner eigenen Kontrolle und außerhalb von Genies Credit-System — siehe Eigene Schlüssel verwenden weiter unten. Diese Anfragen werden stattdessen direkt vom Anbieter an dich abgerechnet.

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 pgvector unterstü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.
Genie wählt automatisch das passende Embedding-Modell — du musst keins selbst auswählen. Die Embeddings-Nutzung wird genauso erfasst wie andere eingebaute KI-Anfragen, sodass Aufrufe zusammen mit deiner übrigen Aktivität unter Projekteinstellungen → Nutzung erscheinen.
Beschreibe einfach, was du suchen oder abrufen möchtest, und Genie baut den Einlese- und Suchablauf mit den eingebauten Embeddings — du musst weder Vektordatenbanken noch Embedding-Modelle namentlich erwähnen.

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:
Wenn du versuchst, von einer anderen Adresse zu senden, wird die Anfrage mit einer klaren Meldung abgelehnt. Der Grund: E-Mail-Anbieter erlauben den Versand nur von Domains, die verifiziert wurden, und 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.comverwende deinen eigenen Resend-Schlüssel.
Wenn die E-Mails deiner App von der Adresse deiner eigenen Marke kommen sollen, richte vor dem Launch deinen eigenen Resend-Schlüssel ein. Der eingebaute Absender eignet sich hervorragend zum Testen und für interne Benachrichtigungen, aber Empfänger:innen sehen noreply@email.genie-app.de als Absender.

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.
Nach dem Wechsel gehen die Anfragen für diesen Anbieter direkt von deiner App zum Anbieter, werden über dein eigenes Konto abgerechnet und unterliegen nicht mehr Genies Modell-Allowlist, der Absender-Einschränkung oder dem Limit. Die übrigen eingebauten Zugangsdaten, die du nicht geändert hast, funktionieren weiter wie zuvor.
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

Frag Genie im Projekt-Chat — „warum scheitert meine E-Mail?”, „warum wurde meine Bilderzeugungs-Anfrage abgelehnt?” oder „stelle meine App auf meinen eigenen OpenAI-Schlüssel um” — und Genie kann deine Secrets und den relevanten Code prüfen und dich durch die Lösung führen.