Pierwsze kroki
Widżety (osadzanie na stronie)
Umieść na swojej stronie białoetykietowy widżet czatu, obrazów, mowy, muzyki lub wideo jednym tagiem script, z blokadą domen i limitami wydatków.
Widżety umieszczają białoetykietowy interfejs AI na Twojej stronie jednym tagiem script: czat, obrazy, mowa, muzyka lub wideo, na dowolnym modelu z katalogu. Odwiedzający nie potrzebują klucza API. Zapytania są rozliczane z Twojego salda w USD po zwykłej cenie modelu.
Tworzenie widżetu
- Otwórz Widżety i wybierz New widget (lub najpierw zaprojektuj widżet bez konta na stronie widżetów).
- Wybierz typ i model, a następnie ustaw tytuł, kolory, motyw, zaokrąglenie rogów, teksty i położenie. Widżety czatu przyjmują też prywatne instrukcje i limit długości odpowiedzi.
- Podgląd uruchamia Twoje niezapisane ustawienia naprawdę, więc możesz przetestować model lub instrukcje przed zapisaniem. Zapytania z podglądu są rozliczane z Twojego salda.
- Zapisz, a następnie skopiuj kod osadzania.
Kod osadzania
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Umieść tag wewnątrz <body> w miejscu, w którym ma pojawić się widżet. Opcje:
| Atrybut | Efekt |
|---|---|
data-widget | Wymagany. Identyfikator widżetu z panelu. |
data-target | Selektor CSS elementu, w którym ma się wyrenderować widżet, na przykład #support. Bez niego widżet renderuje się tuż przed tagiem script. |
data-height | Wysokość widżetu wbudowanego, na przykład 520px. Domyślnie: 480px dla czatu, 420px dla pozostałych typów. |
Widżet renderuje się w izolowanym Shadow DOM, więc style Twojej strony nie przenikają do niego, a widżet nie zmienia Twojej strony. Przy położeniu Floating button otwiera się z przycisku w dolnym rogu.
Dozwolone strony
Widżet odpowiada tylko na zapytania ze stron wymienionych w Settings, Widget sites. Jedna domena w wierszu; domena obejmuje też swoje subdomeny (example.com obejmuje www.example.com). Dodaj port, aby dopuścić tylko ten port, na przykład localhost:3000 do testów lokalnych. Podgląd w panelu zawsze działa.
Strona z dowolnej innej witryny dostaje 403 site_not_allowed, a widżet się nie renderuje (konsola przeglądarki pokazuje jedną linię z wyjaśnieniem powodu).
Kontrola korzysta z nagłówka Origin przeglądarki. Przeglądarki nie mogą go zmienić, ale narzędzia spoza przeglądarki mogą, więc traktuj listę stron jako ograniczenie, a nie sekret. Koszt ogranicza dopiero kontrola wydatków opisana poniżej.
Kontrola wydatków
Ponieważ widżet jest publiczny, jego koszt ograniczają limity, które możesz zmieniać tylko Ty:
| Kontrola | Gdzie | Efekt |
|---|---|---|
| Dzienny limit wydatków tego widżetu | Edytor widżetu | Gdy widżet wyda dziś tyle (UTC), przestaje działać do następnego dnia: 429 widget_daily_limit. |
| Dzienny limit wydatków wszystkich widżetów | Settings, Widget controls | Jeden limit dla wszystkich widżetów na koncie. |
| Zapytania na odwiedzającego dziennie | Settings, Widget controls | Liczone według adresu IP odwiedzającego, osobno dla każdego widżetu. Domyślnie 100: 429 visitor_daily_limit. |
| Zapytania na odwiedzającego na minutę | Stały | 10 na minutę na odwiedzającego: 429 rate_limited. |
| Limit widżetu | Twój plan | Wszyscy odwiedzający jednego widżetu współdzielą liczbę zapytań na minutę z Twojego planu. |
Ostatecznym limitem jest Twoje saldo: przy 0 USD każdy widżet zwraca 402 insufficient_balance, dopóki nie doładujesz konta.
Stan i alerty
Lista widżetów pokazuje, kiedy każdy widżet był ostatnio używany, dzisiejsze wydatki i zapytania oraz ostatni błąd, gdy widżet zawodzi z powodu, który możesz naprawić: puste saldo, usunięty model, osiągnięty limit wydatków lub strona brakująca na liście. Przy włączonej opcji Email me when a widget fails (Settings, Widget controls) dostaniesz co najwyżej jeden e-mail na widżet dziennie.
Usage pokazuje zapytania widżetów z nazwą widżetu i stroną, z której pochodzą; pogrupuj według By widget lub By site, aby je porównać.
Co widzą odwiedzający
- Odpowiedzi czatu napływają strumieniowo i obsługują podstawowe formatowanie (akapity, listy, pogrubienie, kursywa, kod i linki). Rozmowa pozostaje, gdy odwiedzający przechodzi między stronami w tej samej karcie.
- Przycisk Stop kończy długą odpowiedź; po błędzie link Try again wysyła wiadomość ponownie.
- Obrazy, dźwięk i wideo mają link Download. Wideo jest generowane jako zadanie w tle i pojawia się, gdy jest gotowe, zwykle w ciągu kilku minut.
- Odwiedzający nigdy nie widzą Twoich instrukcji, salda ani surowego błędu modelu. Widzą Twój komunikat o błędzie (lub neutralny domyślny), a przyczyna jest pokazana Tobie w panelu.
- Teksty, które zostawisz puste, używają wartości domyślnych w języku Twojego konta.