Kod widżetu wideo: jak zadania wideo w tle docierają do odwiedzających

Odpowiedź czatu pojawia się w kilka sekund. Wygenerowanie wideo może zająć kilka minut. Widżet wideo jest zbudowany wokół tej różnicy, więc odwiedzający wiedzą, co się dzieje, a Twoje konto pozostaje chronione, gdy zadanie trwa.

Ta sama jedna linia kodu

Każdy typ widżetu używa tego samego kodu do osadzenia:

<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>

Różnica leży po stronie serwera. Gdy typ widżetu to Wideo, prompt odwiedzającego uruchamia zadanie zamiast od razu zwracać wynik.

Krok po kroku

1. Odwiedzający wysyła prompt. Żądanie trafia do api14 z identyfikatorem Twojego widżetu. Serwer sprawdza, czy strona znajduje się na liście dozwolonych stron, stosuje Twoje limity i uruchamia zadanie z wybranym przez Ciebie modelem.
2. Widżet otrzymuje identyfikator zadania. Widżet pokazuje stan pracy. Identyfikator zadania jest powiązany z Twoim widżetem: inny widżet ani nikt, kto zgaduje identyfikatory, nie może go odczytać.
3. Widżet sprawdza stan. Co kilka sekund pyta, czy wideo jest gotowe. Te sprawdzenia mają własny limit, niezależny od limitu nowych promptów, więc długie zadanie nie zużywa limitu żądań odwiedzającego.
4. Wideo się odtwarza. Gdy zadanie się zakończy, widżet pobiera klip, odtwarza go i pokazuje link Pobierz.

Jeśli generowanie się nie powiedzie, odwiedzający zobaczy Twój komunikat błędu (lub neutralny komunikat domyślny), a przyczyna pojawi się na Twojej liście widżetów, abyś mógł ją naprawić.

Co kontrolujesz

• Model: wybierany w sekcji Widżety. Widżet prosi o obsługiwaną długość najbliższą 5 sekundom i rozdzielczość najbliższą 720p, więc koszt klipu pozostaje przewidywalny.
• Klucz API: każdy widżet działa na jednym z Twoich kluczy API, wybranym w edytorze. Lista kończy się opcją Utwórz nowy klucz API. Zadania są rejestrowane na tym kluczu i obowiązują jego limity.
• Wygląd: tytuł, teksty, kolor akcentu, motyw, zaokrąglenie rogów i umiejscowienie. Widżet jest white label.

Odwiedzający nigdy nie widzą szczegółów technicznych

Odwiedzający widzi tylko Twoje teksty, stan postępu i gotowe wideo. Twoje instrukcje, saldo, klucz API i surowe błędy dostawcy pozostają na serwerze.

Monitorowanie

Lista widżetów pokazuje ostatnie użycie, dzisiejsze wydatki i ostatni błąd każdego widżetu. Sekcja Użycie grupuje żądania według widżetu lub strony, a e-maile o błędach informują o problemach, które możesz naprawić, takich jak puste saldo lub usunięty model.

Więcej o modelach wideo dowiesz się z dokumentacji wideo, a widżet zbudujesz na stronie widżetów.