Kom igång
Widgetar (bädda in på din webbplats)
Lägg en white-label-widget för chat, bild, tal, musik eller video på din webbplats med en script-tagg, låst till dina domäner och dina utgiftsgränser.
Widgetar lägger ett white-label-AI-gränssnitt på din egen webbplats med en script-tagg: chat, bild, tal, musik eller video, drivet av vilken modell som helst i katalogen. Besökare behöver ingen API-nyckel. Anrop debiteras ditt USD-saldo till modellens vanliga pris.
Skapa en widget
- Öppna Widgetar och välj New widget (eller designa en först, utan konto, på widgetsidan).
- Välj en typ och en modell och ange sedan titel, färger, tema, hörnradie, texter och placering. Chattwidgetar tar också privata instruktioner och en gräns för svarslängd.
- Förhandsvisningen kör dina osparade inställningar på riktigt, så du kan testa en modell eller instruktioner innan du sparar. Anrop från förhandsvisningen debiteras ditt saldo.
- Spara och kopiera sedan inbäddningskoden.
Inbäddningskod
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Placera taggen i <body> där widgeten ska visas. Alternativ:
| Attribut | Effekt |
|---|---|
data-widget | Obligatoriskt. Widget-id:t från dashboarden. |
data-target | CSS-selektor för ett element att rendera i, till exempel #support. Utan den renderas widgeten precis före script-taggen. |
data-height | Höjd på en inbäddad widget, till exempel 520px. Standard: 480px för chat, 420px för andra typer. |
Widgeten renderas i en isolerad Shadow DOM, så din sidas stilar läcker inte in och widgeten ändrar inte din sida. Med placeringen Floating button öppnas den i stället från en knapp i det nedre hörnet.
Tillåtna webbplatser
En widget svarar bara på anrop från de webbplatser du listar under Inställningar, Widget-webbplatser. En domän per rad. En domän omfattar också sina underdomäner (example.com omfattar www.example.com). Lägg till en port för att bara tillåta den porten, till exempel localhost:3000 för lokal testning. Förhandsvisningen i dashboarden fungerar alltid.
En sida på någon annan webbplats får 403 site_not_allowed och widgeten renderas inte (webbläsarkonsolen visar en rad som förklarar varför).
Kontrollen använder webbläsarens Origin-huvud. Webbläsare kan inte ändra det, men verktyg utanför en webbläsare kan, så behandla webbplatslistan som en begränsning, inte en hemlighet. Utgiftskontrollerna nedan är det som begränsar kostnaden.
Utgiftskontroller
Eftersom en widget är publik begränsas dess kostnad av gränser som bara du kan ändra:
| Kontroll | Var | Effekt |
|---|---|---|
| Daglig utgiftsgräns för den här widgeten | Widgetredigeraren | När widgeten har spenderat så mycket idag (UTC) slutar den svara till nästa dag: 429 widget_daily_limit. |
| Daglig utgiftsgräns för alla widgetar | Inställningar, Widgetkontroller | En gemensam gräns för alla widgetar på kontot. |
| Anrop per besökare och dag | Inställningar, Widgetkontroller | Räknas per besökares IP, för varje widget. Standard 100: 429 visitor_daily_limit. |
| Anrop per besökare och minut | Fast | 10 per minut och besökare: 429 rate_limited. |
| Widgetens hastighet | Din plan | Alla besökare på en widget delar tillsammans din plans anrop per minut. |
Ditt saldo är den slutliga gränsen: vid 0 USD returnerar varje widget 402 insufficient_balance tills du fyller på.
Status och aviseringar
Widgetlistan visar när varje widget senast användes, dagens utgifter och anrop, samt det senaste felet när en widget misslyckas av en orsak du kan åtgärda: tomt saldo, en borttagen modell, en nådd utgiftsgräns eller en webbplats som saknas i listan. Med Email me when a widget fails aktiverat (Inställningar, Widgetkontroller) får du högst ett e-postmeddelande per widget och dag.
Användning visar widgetanrop med widgetens namn och webbplatsen de kom från. Gruppera efter By widget eller By site för att jämföra dem.
Vad besökare ser
- Chattsvar strömmas in och stöder grundläggande formatering (stycken, listor, fetstil, kursiv, kod och länkar). Konversationen finns kvar medan besökaren går mellan sidor i samma flik.
- En Stop-knapp avslutar ett långt svar. Efter ett fel skickar en länk Try again meddelandet igen.
- Bilder, ljud och video levereras med en Download-länk. Video genereras som ett bakgrundsjobb och visas när den är klar, vanligtvis inom några minuter.
- Besökare ser aldrig dina instruktioner, ditt saldo eller modellens råa fel. De ser ditt felmeddelande (eller ett neutralt standardmeddelande), och orsaken visas för dig i dashboarden.
- Texter som du lämnar tomma använder standardtexter på ditt kontos språk.