Erste Schritte
Widgets (auf Ihrer Website einbetten)
Binden Sie mit einem Script-Tag ein White-Label-Widget für Chat, Bild, Sprache, Musik oder Video ein, auf Ihre Domains beschränkt und durch Limits gedeckelt.
Widgets bringen mit einem Script-Tag eine White-Label-KI-Oberfläche auf Ihre eigene Website: Chat, Bild, Sprache, Musik oder Video, betrieben von einem beliebigen Modell im Katalog. Besucher brauchen keinen API-Schlüssel. Anfragen werden Ihrem USD-Guthaben zum normalen Preis des Modells berechnet.
Ein Widget erstellen
- Öffnen Sie Widgets und wählen Sie Neues Widget (oder gestalten Sie zuerst eines ohne Konto auf der Widgets-Seite).
- Wählen Sie Typ und Modell und legen Sie dann Titel, Farben, Theme, Eckenradius, Texte und Platzierung fest. Chat-Widgets nehmen außerdem private Anweisungen und eine Obergrenze für die Antwortlänge entgegen.
- Die Vorschau führt Ihre ungespeicherten Einstellungen real aus, sodass Sie ein Modell oder Anweisungen vor dem Speichern testen können. Vorschau-Anfragen werden Ihrem Guthaben berechnet.
- Speichern Sie und kopieren Sie dann den Einbettungscode.
Einbettungscode
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Setzen Sie das Tag innerhalb von <body> dorthin, wo das Widget erscheinen soll. Optionen:
| Attribut | Wirkung |
|---|---|
data-widget | Erforderlich. Die Widget-ID aus dem Dashboard. |
data-target | CSS-Selektor eines Elements, in das gerendert wird, zum Beispiel #support. Ohne ihn wird das Widget direkt vor dem Script-Tag gerendert. |
data-height | Höhe eines Inline-Widgets, zum Beispiel 520px. Standard: 480px für Chat, 420px für andere Typen. |
Das Widget wird in einem isolierten Shadow DOM gerendert, sodass Ihre Seitenstile nicht hineinwirken und das Widget Ihre Seite nicht verändert. Bei der Platzierung Schwebende Schaltfläche öffnet es sich stattdessen über eine Schaltfläche in der unteren Ecke.
Erlaubte Websites
Ein Widget beantwortet nur Anfragen von den Websites, die Sie unter Einstellungen, Widget-Websites aufführen. Eine Domain pro Zeile; eine Domain umfasst auch ihre Subdomains (example.com umfasst www.example.com). Fügen Sie einen Port hinzu, um nur diesen Port zu erlauben, zum Beispiel localhost:3000 für lokale Tests. Die Vorschau im Dashboard funktioniert immer.
Eine Seite auf einer anderen Website erhält 403 site_not_allowed, und das Widget wird nicht gerendert (die Browserkonsole zeigt eine Zeile mit der Begründung).
Die Prüfung nutzt den Origin-Header des Browsers. Browser können ihn nicht ändern, Tools außerhalb eines Browsers aber schon, behandeln Sie die Website-Liste daher als Einschränkung, nicht als Geheimnis. Die Kosten begrenzen die Ausgabekontrollen unten.
Ausgabekontrollen
Da ein Widget öffentlich ist, werden seine Kosten durch Limits gedeckelt, die nur Sie ändern können:
| Kontrolle | Wo | Wirkung |
|---|---|---|
| Tägliches Ausgabelimit für dieses Widget | Widget-Editor | Hat das Widget heute (UTC) so viel ausgegeben, stoppt es bis zum nächsten Tag: 429 widget_daily_limit. |
| Tägliches Ausgabelimit für alle Widgets | Einstellungen, Widget-Kontrollen | Eine Obergrenze über alle Widgets des Kontos. |
| Anfragen pro Besucher und Tag | Einstellungen, Widget-Kontrollen | Gezählt pro Besucher-IP, für jedes Widget. Standard 100: 429 visitor_daily_limit. |
| Anfragen pro Besucher und Minute | Fest | 10 pro Minute und Besucher: 429 rate_limited. |
| Widget-Rate | Ihr Plan | Alle Besucher eines Widgets teilen sich die Anfragen pro Minute Ihres Plans. |
Ihr Guthaben ist die letzte Grenze: Bei 0 $ liefert jedes Widget 402 insufficient_balance, bis Sie Guthaben aufladen.
Zustand und Benachrichtigungen
Die Widget-Liste zeigt, wann jedes Widget zuletzt verwendet wurde, die heutigen Ausgaben und Anfragen sowie den letzten Fehler, wenn ein Widget aus einem Grund ausfällt, den Sie beheben können: leeres Guthaben, ein entferntes Modell, ein erreichtes Ausgabelimit oder eine Website, die in der Liste fehlt. Ist E-Mail senden, wenn ein Widget fehlschlägt aktiviert (Einstellungen, Widget-Kontrollen), erhalten Sie höchstens eine E-Mail pro Widget und Tag.
Nutzung zeigt Widget-Anfragen mit dem Widget-Namen und der Website, von der sie kamen; gruppieren Sie nach Nach Widget oder Nach Website, um sie zu vergleichen.
Was Besucher sehen
- Chat-Antworten werden gestreamt und unterstützen einfache Formatierung (Absätze, Listen, Fett, Kursiv, Code und Links). Die Unterhaltung bleibt erhalten, während der Besucher im selben Tab zwischen Seiten wechselt.
- Eine Schaltfläche Stopp beendet eine lange Antwort; nach einem Fehler sendet ein Link Erneut versuchen die Nachricht noch einmal.
- Bilder, Audio und Video werden mit einem Link Herunterladen geliefert. Video wird als Hintergrundauftrag erzeugt und erscheint, wenn es fertig ist, meist innerhalb weniger Minuten.
- Besucher sehen nie Ihre Anweisungen, Ihr Guthaben oder den rohen Fehler des Modells. Sie sehen Ihre Fehlermeldung (oder einen neutralen Standardtext), und die Ursache wird Ihnen im Dashboard angezeigt.
- Texte, die Sie leer lassen, verwenden Standardwerte in der Sprache Ihres Kontos.