Memulai
Widget (sematkan di situs Anda)
Pasang widget chat, gambar, suara, musik, atau video white-label di situs Anda dengan satu tag script, dikunci ke domain dan dibatasi limit pengeluaran.
Widget menempatkan antarmuka AI white-label di situs web Anda sendiri dengan satu tag script: chat, gambar, suara, musik, atau video, didukung model apa pun di katalog. Pengunjung tidak memerlukan API key. Request ditagih ke saldo USD Anda dengan harga normal model.
Membuat widget
- Buka Widget dan pilih New widget (atau rancang dulu tanpa akun di halaman widget).
- Pilih tipe dan model, lalu atur judul, warna, tema, radius sudut, teks, dan penempatan. Widget chat juga menerima instruksi privat dan batas panjang respons.
- Pratinjau menjalankan pengaturan Anda yang belum disimpan secara nyata, sehingga Anda dapat menguji model atau instruksi sebelum menyimpan. Request pratinjau ditagih ke saldo Anda.
- Simpan, lalu salin kode embed.
Kode embed
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Letakkan tag di dalam <body> di tempat widget harus muncul. Opsi:
| Atribut | Efek |
|---|---|
data-widget | Wajib. ID widget dari dashboard. |
data-target | Selector CSS elemen tempat widget dirender, misalnya #support. Tanpa ini widget dirender tepat sebelum tag script. |
data-height | Tinggi widget inline, misalnya 520px. Default: 480px untuk chat, 420px untuk tipe lain. |
Widget dirender dalam Shadow DOM yang terisolasi, jadi gaya halaman Anda tidak bocor masuk dan widget tidak mengubah halaman Anda. Dengan penempatan Floating button, widget terbuka dari sebuah tombol di sudut bawah.
Situs yang diizinkan
Widget hanya menjawab request dari situs yang Anda daftarkan di Settings, Widget sites. Satu domain per baris; sebuah domain juga mencakup subdomainnya (example.com mencakup www.example.com). Tambahkan port untuk mengizinkan port itu saja, misalnya localhost:3000 untuk pengujian lokal. Pratinjau di dashboard selalu berfungsi.
Halaman di situs lain mendapat 403 site_not_allowed dan widget tidak dirender (konsol browser menampilkan satu baris yang menjelaskan alasannya).
Pemeriksaan ini memakai header Origin dari browser. Browser tidak dapat mengubahnya, tetapi tool di luar browser bisa, jadi perlakukan daftar situs sebagai pembatasan, bukan rahasia. Kontrol pengeluaran di bawah inilah yang membatasi biaya.
Kontrol pengeluaran
Karena widget bersifat publik, biayanya dibatasi oleh limit yang hanya dapat Anda ubah:
| Kontrol | Lokasi | Efek |
|---|---|---|
| Batas pengeluaran harian untuk widget ini | Editor widget | Saat widget telah membelanjakan sebesar ini hari ini (UTC), widget berhenti sampai hari berikutnya: 429 widget_daily_limit. |
| Batas pengeluaran harian untuk semua widget | Settings, Widget controls | Satu batas untuk semua widget di akun. |
| Request per pengunjung per hari | Settings, Widget controls | Dihitung per IP pengunjung, untuk setiap widget. Default 100: 429 visitor_daily_limit. |
| Request per pengunjung per menit | Tetap | 10 per menit per pengunjung: 429 rate_limited. |
| Laju widget | Paket Anda | Semua pengunjung satu widget berbagi request per menit dari paket Anda. |
Saldo Anda adalah batas terakhir: pada $0 setiap widget mengembalikan 402 insufficient_balance sampai Anda menambah dana.
Kesehatan dan peringatan
Daftar widget menampilkan kapan setiap widget terakhir dipakai, pengeluaran dan request hari ini, serta error terakhir ketika widget gagal karena alasan yang bisa Anda perbaiki: saldo kosong, model yang dihapus, batas pengeluaran tercapai, atau situs yang tidak ada di daftar. Dengan Email me when a widget fails aktif (Settings, Widget controls), Anda mendapat paling banyak satu email per widget per hari.
Usage menampilkan request widget beserta nama widget dan situs asalnya; kelompokkan menurut By widget atau By site untuk membandingkannya.
Yang dilihat pengunjung
- Jawaban chat mengalir masuk dan mendukung pemformatan dasar (paragraf, daftar, tebal, miring, kode, dan tautan). Percakapan tetap ada selama pengunjung berpindah antar halaman di tab yang sama.
- Tombol Stop mengakhiri jawaban panjang; setelah error, tautan Try again mengirim ulang pesan.
- Gambar, audio, dan video disertai tautan Download. Video dibuat sebagai job latar belakang dan muncul saat siap, biasanya dalam beberapa menit.
- Pengunjung tidak pernah melihat instruksi Anda, saldo Anda, atau error mentah model. Mereka melihat pesan error Anda (atau default netral) dan penyebabnya ditampilkan kepada Anda di dashboard.
- Teks yang Anda kosongkan memakai default dalam bahasa akun Anda.