api14
Skaffa API-nyckel

Vi använder cookies. Cookies och webbläsarlagring håller dig inloggad och kommer ihåg dina preferenser. Med ditt tillstånd mäter vi också hur webbplatsen används. Du kan när som helst. Läs vår cookiepolicy.

Videowidget

Widgetkod för video: så når videojobb i bakgrunden dina besökare

Videogenerering tar minuter, inte sekunder. Guiden förklarar vad som händer bakom videowidgetens kod, från första förfrågan till färdigt klipp, och vad besökarna ser under tiden.

Publicerad:

Ett chattsvar strömmas på några sekunder. En genererad video kan ta några minuter. Videowidgeten är byggd kring den skillnaden, så att dina besökare får en tydlig upplevelse och ditt konto förblir skyddat medan jobbet körs.

Samma kodrad

Alla widgettyper använder samma inbäddningskod:

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

Skillnaden finns på servern. När widgettypen är Video startar besökarens beskrivning ett jobb i stället för att ge ett resultat direkt.

Steg för steg

  1. Besökaren skickar en beskrivning. Förfrågan går till api14 med ditt widget-id. Servern kontrollerar att sidan finns bland dina tillåtna webbplatser, tillämpar dina gränser och startar jobbet med den modell du valt.
  2. Ett jobb-id skickas tillbaka. Widgeten visar att arbetet pågår. Jobb-id:t är knutet till din widget: en annan widget, eller någon som gissar id:n, kan inte läsa det.
  3. Widgeten kontrollerar statusen. Med några sekunders mellanrum frågar den om videon är klar. Dessa kontroller har en egen hastighetsgräns, skild från nya beskrivningar, så ett långt jobb förbrukar inte besökarens förfrågningskvot.
  4. Videon spelas upp. När jobbet är klart laddar widgeten ner klippet, spelar upp det och visar en Ladda ner-länk.

Om genereringen misslyckas ser besökaren ditt felmeddelande (eller ett neutralt standardmeddelande), och orsaken visas i din widgetlista så att du kan åtgärda den.

Det här styr du

  • Modellen: väljs under Widgets. Widgeten begär den längd som stöds och ligger närmast 5 sekunder och den upplösning som ligger närmast 720p, så kostnaden per klipp förblir förutsägbar.
  • API-nyckeln: varje widget körs under en av dina API-nycklar, som väljs i redigeraren. Listan slutar med Skapa ny API-nyckel. Jobben registreras under den nyckeln och dess gränser gäller.
  • Utseendet: rubrik, texter, accentfärg, tema, hörnradie och placering. Widgeten är white label.

Besökarna ser aldrig det som sker bakom kulisserna

Besökaren ser bara dina texter, förloppet och den färdiga videon. Dina instruktioner, ditt saldo, din API-nyckel och leverantörens råa felmeddelanden stannar på servern.

Övervakning

Widgetlistan visar senaste användning, dagens utgifter och senaste fel för varje widget. Användning grupperar förfrågningar per widget eller webbplats, och e-post vid fel informerar dig om problem som du kan åtgärda, till exempel ett tomt saldo eller en borttagen modell.

Läs mer om videomodeller i videodokumentationen och bygg din widget på widgetsidan.

Relaterade guider