Hvernig á að búa til 100 orðasafnspakka í runu með 2Slides API (Efnisverksmiðjuhandbók fyrir 2026)

Þegar þú hefur staðfest handvirka vinnuflæðið — búa til einn orðasafnspakka, tala hann inn, flytja út eignirnar — er næsta flöskuháls umfangið. Tungumálaskóli með 12 stig og 30 vikuleg þemu þarf 360 pakka á ári. Andlitslaus TikTok rás sem birtir daglega þarf 365 pakka auk afbrigða hlutfalla. Efnisteymi hjá EdTech fyrirtæki þarf hundruð pakka flokkaða eftir L1/L2 pörum.

Þú byggir ekki 360 pakka handvirkt. Þú byggir efnisverksmiðju.

Þessi leiðarvísir er hagnýt 2026 handbók fyrir runugerð orðasafnspakka (og hvers kyns annars glæruvefnaðar) með 2Slides API. Mikilvægasta byggingarákvörðunin — og sú sem oftast fer úrskeiðis — er að velja réttan myndunarvef.

Veldu réttan endapunkt fyrst (hér bresta flestar verksmiðjur)

2Slides útvegar tvær aðskildar myndagerðarleiðir í gegnum API. Aðeins önnur þeirra framleiðir kynningar sem síðan er hægt að bæta við tali.

Fyrir orðaforðaspjalda-efnisverksmiðju með tali og hægt að flytja út hljóð, notaðu

(eða

create-like-this

ef þú ert með viðmiðunarútlit). Ekki nota — það er Fast PPT endapunkturinn og þú getur ekki bætt við tali á hann.

Ef verksmiðjan þín þarf bara hljóðlausan PPTX (ekkert hljóð, ekkert myndband), þá er Fast PPT í gegnum

ódýrasta leiðin. Restina af þessari handbók gerir ráð fyrir talvinnuflæðinu.

Arkitektúrinn í einu skýringarmynd

[Upprunagögn]            [Stjórnkerfi]                    [2Slides API]                    [Úttök]
    │                          │                               │                              │
 orðalisti   ──fyrirspurn─▶  Verkröð   ──POST──▶  /api/v1/slides/create-pdf-slides ──▶   jobId (UUID)
 töflureikni (Cron/script)                                     │                              │
    │                          │                               │                              │
                           Könnun  ──GET──▶  /api/v1/jobs/{jobId} ◀─────────────────────────────┘
                           á 20-30s        staða: árangur                                     │
                                                              │                                ▼
                                                              │             [síður glærur PNG · downloadUrl PDF]
                                                              │
                                                              ▶  POST /api/v1/slides/generate-narration
                                                              │  (jobId, raddsækni, hamur, o.s.frv.) — eingöngu async
                                                              │
                                                           Könnun  ──GET──▶  /api/v1/jobs/{jobId}
                                                           skilaboð: "Voice narration generation in progress" → árangur
                                                              │
                                                              ▶  POST /api/v1/slides/download-slides-pages-voices
                                                              │  (ókeypis; skilar ZIP)
                                                              ▼
                                                  pages/*.png + voices/*.{wav,mp3} + transcript.txt
                                                              │
                                                              ▼
                                                   (Valfrjálst) setja saman MP4 á biðlaramegin
                                                   með FFmpeg, eða nota Workspace UI
                                                              │
                                                              ▼
                                                   [LMS / TikTok / fréttabréf / S3]

Uppbygging og API flæði

Gagnagjafi → skipuleggjandi → API → ZIP með síðum + raddskrám → dreifing. MP4 samsetningu er valfrjáls og er ekki opinbert API endapunktur frá og með 2026 — það er Workspace UI eiginleiki sem notar FFmpeg.wasm í vafranum. API jafngildið er síður-og-raddir ZIP skráin, sem þú getur sett saman með

á netþjóni ef þú þarft MP4 í framleiðslunni.

Skref 1 — Hannaðu upprunasamskiptin fyrst

Eina áhrifamesta ráðstöfunin er að skilgreina gagnaskema upprunans áður en API-köll eru gerð. Stokkar sem byggðir eru úr hreinu skema eru endurgerðarhæfir; stokkar sem byggðir eru úr tilfallandi fyrirmælum eru það ekki.

Orðasafns-stokkur upprunaröð sem hentar vel:

deck_id: vocab-b1-travel-2026-w14
source_l1: en          # móðurmál nemandans
target_l2: es          # tungumál sem verið er að læra
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" }
  # ... 27 til viðbótar
generation:
  endpoint: create-pdf-slides
  aspect_ratio: "9:16"      # lóðrétt fyrir stutta endurskoðun
  resolution: "2K"
  page_count: 30
  content_detail: "concise"
narration:
  enabled: true
  voice: "Puck"             # sjá /tts_sample_voices fyrir skrána
  mode: "single"
distribution:
  social: [tiktok, reels, shorts]
  newsletter: monday-2026-w14

Þetta hlutur er vinnu-einingin. Allt niðurstreymi notar það.

Byggðu upprunaskemað í því sem þú hefur nú þegar

Byggðu upprunaskemað í því sem þú hefur nú þegar: Google Sheet fyrir ótæknilega teymi, Postgres töflu fyrir verkfræðiteymi, CMS með skipulögðum reitum fyrir efnishópa. Forðastu að byggja það í venjulegum Markdown skrám — Markdown er ágætt fyrir mannlega ritun en slæmt fyrir runusjálfvirkni.

Skref 2 — Auðkenning

Fáðu API lykil af API stjórnunarsíðunni. Sniðið er:

sk-2slides-{64-stafa-hex-strengur}

Allar beiðnir nota bearer auðkenningu:

Authorization: Bearer sk-2slides-...

Takmörk á hverja endastöð fyrir sig eru skjalfest á 2slides.com/api.md. Fyrir magnframleiðslu:

• create-pdf-slides
  og
  create-like-this
  : hannaðu biðröðina þína í kringum samhliða takmörk þeirra með veldislegri afturför við 429
• jobs/{id}
  (könnun): virtu könnunartíðnina hér að neðan — 20–30s, ekki árásargjarn
• download-slides-pages-voices
  : ókeypis og hraðvirkari, en samt með takmörkunum

Skref 3 — Sendu inn Nano Banana myndunarverk

Orðaspjöld virka best í ósamstilltri stillingu (myndmyndun fyrir hvert spjald tekur 1–3 mínútur fyrir 30 spjalda stokkinn).

curl -X POST "https://2slides.com/api/v1/slides/create-pdf-slides" \
  -H "Authorization: Bearer sk-2slides-..." \
  -H "Content-Type: application/json" \
  -d '{
    "userInput": "<stokkslaga fyrirmæli þín — sjá Skref 4>",
    "responseLanguage": "en",
    "aspectRatio": "9:16",
    "resolution": "2K",
    "page": 30,
    "contentDetail": "concise",
    "mode": "async"
  }'

Svarið inniheldur

(UUID). Spyrstu um stöðu:

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

Spurningstíðni: á 20–30 sekúndna fresti. Ekki spyrja oftar — API skjölin nefna þetta sérstaklega og árásargjarn spurnir eru algengasta orsök 429 villu. Flestir stokkar ljúka á 1–3 mínútum.

Þegar

, hefur verkið spjaldmyndir geymdar á R2 og fyrir PDF samantekt. Spjaldmyndirnar sjálfar eru það sem þú munt síðar sameina hljóði.

Skref 4 — Búðu til sniðmát fyrir leiðbeiningar sem standast tímans tönn

Stærsti munurinn á óáreiðanlegri verksmiðju og áreiðanlegri er sniðmát fyrir leiðbeiningar. Ekki skrifa leiðbeiningar við keyrslu fyrir hverja kynningu. Skilgreindu sniðmát fyrir hverja tegund kynningar og skiptu út gildum.

Sniðmát fyrir orðaforðakynningu (

):

Búðu til orðaforðakynningu á {{cefr_level}}-stigi fyrir nemendur sem tala {{source_l1}}
og læra {{target_l2}}. Þema: {{theme}}.

Fjöldi spjalda: {{word_count}}.

Fyrir hvert spjald, skrifaðu nákvæmlega:
- Markorð (á {{target_l2}})
- Orðflokkur
- IPA hljóðritunarsnið
- Þýðing á {{source_l1}}
- Tvær dæmissetningar í náttúrulegu {{theme}} samhengi, B1 setningagerð, 8–14 orð hver

Orð til að hafa með:
{{word_list_yaml}}

Lokaðu á 3 spjalda upprifjun á 3 nýtustu orðunum úr kynningu.

Sjónrænt útlit er stýrt af

færibreytunni (sérsniðin leiðbeining) eða skilið eftir við sjálfgefna stillingu („hreint upplýsingagrafík, engar ljósmyndir, jafnvæg leturgerð"). Haltu leiðbeiningunum í útgáfustýringu í git. Þegar leiðbeining breytist, skráðu útgáfuna með hverri tilbúinni kynningu svo þú getir tengt gæðahnignun við breytingar á leiðbeiningum.

Skref 5 — Bæta við raddlestri

Þegar útbúningsvinnið er

, ræstu raddlestur. Raddlestur er einungis ósamstilltur og vinnur á 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
  }'

Könnuðu síðan sama

þar til skilaboðin breytast úr "Voice narration generation in progress" í árangursríkt ástand.

Tvö raddmynstur virka vel fyrir orðasafnsspjöld:

• mode: "single"
  með einni rödd — einfaldur lestur á orði + IPA + setning
• mode: "multi"
  með tveimur röddum — dæmasetningar skipt á milli raddlestara, tilvalið fyrir sagnir og orðasambönd

Raddlistinn er gefinn út á

. Algengar ráðleggingar eru , , , . Staðfestu stuðning með nýjustu API skjölunum áður en þú festir við tiltekna rödd í framleiðslu.

Mikilvægt: þetta eina endapunkt býr til bæði raddtexta og raddupptöku. Ekki hringja í aðskilin "voice text" og "voice audio" endapunkta — það er ekki til opinbert API fyrir þessi skref sjálfstætt. Stilltu raddlesturbeiðnina einu sinni og API gerir hvort tveggja.

Skref 6 — Flytja út síður og raddskrár (ókeypis)

Þegar talgervingu er lokið skaltu sækja allar skrár í einni ZIP skrá:

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"
  }'

Svarið inniheldur

(gildir í 1 klukkustund) fyrir ZIP skrá sem inniheldur:

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

Þessi útflutningur er ókeypis — engin inneign notuð. Sæktu ZIP skrána og geymdu skrárnar í þinni eigin gagnageymslu. Forundirrituð vefslóð rennur út eftir 1 klukkustund.

Skref 7 — (Valfrjálst) Setja saman MP4 á netþjóni

2Slides API býður ekki upp á MP4 samsetningartengingu eins og er — MP4 myndbandsgerð fer fram í vinnusvæðis viðmótinu með FFmpeg.wasm í vafranum. Fyrir efnisverksmiðju skaltu setja saman MP4 á netþjóni með

:

# Fyrir hverja síðu, búðu til klipp úr (stillimynd) + (raddupptöku).
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

# Tengdu alla klippin úr hverri síðu saman í endanlegt MP4.
ffmpeg -f concat -safe 0 -i clip_list.txt -c copy final.mp4

Hljóðtakturinn fyrir hverja síðu er sá sem frásagnarmyndarinn framleiddi — venjulega 5–12 sekúndur á hverja glæru fyrir orðaforðaspjöld. Niðurstaðan er sama MP4 sem notandi myndi sækja úr vinnusvæðis viðmótinu, en framleitt án höfuðs í verksmiðjuleiðinni þinni.

Ef þú vilt lóðrétta (9:16) og lárétta (16:9) afbrigði af sömu glærum, þá er hreinasta leiðin að búa til glærurnar tvisvar með mismunandi hlutföllum á glærusköpunarstiginu (

á móti ). FFmpeg skerðing eftir á leiðir oft til ljótra niðurstaðna vegna þess að glærurnar voru uppsettar fyrir tiltekið hlutfall.

Skref 8 — Byggja stjórnkerfið

Lágmarks stjórnkerfi sér um fimm lykkjur:

# Gerviforrit

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

    # 1. Búa til glærur í gegnum Nano Banana endapunkt
    job = post("/api/v1/slides/create-pdf-slides", body=build_payload(deck))
    deck_artifact = poll_until_complete(job.data.jobId)

    # 2. Búa til raddleiðsögn (aðeins ósamstilltur)
    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. Flytja út síður + raddir ZIP (ókeypis)
    zip_url = post("/api/v1/slides/download-slides-pages-voices",
                   body={"jobId": deck_artifact.id})

    # 4. Hlaða niður og vista efni í geymsluþjónustu
    download_to_s3(zip_url, deck.id)

    # 5. (Valkvætt) setja saman MP4 með ffmpeg, dreifa síðan
    if deck.distribution.social:
        compose_mp4(deck.id)
        distribute(deck)

Keyrðu þetta á vinnsluþjóni með röð. Fyrir 100 kynningar á dag dugar einn starfsmaður. Fyrir 1.000+, dreifðu á lítinn hóp starfsmanna — en gakktu úr skugga um að hópurinn virði takmörk hvers API endapunkts, ekki bara fjölda starfsmanna.

Skref 9 — Dreifingarmunstur

Dreifingarstigið breytir afurðum í viðskiptalegt gildi:

• LMS: hlaða upp samsettu MP4 í Canvas / Moodle / Blackboard / Google Classroom í gegnum viðkomandi API
• TikTok / Reels / Shorts: setja 9:16 MP4 í biðröð í birtingartæki (Buffer, Later, innbyggður tímasetjari), eitt á dag
• Fréttabréf: fella PDF-samantektina (frá
  downloadUrl
  upprunalegu framleiðsluvinnslunnar) inn sem niðurhalshlekkur í vikulegri útgáfu
• Sala / aðdráttargjafi: hlaða upp PDF á Stan Store / Gumroad síðu; snýstiskífa kynningin knýr umferð

Ekki reyna að finna upp dreifingu. Notaðu innfæddu API viðkomandi vettvangs og láttu skipulagnara þinn sleppa röð í tímasetjara þinn.

Kostnaðarútreikningur (hlutinn sem þarf að skipuleggja fyrst)

Fyrir Nano Banana kynningar með frásögn, inneignirnar safnast upp hraðar en Fast PPT verðlagningin sem sumir lesendur kunna að hafa séð áður. Útreikningurinn fyrir 30-korta kynningu (1K/2K upplausn, með frásögn):

• Skipulagning: 10 inneignir
• Myndgerð: 30 × 100 = 3.000 inneignir
• Frásögn (texti + hljóð): 30 × 210 = 6.300 inneignir
• Síður + raddir útflutningur: 0 inneignir (ókeypis)
• Alls: ~9.310 inneignir fyrir 30-korta kynningu með frásögn

Án frásagnar kostar sama kynningin ~3.010 inneignir. Við 4K upplausn, tvöfaldaðu myndgerðarhlutann: 30 × 200 = 6.000 → ~12.310 inneignir með frásögn.

Fyrir 100-kynninga/mánaðar verksmiðju: 100 × 9.310 = ~931.000 inneignir/mánuð. Berðu saman við verðlagningarsíðuna til að velja þrep — og fjárveita fyrir 4K aðeins þegar úttakið fer í samhengi sem nýtur góðs af því (stórir skjáir, hágæða myndbönd). Fyrir TikTok / Reels umsagnarmyndbönd er 1K eða 2K nægjanlegt.

Rekstrarmunstur sem koma í veg fyrir elda

Tvíþæring (Idempotency)

Sérhver deck-sending ætti að vera tvíþær á

. Ef starfsmaðurinn þinn frystar á miðri keyrslu, þarf endurræsing biðraðarinnar ekki að búa til tvíteknar decks. Hreinasta munstrið: geymdu í gagnagrunnslínu; umbreyttu stöðum ().

Gæðahliðir

Ekki sjálfvirkt dreifa. Áður en þú ýtir á TikTok eða Canvas, keyrðu véllæsilega gæðaathugun á niðurstöðunni:

• Fjöldi síðna passar við umbeðinn fjölda
• ZIP inniheldur væntanlegan fjölda
  pages/page_NN.png
  og
  voices/page_NN.wav
  skráa
• Hljóðlengd á hverja síðu er á milli 3 og 15 sekúndna (30 sekúndna spjald þýðir næstum alltaf hallósínerað langt handrit)
• transcript.txt
  er ekki tómt og inniheldur markmiðsorðin

Fyrir fyrstu 50 keyrslurnar skaltu einnig gera handvirka punktathugun á 1 af hverjum 10 decks. Fyrstu 50 keyrslurnar eru þar sem kerfisbundin leiðbeiningarvandamál koma upp.

Útgáfustýring

Sérhver niðurstaða geymir: útgáfu leiðbeiningasniðmáts, útgáfu myndlíkans (

vs ), frásagnarhljóð, framleiðslutímastimpil. Þegar líkanið batnar eða leiðbeiningar breytast geturðu endurkeyrð aðeins viðkomandi decks.

Kostnaðarmæling

Hverja endakostar hver framsetning? (sjá reikning hér að ofan). Fylgstu með kredit sem notuð eru fyrir hverja framsetningu. Þegar kreditnotkun fyrir hverja framsetningu tvöfaldast óvænt, þá hefur eitthvað breyst (fjöldi síðna aukist, endurtilraunir, skipt yfir í 4K). Finndu það áður en kreditreikningurinn kemur þér á óvart.

Meðhöndlun á bilun

Misheppnuð vinna er eðlileg — nettruflanir, hleðsla líkans, sjaldgæf 5xx villa. Reyndu aftur einu sinni eftir biðtíma. Eftir tvær bilanir, settu framsetninguna í

biðröð. Endurtaktu ekki í eilífð.

Byggja vs kaupa: hvenær á að nota API-ið yfirleitt

API-ið er rétta svarið þegar:

• Þú framleiðir >10 kynningar/viku
• Þú ert með skipulögð upprunagögn
• Þú þarft MP4 skrár með tali sem þú setur saman á netþjóni og dreifir
• Þú tengir við LMS, skipulagstól eða CMS
• Þú vilt endurtekjanleika undir útgáfustýringu á leiðbeiningum

API-ið er of flókið þegar:

• Þú framleiðir 1 kynningu á viku og stillir sjónrænt í hvert skipti
• Þú ert nemandi að búa til kynningar til einkanáms (notendaviðmótið er hraðvirkara — og vinnusvæðið gerir einnig MP4 samsetninguna fyrir þig)
• Þú ert kennari að búa til eina kynningu fyrir hverja kennslustund (notaðu Create Slides from File eða Create Slides Like This og slepptu skipulagningu)

Algengar spurningar

Hvar fæ ég API-lykil?

2slides.com/api. Lyklar eru í API-stjórnunarfliðanum.

Af hverju get ég ekki bætt talmáli við

/api/v1/slides/generate

verk?

endapunkturinn er Fast PPT — sniðmátsdrifin PPTX. Úttakið er lokið .pptx skrá, ekki glærumynd-plús-texta verk sem talmálsmyndunin getur lesið. Talmálsmyndunin tekur aðeins við verkum frá eða , sem búa til nano banana glæruverkefni með skipulagðu efni fyrir hverja síðu.

Get ég flutt út MP4 beint úr API?

Nei, ekki frá og með 2026. MP4 útflutningur er eiginleiki í Workspace UI sem er útfærður á biðlarameðan með FFmpeg.wasm. Jafngildið í API er

sem skilar ZIP með glærumyndum, hljóðskrám og afriti — þú semur MP4 sjálfur með ef þú þarft það í efnisframleiðsluleiðslu. Sjá skref 7.

Hvaða tungumál styður API fyrir myndun?

22+ tungumál þar á meðal spænska, franska, þýska, arabíska, japanska, kóreska, hindí, víetnömsk, rússneska, pólska, ítölska, portúgalska, indónesíska, tælenska, tyrkneska og kínverska (einfölduð/hefðbundin). Sendu með

.

Hvað kostar þetta í inneignum?

Fyrir Nano Banana spil: 10 (áætlanagerð) + 100/skygnu við 1K/2K (eða 200/skygnu við 4K) fyrir skyggnumyndun, auk 210/síðu (10 texti + 200 hljóð) fyrir frásögn. Síðu- og raddútflutningur er ókeypis. 30 korta spil með frásögn við 2K er ~9.310 einingar. Sjá verðlagningarsíðuna og útreikningshlutann hér að ofan.

Hvernig fæ ég á móti 429 takmörkunum á hraða?

Veldisvísisbíð. Byrjaðu á 1s, tvöfaldaðu upp í 60s. Eftir þrjár samfelldur 429 villur skaltu hægja á samtímaverkþráðafjölda þínum um helming. Ekki skoða

oftar en á 20 sekúndna fresti — það er algengasta orsök 429.

Get ég samþætt við Zapier / Make / n8n?

Já — öll tól sem geta sent auðkennd HTTP fyrirspurnir geta keyrt 2Slides API. n8n er sérstaklega vinsælt fyrir efnisverksmiðjur vegna þess að það sér um skoðunar- og biðraðamynstur innbyggt.

Hvernig koma ég í veg fyrir að mynduð spil séu skráð opinberlega?

Spil sem mynduð eru í gegnum API eru sjálfgefið einkamál á reikningnum þínum. Opinber deiling er aðskilin skýr aðgerð.

Hvernig mynda ég lóðrétt (9:16) og lárétt (16:9) útgáfur af sama spilinu?

Myndaðu spilið tvisvar — einu sinni með

og einu sinni með . Skyggnum er raðað samkvæmt stærðarhlutfalli við myndun, svo klipping eftir á lítur sjaldan vel út. Já, þetta þýðir að tvöfalda einingakostnaðinn; það er vísvitandi málamiðlun fyrir hrein sjónræn gildi.

Niðurstaðan

Efnisverksmiðja er skipulögð upprunagögn + stöðugur stjórnandi + réttir API endapunktar. 2Slides API er þriðji hlutinn; þú berð ábyrgð á fyrstu tveimur. Algengasta bilunin í verksmiðjum er að nota

(Fast PPT) og reyna síðan að tala hana inn — sú leið er lokuð. Notaðu eða í staðinn, talaðu inn með , flyttu út með og settu saman MP4 á netþjóni með .

Fyrir handvirka hliðina á sama vinnuflæði, sjá leiðbeiningarnar um orðaforðaspjöld og leiðbeiningarnar um vinnuflæði höfunda. UI mynstrin þar eru sömu mynstrin og þú ert að gera sjálfvirk með API; að skilja handvirka flæðið fyrst gerir API samþættinguna mun hraðari.