Başlarken
Widget'lar
Tek bir script etiketiyle sitenize beyaz etiketli sohbet, görsel, konuşma, müzik veya video widget'ı ekleyin; izinli siteler, harcama limitleri ve uyarılar.
Widget'lar, tek bir script etiketiyle kendi web sitenize beyaz etiketli bir yapay zekâ arayüzü koyar: sohbet, görsel, konuşma, müzik veya video; katalogdaki herhangi bir modelle çalışır. Ziyaretçilerin API anahtarına ihtiyacı yoktur. İstekler, modelin normal fiyatı üzerinden USD bakiyenize ücretlendirilir.
Widget oluşturma
- Widget'lar sayfasını açın ve New widget seçeneğini seçin (veya önce hesap olmadan widget'lar sayfasında tasarlayın).
- Bir tür ve model seçin, ardından başlığı, renkleri, temayı, köşe yarıçapını, metinleri ve yerleşimi ayarlayın. Sohbet widget'ları ayrıca gizli yönergeler ve yanıt uzunluğu sınırı alır.
- Önizleme kaydedilmemiş ayarlarınızı gerçekten çalıştırır; böylece kaydetmeden önce bir modeli veya yönergeleri test edebilirsiniz. Önizleme istekleri bakiyenizden ücretlendirilir.
- Kaydedin, ardından gömme kodunu kopyalayın.
Gömme kodu
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Etiketi, widget'ın görünmesini istediğiniz yerde <body> içine koyun. Seçenekler:
| Öznitelik | Etkisi |
|---|---|
data-widget | Zorunlu. Paneldeki widget kimliği. |
data-target | İçine render edilecek bir öğenin CSS seçicisi, örneğin #support. Olmadan widget, script etiketinin hemen öncesine render edilir. |
data-height | Satır içi bir widget'ın yüksekliği, örneğin 520px. Varsayılanlar: sohbet için 480px, diğer türler için 420px. |
Widget yalıtılmış bir Shadow DOM içinde render edilir; böylece sayfa stilleriniz içeri sızmaz ve widget sayfanızı değiştirmez. Floating button yerleşiminde ise alt köşedeki bir düğmeden açılır.
İzinli siteler
Bir widget yalnızca Ayarlar, Widget siteleri altında listelediğiniz sitelerden gelen isteklere yanıt verir. Satır başına bir alan adı; alan adı alt alan adlarını da kapsar (example.com, www.example.com adresini kapsar). Yalnızca o porta izin vermek için port ekleyin, örneğin yerel test için localhost:3000. Panel önizlemesi her zaman çalışır.
Başka bir sitedeki sayfa 403 site_not_allowed alır ve widget render edilmez (tarayıcı konsolu nedenini açıklayan tek bir satır gösterir).
Kontrol, tarayıcının Origin başlığını kullanır. Tarayıcılar bunu değiştiremez ama tarayıcı dışındaki araçlar değiştirebilir; bu yüzden site listesini bir gizli bilgi değil, bir kısıtlama olarak görün. Maliyeti sınırlayan, aşağıdaki harcama kontrolleridir.
Harcama kontrolleri
Bir widget herkese açık olduğundan maliyeti, yalnızca sizin değiştirebildiğiniz limitlerle sınırlanır:
| Kontrol | Nerede | Etkisi |
|---|---|---|
| Bu widget için günlük harcama limiti | Widget düzenleyicisi | Widget bugün (UTC) bu kadar harcadığında ertesi güne kadar durur: 429 widget_daily_limit. |
| Tüm widget'lar için günlük harcama limiti | Ayarlar, Widget kontrolleri | Hesaptaki tüm widget'lar için tek bir üst sınır. |
| Ziyaretçi başına günlük istek | Ayarlar, Widget kontrolleri | Her widget için ziyaretçi IP'si başına sayılır. Varsayılan 100: 429 visitor_daily_limit. |
| Ziyaretçi başına dakikalık istek | Sabit | Ziyaretçi başına dakikada 10: 429 rate_limited. |
| Widget hızı | Planınız | Bir widget'ın tüm ziyaretçileri, planınızın dakikalık istek sayısını birlikte paylaşır. |
Son limit bakiyenizdir: 0 USD'de her widget, bakiye ekleyene kadar 402 insufficient_balance döndürür.
Sağlık ve uyarılar
Widget listesi, her widget'ın en son ne zaman kullanıldığını, bugünkü harcamasını ve isteklerini ve bir widget sizin çözebileceğiniz bir nedenle başarısız olduğunda son hatayı gösterir: boş bakiye, kaldırılmış bir model, ulaşılan harcama limiti veya listede olmayan bir site. Email me when a widget fails seçeneği açıkken (Ayarlar, Widget kontrolleri) widget başına günde en fazla bir e-posta alırsınız.
Kullanım sayfası, widget isteklerini widget adı ve geldikleri siteyle birlikte gösterir; karşılaştırmak için By widget veya By site ile gruplayın.
Ziyaretçilerin gördükleri
- Sohbet yanıtları akarak gelir ve temel biçimlendirmeyi destekler (paragraflar, listeler, kalın, italik, kod ve bağlantılar). Ziyaretçi aynı sekmede sayfalar arasında gezinirken konuşma korunur.
- Stop düğmesi uzun bir yanıtı sonlandırır; bir hatadan sonra Try again bağlantısı mesajı yeniden gönderir.
- Görsel, ses ve video Download bağlantısıyla gelir. Video arka plan işi olarak üretilir ve hazır olduğunda, genellikle birkaç dakika içinde görünür.
- Ziyaretçiler yönergelerinizi, bakiyenizi veya modelin ham hatasını asla görmez. Sizin hata mesajınızı (veya tarafsız bir varsayılanı) görürler; neden size panelde gösterilir.
- Boş bıraktığınız metinler, hesap dilinizdeki varsayılanları kullanır.