Kuidas partiina luua 100 sõnavara esitlust 2Slides API-ga (Sisutootmise juhend 2026)

Kui olete käsitsi töövoo valideerinud — loonud ühe sõnavara esitluse, lisanud sellele jutustuse, eksportinud varad — on järgmine kitsaskoht maht. Keelekooli 12 taseme ja 30 nädalateemaga vajab aastas 360 esitlust. Igapäevaselt postitav faceless TikToki kanal vajab 365 esitlust pluss erinevad külgede suhted. EdTechi ettevõtte sisutootmismeeskond vajab sadu esitlusi, mis on segmenteeritud L1/L2 keeleparide järgi.

Te ei ehita 360 esitlust käsitsi. Te ehitate sisutootmise tehase.

See juhend on praktiline 2026. aasta käsiraamat sõnavara esitluste (ja mis tahes muu slaidisisu) partiina loomiseks 2Slides API-ga. Kõige olulisem arhitektuuriline otsus — ja see, mida kõige sagedamini valesti tehakse — on õige loomise lõpp-punkti valimine.

Valige kõigepealt õige endpoint (siin enamik tehaseid ebaõnnestub)

2Slides pakub API kaudu kahte erinevat genereerimisvoolu. Ainult ühele neist on võimalik hiljem lisada jutustust.

Sõnavara-kaartide sisutehase jaoks koos jutustuse ja eksporditava heliga kasutage

(või

create-like-this

, kui teil on võrdluspaigutus). Ärge kasutage — see on Fast PPT endpoint ja te ei saa sellele jutustust lisada.

Kui teie tehas vajab ainult hääletut PPTX-i (ilma heli või videota), on Fast PPT kaudu

kõige odavam tee. Ülejäänud juhend eeldab jutustusega töövoogu.

Arhitektuur ühel diagrammil

[Lähteandmed]            [Orkestrator]                    [2Slides API]                    [Väljundid]
    │                          │                               │                              │
 sõnavara   ──päring──▶  Tööde järjekord  ──POST──▶  /api/v1/slides/create-pdf-slides ──▶   jobId (UUID)
 tabelarvutus (Cron/skript)                                    │                              │
    │                          │                               │                              │
                           Poll  ──GET──▶  /api/v1/jobs/{jobId} ◀─────────────────────────────┘
                           iga 20-30s     staatus: edukas                                     │
                                                              │                                ▼
                                                              │             [slaidide lehed PNG · allalaadimine URL PDF]
                                                              │
                                                              ▶  POST /api/v1/slides/generate-narration
                                                              │  (jobId, hääl, režiim jne) — ainult asünkroonne
                                                              │
                                                           Poll  ──GET──▶  /api/v1/jobs/{jobId}
                                                           teade: "Häälnarratsioon genereeritakse" → edukas
                                                              │
                                                              ▶  POST /api/v1/slides/download-slides-pages-voices
                                                              │  (tasuta; tagastab ZIP)
                                                              ▼
                                                  pages/*.png + voices/*.{wav,mp3} + transcript.txt
                                                              │
                                                              ▼
                                                   (Valikuline) koosta MP4 kliendipoolselt
                                                   FFmpeg abil või kasuta Workspace UI-d
                                                              │
                                                              ▼
                                                   [LMS / TikTok / uudiskiri / S3]

Arhitektuur ja Andmevoog

Allikandmed → orkestrator → API → lehekülgede ja häälte ZIP → levitamine. MP4 koostamine on valikuline ja ei ole avalik API lõpp-punkt 2026. aasta seisuga — see on Workspace UI funktsioon, mis kasutab brauseris FFmpeg.wasm-i. API ekvivalent on lehekülgede-ja-häälte ZIP, mille saate koostada

-iga serveri poolel, kui vajate MP4-d tehases.

1. samm — Kujunda kõigepealt lähteandmete skeem

Kõige suurema mõjuga tegevus on lähteandmete skeemi määratlemine enne mis tahes API väljakutset. Puhtast skeemist loodud esitlused on korduvkasutatavad; juhuslikest päingutest loodud esitlused ei ole.

Skaleeruv sõnavara-esitluse lähterea:

deck_id: vocab-b1-travel-2026-w14
source_l1: en          # õppija emakeel
target_l2: es          # õpitav keel
cefr_level: B1
theme: travel
words:
  - { word: "boarding pass", ipa: "/ˈbɔːrdɪŋ pæs/", pos: noun, l1: "tarjeta de embarque" }
  - { word: "layover",       ipa: "/ˈleɪoʊvər/",     pos: noun, l1: "escala" }
  - { word: "to delay",      ipa: "/dɪˈleɪ/",         pos: verb, l1: "retrasar" }
  # ... veel 27
generation:
  endpoint: create-pdf-slides
  aspect_ratio: "9:16"      # vertikaalne lühivormiliseks kordamiseks
  resolution: "2K"
  page_count: 30
  content_detail: "concise"
narration:
  enabled: true
  voice: "Puck"             # vaata kataloogist /tts_sample_voices
  mode: "single"
distribution:
  social: [tiktok, reels, shorts]
  newsletter: monday-2026-w14

See objekt on tööühik. Kõik järgnev töötleb seda.

Ehitage lähteskeem sellesse, mis teil juba on

Kasutage sobivat alust lähteskeemi loomiseks:

• Google Sheet — mittetehniliste meeskondade jaoks
• Postgres tabel — arendusmeeskondade jaoks
• CMS struktureeritud väljadega — sisumeeskondade jaoks

Vältige lähteskeemi loomist tavalistesse Markdown-failidesse — Markdown sobib inimeste kirjutamiseks, kuid on halb partiiautomatiseerimiseks.

---

Miks vältida Markdown-faile automatiseerimiseks?

Kuigi Markdown on suurepärane inimloetavuse jaoks, puuduvad sellel automatiseerimiseks vajalikud omadused:

• Puuduv struktureeritus — andmete parsimiseks pole ühest standardit
• Vigade tekkevõimalus — vormindusvigu on raske tuvastada programmaatiliselt
• Raske valideerida — ei saa hõlpsalt jõustada kohustuslikke välju või andmetüüpe
• Skaleeritavusprobleemid — suure hulga kirjete haldamine muutub kohmakaks

Soovitatavad alternatiivid

Mittetehnilised meeskonnad: Google Sheets

Lihtne kasutada, võimaldab koostööd ja toetab lihtsat automatiseerimist API kaudu.

Arendusmeeskonnad: Postgres

Täielik andmebaasi funktsinaalsus, tugevad andmetüübid ja lihtne integratsioon automatiseerimistööriistadega.

Sisumeeskonnad: CMS struktureeritud väljadega

Sisuhaldussüsteemid nagu Contentful, Strapi või Sanity pakuvad struktureeritud sisestust ja API juurdepääsu.

Samm 2 — Autentimine

Hankige API võti API halduse lehelt. Vorming on:

sk-2slides-{64-tähemärgiline-hex-string}

Kõik päringud kasutavad bearer autentimist:

Authorization: Bearer sk-2slides-...

Igale lõpp-punktile kehtivad kiiruspiirangud on dokumenteeritud aadressil 2slides.com/api.md. Partii tootmise jaoks:

• create-pdf-slides
  ja
  create-like-this
  : kujundage oma järjekord nende samaaegse töötlemise piirangute ümber, kasutades eksponentsiaalset taganemist 429 korral
• jobs/{id}
  (päring): järgige allolevat päringu sagedust — 20–30s, mitte agressiivne
• download-slides-pages-voices
  : tasuta ja kiirem, kuid endiselt kiiruspiiranguga

Samm 3 — Esita Nano Banana genereerimistöö

Sõnakaardid toimivad kõige paremini asünkroonses režiimis (slaidipõhine pildigeneerimine võtab 30-kaardilise pakiga 1–3 minutit).

curl -X POST "https://2slides.com/api/v1/slides/create-pdf-slides" \
  -H "Authorization: Bearer sk-2slides-..." \
  -H "Content-Type: application/json" \
  -d '{
    "userInput": "<sinu esitluskujuline päring — vaata Samm 4>",
    "responseLanguage": "en",
    "aspectRatio": "9:16",
    "resolution": "2K",
    "page": 30,
    "contentDetail": "concise",
    "mode": "async"
  }'

Vastus sisaldab

(UUID). Küsi valmimise kohta regulaarselt:

curl -X GET "https://2slides.com/api/v1/jobs/{jobId}" \
  -H "Authorization: Bearer sk-2slides-..."

Küsimise sagedus: iga 20–30 sekundi järel. Ära küsi sagedamini — API dokumentatsioon mainib seda selgesõnaliselt ja agressiivne küsimine on kõige levinum 429 vigade põhjus. Enamik esitlusi valmib 1–3 minutiga.

Kui

, on töö slaidipildid salvestatud R2-le ja saadaval on PDF-kompilatsiooni jaoks. Slaidipildid ise on need, mida hiljem helega kombineerid.

Samm 4 — Ehita mastaapsed prompti mallid

Üks suurimaid erinevusi hapra tehase ja usaldusväärse vahel on prompti mallid. Ära kirjuta prompte käitusajal iga esitluse jaoks. Määratle mall iga esitluse tüübi kohta ja asenda väärtused.

Sõnavara esitluse mall (

):

Loo {{cefr_level}}-taseme sõnavara esitlus {{source_l1}}-keelsetele 
{{target_l2}}-keele õppijatele. Teema: {{theme}}.

Kaartide arv: {{word_count}}.

Iga kaardi kohta väljasta täpselt:
- Sihtkeele sõna ({{target_l2}}-keeles)
- Sõnaliik
- IPA transkriptsioon
- Tõlge {{source_l1}}-keeles
- Kaks näitelauset loomulikku {{theme}} kontekstis, B1 süntaksiga, 8–14 sõna kummaski

Kaasatavad sõnad:
{{word_list_yaml}}

Lõpeta 3-kaardilise kokkuvõttega kolmest kasulikumast sõnast esitluses.

Visuaalset stiili juhitakse parameetriga

(kohandatud prompt) või jäetakse vaikimisi seadistusele ("puhas infograafika, ilma fotodeta, tasakaalustatud tüpograafia"). Hoia prompte versioonihallatuna git'is. Kui prompt muutub, logi versioon iga loodud esitlusega, et saaksid seostada kvaliteedi halvenemist prompti muudatustega.

Samm 5 — Lisa jutustus

Kui genereerimistöö olek on

, käivita jutustus. Jutustus töötab ainult asünkroonselt ja kasutab sama :

curl -X POST "https://2slides.com/api/v1/slides/generate-narration" \
  -H "Authorization: Bearer sk-2slides-..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "mode": "single",
    "voice": "Puck",
    "speakerName": "Vocabulary Coach",
    "contentMode": "concise",
    "includeIntro": true
  }'

Seejärel küsitle sama

lõpp-punkti, kuni teade muutub olekust "Voice narration generation in progress" eduseisundisse.

Sõnavara kaartide jaoks sobivad hästi kaks häälmustrit:

• mode: "single"
  ühe häälega — sirgjooneline sõna + IPA + lause lugemine
• mode: "multi"
  kahe häälega — näitelaused jagatud kõnelejate vahel, ideaalne tegusõnadele ja kõnekäändudele

Häälte kataloog on avaldatud aadressil

. Tavalised valikud hõlmavad , , , . Kinnita toetust viimaste API dokumentidega enne konkreetse hääle fikseerimist tootmises.

Oluline: see üks lõpp-punkt genereerib nii häälteksti kui ka hääleaudio. Ära kutsu eraldi "voice text" ja "voice audio" lõpp-punkte — nende sammude jaoks ei ole avalikku API-t eraldiseisvalt. Konfigureeri jutustuse päring üks kord ja API teeb mõlemad.

Samm 6 — Ekspordi slaidid ja hääled (tasuta)

Kui jutustamine on lõpule jõudnud, lae alla kõik failid ühes ZIP-arhiivina:

curl -X POST "https://2slides.com/api/v1/slides/download-slides-pages-voices" \
  -H "Authorization: Bearer sk-2slides-..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobId": "550e8400-e29b-41d4-a716-446655440000"
  }'

Vastus sisaldab

linki (kehtib 1 tund) ZIP-arhiivile, mis sisaldab:

pages/
  page_01.png
  page_02.png
  ...
voices/
  page_01.wav
  page_02.wav
  ...
transcript.txt

See eksport on tasuta — krediite ei kulutata. Laadi ZIP-arhiiv alla ja salvesta failid oma objektisalvestusse. Eelallkirjastatud URL aegub 1 tunni pärast.

Samm 7 — (Valikuline) MP4 koostamine serveripoolel

2Slides API ei paku hetkel MP4 koostamise otspunkti — MP4 genereerimine toimub Workspace UI-s brauseri kaudu FFmpeg.wasm abil. Sisutehase jaoks koosta MP4 serveripoolel

abil:

# Iga lehe jaoks loo klipp (pildist) + (hääle helifailist).
ffmpeg -loop 1 -i pages/page_01.png -i voices/page_01.wav \
       -c:v libx264 -tune stillimage -c:a aac -b:a 192k \
       -pix_fmt yuv420p -shortest clips/page_01.mp4

# Liida kõik lehekohtased klipid üheks lõplikuks MP4 failiks.
ffmpeg -f concat -safe 0 -i clip_list.txt -c copy final.mp4

Helikadents lehe kohta on selline, nagu jutustuse generaator tootis — tavaliselt 5–12 sekundit slaidil sõnavara kaartide puhul. Tulemus on sama MP4, mida kasutaja Workspace UI-st alla laadiks, kuid toodetud pealauseta tehase torujuhtmes.

Kui soovid sama esitluse vertikaalseid (9:16) ja horisontaalseid (16:9) variante, on puhtaim tee genereerida esitlus kaks korda erinevate kuvasuhete korral slaidide genereerimise etapis (

vs ). FFmpeg kärpimine tagantjärele annab sageli inetuid tulemusi, sest slaidid olid paigutatud konkreetsele kuvasuhtele.

Samm 8 — Orkestreerimisloogika ehitamine

Minimaalne orkesteerija haldab viit tsüklit:

# Pseudokood

while there_is_work():
    deck = pull_one_pending_deck_from_source()
    if not deck:
        sleep(60); continue

    # 1. Genereeri slaidid Nano Banana API kaudu
    job = post("/api/v1/slides/create-pdf-slides", body=build_payload(deck))
    deck_artifact = poll_until_complete(job.data.jobId)

    # 2. Jutusta (ainult asünkroonselt)
    if deck.narration.enabled:
        post("/api/v1/slides/generate-narration", body={
            "jobId": deck_artifact.id,
            "voice": deck.narration.voice,
            "mode": deck.narration.mode,
        })
        poll_until_narration_complete(deck_artifact.id)

    # 3. Ekspordi lehed + hääled ZIP-ina (tasuta)
    zip_url = post("/api/v1/slides/download-slides-pages-voices",
                   body={"jobId": deck_artifact.id})

    # 4. Lae alla ja salvesta failid oma objektihoidlasse
    download_to_s3(zip_url, deck.id)

    # 5. (Valikuline) koosta MP4 ffmpeg abil, seejärel levita
    if deck.distribution.social:
        compose_mp4(deck.id)
        distribute(deck)

Käivita see töötleja masinas koos järjekorraga. 100 esitluse jaoks päevas piisab ühest töötlejast. 1000+ puhul jaota väikeseks töötlejate parveKS — kuid veendu, et parvs arvestatakse iga API otspunkti kiiruslimiitidega, mitte ainult töötlejate arvuga.

Samm 9 — Levitamismustrid

Levitamiskiht muudab artefaktid ärilisel väärtusel:

• LMS: laadi komponeeritud MP4 üles Canvas'i / Moodle'i / Blackboard'i / Google Classroom'i nende vastavate API-de kaudu
• TikTok / Reels / Shorts: järjekorda 9:16 MP4 postitamisvahendisse (Buffer, Later, natiivne ajastaja), üks päevas
• Uudiskiri: põimi PDF-i kompileerimine (algse genereerimistöö
  downloadUrl
  -ist) allalaadimislingina nädala numbris
• Müük / lead magnet: laadi PDF Stan Store'i / Gumroad'i lehele; karusellteaser suunab liiklust

Ära püüa levitamist leiutada. Kasuta platvormi natiivseid API-sid ja lase oma orkestratsioonil lisada rida oma ajastajasse.

Kulude matemaatika (osa, millega alustada planeerimist)

Nano Banana esitluste puhul koos jutustusega kogunevad krediidid kiiremini kui mõned lugejad on võinud näha Fast PPT hinnakirjas. Matemaatika 30-kaardilise esitluse kohta (1K/2K resolutsioon, koos jutustusega):

• Planeerimine: 10 krediiti
• Slaidide genereerimine: 30 × 100 = 3 000 krediiti
• Jutustus (tekst + heli): 30 × 210 = 6 300 krediiti
• Lehekülgede + häälte eksport: 0 krediiti (tasuta)
• Kokku: ~9 310 krediiti jutustusega 30-kaardilise esitluse kohta

Ilma jutustuseta on sama esitlus ~3 010 krediiti. 4K resolutsiooni puhul kahekordistub slaidide genereerimise osa: 30 × 200 = 6 000 → ~12 310 krediiti koos jutustusega.

100 esitluse/kuu tootmise puhul: 100 × 9 310 = ~931 000 krediiti/kuus. Võrdle hinnakirja lehega, et valida sobiv pakett — ja eelarvestada 4K ainult siis, kui väljund läheb konteksti, mis sellest kasu saab (suured ekraanid, premium video). TikTok / Reels ülevaatevideote jaoks piisab 1K või 2K resolutsioonist.

Operatsioonimustrid, mis ennetavad põlenguid

Idempotentsus

Iga kaardi esitamine peaks olema idempotentne

põhiselt. Kui teie töötleja katkeb keskel pakktöötlust, järjekorra taaskäivitamine ei tohi luua duplikaatkaarte. Kõige puhtam muster: salvestage andmebaasi ritta; hallake olekuüleminekuid ().

Kvaliteediväravad

Ärge jagage automaatselt. Enne TikToki või Canvase laadimist tehke artefaktil läbi masinloetav kvaliteedikontroll:

• Lehekülgede arv vastab taotletud arvule
• ZIP sisaldab oodatud arvu
  pages/page_NN.png
  ja
  voices/page_NN.wav
  faile
• Helipikkus lehe kohta on vahemikus 3–15 sekundit (30-sekundiline kaart tähendab peaaegu alati hallutsineeritud pikka skripti)
• transcript.txt
  ei ole tühi ja sisaldab sihtsõnu

Esimese 50 partii puhul tehke lisaks manuaalne punktkontroll igale 10. kaardile. Esimeste 50 partiiga tulevad esile süsteemsed viipade probleemid.

Versioonihaldus

Iga artefakt salvestab: viipe malli versiooni, pildi mudeli versiooni (

vs ), jutustamise hääle, genereerimise ajatempli. Kui mudel paraneb või viip muutub, saate uuesti käivitada ainult mõjutatud kaarte.

Kulude telemeetria

Igal esitlusel on teadaolev krediidikulu (vaata ülaltoodud matemaatikat). Jälgi iga esitluse kohta tarbitud krediite. Kui krediidikasutus esitluse kohta kahekordistub ootamatult, on midagi muutunud (lehekülgede arvu triivimine, korduskatsed, üleminek 4K-le). Leia see enne, kui krediidiarve tuleb üllatusena.

Vigade käsitlemine

Ebaõnnestunud töö on normaalne – võrgukatkemine, mudeli laadimine, harv 5xx viga. Proovi üks kord uuesti pärast ootamist. Pärast kaht ebaõnnestumist suuna esitlus

järjekorda. Ära korralda lõpmatut tsüklit.

Ehitamine vs ostmine: millal API-d üldse kasutada

API on õige valik, kui:

• Toodad >10 esitlust nädalas
• Sul on struktureeritud lähteandmed
• Vajad jutustatud MP4-sid, mida koostad serveripoolselt ja levitad
• Integreerid LMS-i, planeerijaga või CMS-iga
• Soovid taasesitatavust kohtade versioonide all

API on liigne, kui:

• Toodad 1 esitluse nädalas ja viimistled visuaalselt iga kord
• Oled õppija, kes loob esitlusi isiklikuks õppimiseks (UI on kiirem — ja Workspace UI teeb ka MP4 koostamise sinu eest)
• Oled õpetaja, kes loob ühe esitluse tunni kohta (kasuta Create Slides from File või Create Slides Like This ja jäta orkestratsioon vahele)

Korduma Kippuvad Küsimused

Kust ma saan API võtme?

2slides.com/api. Võtmed asuvad API halduse vahekaardil.

Miks ma ei saa lisada jutustust

/api/v1/slides/generate

tööle?

lõpp-punkt on Fast PPT — mallipõhine PPTX. Selle väljund on lõpetatud .pptx fail, mitte slaidipilt-pluss-tekst töö, mida jutustuse generaator saab lugeda. Jutustuse generaator aktsepteerib ainult töid või lõpp-punktidest, mis toodavad nano banana slaidide töid struktureeritud lehekülje-põhise sisuga.

Kas ma saan eksportida MP4 otse API-st?

Ei, mitte 2026. aasta seisuga. MP4 eksport on Workspace kasutajaliidese funktsioon, mis on implementeeritud kliendipoolselt FFmpeg.wasm-iga. API ekvivalent on

, mis tagastab ZIP-faili slaidipiltidega, helifailidega ja transkriptsiooniga — kui vajad seda sisutootmise töövoos, koosta MP4 ise -iga. Vaata samm 7.

Milliseid keeli API toetab genereerimiseks?

22+ keelt, sealhulgas hispaania, prantsuse, saksa, araabia, jaapani, korea, hindi, vietnami, vene, poola, itaalia, portugali, indoneesia, tai, türgi ja hiina keel (lihtsustatud/traditsiooniline). Edasta läbi

parameetri.

Kui palju maksab krediitides?

Nano Banana esitluste puhul: 10 (planeerimine) + 100/slaid 1K/2K puhul (või 200/slaid 4K puhul) slaidide genereerimiseks, pluss 210/lehekülg (10 tekst + 200 audio) jutustuse jaoks. Lehekülgede + häälte eksport on tasuta. 30-kaardiline jutustusega esitlus 2K juures on ~9 310 krediiti. Vaata hinnakirja lehte ja ülalpool toodud kulude arvutamise jaotist.

Kuidas käsitleda 429 piiranguid?

Eksponentsiaalne taganemisaeg. Alusta 1 sekundist, kahekordista kuni 60 sekundini. Pärast kolme järjestikust 429 viga vähenda oma üheaegsete töötajate arvu poole võrra. Ära küsitle

sagedamini kui iga 20 sekundi järel — see on 429 vea kõige tavalisem põhjus.

Kas saan integreerida Zapier / Make / n8n-iga?

Jah — iga tööriist, mis suudab teha autentitud HTTP päringuid, saab juhtida 2Slides API-d. n8n on eriti populaarne sisutootmisettevõtete seas, kuna see käsitleb küsitlemis- ja järjekorrmustreid sisemiselt.

Kuidas vältida genereeritud esitluste avalikku indekseerimist?

API kaudu genereeritud esitlused on vaikimisi sinu kontole privaatsed. Avalik jagamine on eraldi sihipärane tegevus.

Kuidas luua sama esitlusest vertikaalset (9:16) ja horisontaalset (16:9) versiooni?

Genereeri esitlus kaks korda — üks kord

ja üks kord seadistusega. Slaidid paigutatakse genereerimise ajal vastavalt külgsuhtele, seega järeltöötluses kärpimine harva näeb hea välja. Jah, see tähendab krediidikulu kahekordistamist; see on tahtlik kompromiss puhtate visuaalide nimel.

Kokkuvõte

Sisutööstus on struktureeritud lähteandmed + stabiilne orkestrator + õiged API lõpp-punktid. 2Slides API on kolmas element; esimese kahe eest vastutad sina. Kõige levinum tööstuse tõrge on

(Fast PPT) kasutamine ja seejärel katse seda jutustada — see tee on suletud. Kasuta selle asemel või , jutusta abil, ekspordi abil ja koosta MP4 serveripoolselt abil.

Sama töövoo käsitsi pooleks vaata sõnavara kaartide juhendit ja looja töövoo juhendit. UI mustrid seal on samad mustrid, mida automatiseerid API-ga; käsitsi töövoo esmane mõistmine muudab API integratsiooni märkimisväärselt kiiremaks.