Πώς να Δημιουργήσετε Μαζικά 100 Decks Λεξιλογίου με το 2Slides API (Οδηγός Εργοστασίου Περιεχομένου για το 2026)

Μόλις επικυρώσετε τη χειροκίνητη ροή εργασίας — δημιουργία ενός deck λεξιλογίου, αφήγηση, εξαγωγή των assets — το επόμενο σημείο συμφόρησης είναι ο όγκος. Ένα γλωσσικό σχολείο με 12 επίπεδα και 30 εβδομαδιαία θέματα χρειάζεται 360 decks το χρόνο. Ένα faceless κανάλι TikTok που δημοσιεύει καθημερινά χρειάζεται 365 decks συν τις παραλλαγές αναλογίας διαστάσεων. Μια ομάδα περιεχομένου σε μια εταιρεία EdTech χρειάζεται εκατοντάδες decks κατατμημένα ανά ζεύγη L1/L2.

Δεν χτίζετε 360 decks με το χέρι. Χτίζετε ένα εργοστάσιο περιεχομένου.

Αυτός ο οδηγός είναι ο πρακτικός οδηγός 2026 για μαζική δημιουργία decks λεξιλογίου (και οποιουδήποτε άλλου περιεχομένου διαφανειών) με το 2Slides API. Η μοναδική σημαντικότερη αρχιτεκτονική απόφαση — και αυτή που πιο συχνά γίνεται λάθος — είναι η επιλογή του σωστού endpoint δημιουργίας.

Επιλέξτε πρώτα το σωστό endpoint (εδώ σπάνε τα περισσότερα εργοστάσια)

Το 2Slides εκθέτει δύο διακριτές ροές δημιουργίας μέσω του API. Μόνο μία από αυτές παράγει decks που μπορούν στη συνέχεια να αφηγηθούν.

Για ένα εργοστάσιο περιεχομένου καρτών λεξιλογίου με αφήγηση και εξαγώγιμο ήχο, χρησιμοποιήστε το

(ή το

create-like-this

αν έχετε layout αναφοράς). Μην χρησιμοποιείτε το — αυτό είναι το endpoint Fast PPT και δεν μπορείτε να προσθέσετε αφήγηση σε αυτό.

Αν το εργοστάσιό σας χρειάζεται μόνο σιωπηλό PPTX (χωρίς ήχο, χωρίς βίντεο), το Fast PPT μέσω

είναι το φθηνότερο μονοπάτι. Το υπόλοιπο αυτού του οδηγού υποθέτει τη ροή εργασίας με αφήγηση.

Η αρχιτεκτονική σε ένα διάγραμμα

[Source data]            [Orchestrator]                   [2Slides API]                    [Outputs]
    │                          │                               │                              │
 vocabulary  ──prompt──▶  Job queue  ──POST──▶  /api/v1/slides/create-pdf-slides ──▶   jobId (UUID)
 spreadsheet (Cron/script)                                     │                              │
    │                          │                               │                              │
                           Poll  ──GET──▶  /api/v1/jobs/{jobId} ◀─────────────────────────────┘
                           every 20-30s    status: success                                    │
                                                              │                                ▼
                                                              │             [pages slides PNG · downloadUrl PDF]
                                                              │
                                                              ▶  POST /api/v1/slides/generate-narration
                                                              │  (jobId, voice, mode, etc.) — async only
                                                              │
                                                           Poll  ──GET──▶  /api/v1/jobs/{jobId}
                                                           message: "Voice narration generation in progress" → success
                                                              │
                                                              ▶  POST /api/v1/slides/download-slides-pages-voices
                                                              │  (free; returns ZIP)
                                                              ▼
                                                  pages/*.png + voices/*.{wav,mp3} + transcript.txt
                                                              │
                                                              ▼
                                                   (Optional) compose MP4 client-side
                                                   with FFmpeg, or use the Workspace UI
                                                              │
                                                              ▼
                                                   [LMS / TikTok / newsletter / S3]

Δεδομένα πηγής → orchestrator → API → ZIP από pages + voices → διανομή. Η σύνθεση MP4 είναι προαιρετική και δεν είναι δημόσιο API endpoint από το 2026 — είναι μια λειτουργία UI του Workspace που χρησιμοποιεί FFmpeg.wasm στον browser. Το ισοδύναμο API είναι το ZIP των pages-and-voices, που μπορείτε να συνθέσετε με

server-side αν χρειάζεστε MP4 στο εργοστάσιο.

Βήμα 1 — Σχεδιάστε πρώτα το σχήμα πηγής

Η μοναδική κίνηση με τη μεγαλύτερη μόχλευση είναι η ορισμός του σχήματος δεδομένων πηγής πριν από οποιαδήποτε κλήση API. Τα decks που χτίζονται από καθαρό σχήμα είναι αναπαραγώγιμα· τα decks που χτίζονται από ad-hoc prompts δεν είναι.

Μια γραμμή πηγής deck λεξιλογίου που κλιμακώνεται:

deck_id: vocab-b1-travel-2026-w14
source_l1: en          # learner's native language
target_l2: es          # language being learned
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 more
generation:
  endpoint: create-pdf-slides
  aspect_ratio: "9:16"      # vertical for short-form review
  resolution: "2K"
  page_count: 30
  content_detail: "concise"
narration:
  enabled: true
  voice: "Puck"             # see /tts_sample_voices for the catalog
  mode: "single"
distribution:
  social: [tiktok, reels, shorts]
  newsletter: monday-2026-w14

Αυτό το αντικείμενο είναι η μονάδα εργασίας. Όλα τα downstream το καταναλώνουν.

Χτίστε το σχήμα πηγής σε ό,τι ήδη έχετε: ένα Google Sheet για μη-τεχνικές ομάδες, έναν πίνακα Postgres για ομάδες engineering, ένα CMS με δομημένα πεδία για ομάδες περιεχομένου. Αποφύγετε να το χτίσετε σε αρχεία Markdown — το Markdown είναι καλό για ανθρώπινη συγγραφή αλλά κακό για μαζικό αυτοματισμό.

Βήμα 2 — Αυθεντικοποίηση

Πάρτε ένα API key από τη σελίδα διαχείρισης API. Η μορφή είναι:

sk-2slides-{64-character-hex-string}

Όλα τα requests χρησιμοποιούν bearer auth:

Authorization: Bearer sk-2slides-...

Τα όρια ρυθμού ανά endpoint τεκμηριώνονται στο 2slides.com/api.md. Για μαζική παραγωγή:

• create-pdf-slides
  και
  create-like-this
  : σχεδιάστε την ουρά σας γύρω από τα όρια συντρεχτικότητάς τους με exponential backoff στο 429
• jobs/{id}
  (poll): σεβαστείτε το cadence polling παρακάτω — 20-30s, όχι επιθετικό
• download-slides-pages-voices
  : δωρεάν και ταχύτερο, αλλά εξακολουθεί να έχει όριο ρυθμού

Βήμα 3 — Υποβάλετε μια εργασία δημιουργίας Nano Banana

Οι κάρτες λεξιλογίου λειτουργούν καλύτερα σε async mode (η δημιουργία εικόνας ανά διαφάνεια διαρκεί 1-3 λεπτά για ένα deck 30 καρτών).

curl -X POST "https://2slides.com/api/v1/slides/create-pdf-slides" \
  -H "Authorization: Bearer sk-2slides-..." \
  -H "Content-Type: application/json" \
  -d '{
    "userInput": "<your deck-shaped prompt — see Step 4>",
    "responseLanguage": "en",
    "aspectRatio": "9:16",
    "resolution": "2K",
    "page": 30,
    "contentDetail": "concise",
    "mode": "async"
  }'

Η απάντηση περιέχει το

(ένα UUID). Κάντε poll για την ολοκλήρωση:

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

Cadence polling: κάθε 20-30 δευτερόλεπτα. Μην κάνετε poll γρηγορότερα — η τεκμηρίωση API το αναφέρει ρητά, και το επιθετικό polling είναι η πιο κοινή αιτία 429. Τα περισσότερα decks ολοκληρώνονται σε 1-3 λεπτά.

Όταν

, η εργασία έχει εικόνες διαφανειών αποθηκευμένες στο R2 και ένα για συλλογή PDF. Οι ίδιες οι εικόνες διαφανειών είναι αυτές που θα συνδυάσετε αργότερα με τον ήχο.

Βήμα 4 — Χτίστε templates prompt που αντέχουν σε κλίμακα

Η μοναδική μεγαλύτερη διαφορά μεταξύ ενός εύθραυστου εργοστασίου και ενός αξιόπιστου είναι τα templates prompt. Μην γράφετε prompts στο runtime ανά deck. Ορίστε ένα template ανά τύπο deck και αντικαταστήστε τιμές.

Template deck λεξιλογίου (

):

Generate a {{cefr_level}}-level vocabulary deck for {{source_l1}}-speaking learners
of {{target_l2}}. Theme: {{theme}}.

Number of cards: {{word_count}}.

For each card, output exactly:
- Target word (in {{target_l2}})
- Part of speech
- IPA transcription
- Translation in {{source_l1}}
- Two example sentences in natural {{theme}} context, B1 syntax, 8–14 words each

Words to include:
{{word_list_yaml}}

End with a 3-card recap of the most useful 3 words from the deck.

Το οπτικό στιλ ελέγχεται από την παράμετρο

(custom prompt) ή αφήνεται στο default ("clean infographic, no photographs, balanced typography"). Διατηρήστε τα prompts versioned σε git. Όταν ένα prompt αλλάζει, καταγράψτε την έκδοση με κάθε deck που δημιουργείται για να μπορείτε να συσχετίσετε τις παλινδρομήσεις ποιότητας με τις αλλαγές prompt.

Βήμα 5 — Προσθέστε αφήγηση

Μόλις η εργασία δημιουργίας είναι

, ξεκινήστε την αφήγηση. Η αφήγηση είναι μόνο async και λειτουργεί στο ίδιο :

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

Στη συνέχεια κάντε poll το ίδιο

μέχρι το μήνυμα να μεταβεί από "Voice narration generation in progress" σε κατάσταση επιτυχίας.

Δύο μοτίβα φωνής λειτουργούν καλά για κάρτες λεξιλογίου:

• mode: "single"
  με μία φωνή — απλή ανάγνωση λέξης + IPA + πρότασης
• mode: "multi"
  με δύο φωνές — παραδείγματα προτάσεων χωρισμένα μεταξύ ομιλητών, ιδανικά για ρήματα και ιδιωματισμούς

Ο κατάλογος φωνών δημοσιεύεται στο

. Συνηθισμένες επιλογές περιλαμβάνουν , , , . Επιβεβαιώστε την υποστήριξη με τα τελευταία API docs πριν καρφιτσώσετε σε μια συγκεκριμένη φωνή στην παραγωγή.

Σημαντικό: αυτό το ένα endpoint δημιουργεί τόσο κείμενο φωνής όσο και ήχο φωνής. Μην καλέσετε ξεχωριστά endpoints "voice text" και "voice audio" — δεν υπάρχει δημόσιο API για αυτά τα βήματα ανεξάρτητα. Διαμορφώστε το αίτημα αφήγησης μία φορά και το API κάνει και τα δύο.

Βήμα 6 — Εξαγωγή pages και voices (δωρεάν)

Μόλις η αφήγηση ολοκληρωθεί, ανακτήστε όλα τα assets σε ένα μόνο ZIP:

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

Η απάντηση περιλαμβάνει ένα

(έγκυρο για 1 ώρα) για ένα ZIP που περιέχει:

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

Αυτή η εξαγωγή είναι δωρεάν — δεν καταναλώνονται credits. Κατεβάστε το ZIP και αποθηκεύστε τα assets στο δικό σας object store. Το presigned URL λήγει μετά από 1 ώρα.

Βήμα 7 — (Προαιρετικά) Συνθέστε MP4 server-side

Το 2Slides API δεν εκθέτει επί του παρόντος ένα endpoint σύνθεσης MP4 — η δημιουργία MP4 ζει στο UI του Workspace μέσω FFmpeg.wasm στον browser. Για ένα εργοστάσιο περιεχομένου, συνθέστε MP4 server-side με

:

# For each page, build a clip of (image still) + (voice audio).
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

# Concatenate all per-page clips into the final MP4.
ffmpeg -f concat -safe 0 -i clip_list.txt -c copy final.mp4

Το cadence ήχου ανά σελίδα είναι ό,τι παρήγαγε ο γεννήτορας αφήγησης — τυπικά 5-12 δευτερόλεπτα ανά διαφάνεια για κάρτες λεξιλογίου. Το αποτέλεσμα είναι το ίδιο MP4 που θα κατέβαζε ένας χρήστης από το UI του Workspace, αλλά παραγμένο headlessly στο pipeline του εργοστασίου σας.

Αν θέλετε κατακόρυφες (9:16) και οριζόντιες (16:9) παραλλαγές του ίδιου deck, το πιο καθαρό μονοπάτι είναι να δημιουργήσετε το deck δύο φορές σε διαφορετικές αναλογίες διαστάσεων στο στάδιο δημιουργίας διαφανειών (

vs ). Η περικοπή FFmpeg εκ των υστέρων συχνά παράγει άσχημα αποτελέσματα επειδή οι διαφάνειες σχεδιάστηκαν για συγκεκριμένη αναλογία.

Βήμα 8 — Χτίστε τον orchestrator

Ένας ελάχιστος orchestrator χειρίζεται πέντε loops:

# Pseudocode

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

    # 1. Generate slides via Nano Banana endpoint
    job = post("/api/v1/slides/create-pdf-slides", body=build_payload(deck))
    deck_artifact = poll_until_complete(job.data.jobId)

    # 2. Narrate (async only)
    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. Export pages + voices ZIP (free)
    zip_url = post("/api/v1/slides/download-slides-pages-voices",
                   body={"jobId": deck_artifact.id})

    # 4. Download and store assets in your object store
    download_to_s3(zip_url, deck.id)

    # 5. (Optional) compose MP4 with ffmpeg, then distribute
    if deck.distribution.social:
        compose_mp4(deck.id)
        distribute(deck)

Τρέξτε αυτό σε ένα worker box με ουρά. Για 100 decks ανά ημέρα, ένας worker αρκεί. Για 1.000+, διασκορπίστε σε ένα μικρό worker pool — αλλά βεβαιωθείτε ότι το pool σέβεται τα όρια ρυθμού κάθε API endpoint, όχι μόνο τον αριθμό worker.

Βήμα 9 — Μοτίβα διανομής

Το επίπεδο διανομής μετατρέπει τα artifacts σε επιχειρηματική αξία:

• LMS: ανεβάστε το συντεθειμένο MP4 στο Canvas / Moodle / Blackboard / Google Classroom μέσω των αντίστοιχων APIs τους
• TikTok / Reels / Shorts: βάλτε σε ουρά MP4 9:16 σε ένα εργαλείο δημοσίευσης (Buffer, Later, native scheduler), ένα την ημέρα
• Newsletter: ενσωματώστε τη συλλογή PDF (από το
  downloadUrl
  της αρχικής εργασίας δημιουργίας) ως σύνδεσμο λήψης στην εβδομαδιαία έκδοση
• Πωλήσεις / lead magnet: ανεβάστε το PDF σε μια σελίδα Stan Store / Gumroad· το teaser carousel οδηγεί την επισκεψιμότητα

Μην προσπαθείτε να εφεύρετε τη διανομή. Χρησιμοποιήστε τα native APIs της πλατφόρμας και αφήστε τον orchestrator σας να ρίξει μια γραμμή στον scheduler σας.

Μαθηματικά κόστους (το μέρος για το οποίο πρέπει να σχεδιάσετε πρώτα)

Για decks Nano Banana με αφήγηση, τα credits αυξάνονται γρηγορότερα από ό,τι ίσως είδαν ορισμένοι αναγνώστες με την τιμολόγηση Fast PPT. Τα μαθηματικά ανά deck 30 καρτών (ανάλυση 1K/2K, με αφήγηση):

• Planning: 10 credits
• Δημιουργία διαφανειών: 30 × 100 = 3,000 credits
• Αφήγηση (κείμενο + ήχος): 30 × 210 = 6,300 credits
• Εξαγωγή pages + voices: 0 credits (δωρεάν)
• Σύνολο: ~9,310 credits ανά αφηγημένο deck 30 καρτών

Χωρίς αφήγηση, το ίδιο deck είναι ~3.010 credits. Σε ανάλυση 4K, διπλασιάστε το τμήμα δημιουργίας διαφανειών: 30 × 200 = 6,000 → ~12,310 credits με αφήγηση.

Για ένα εργοστάσιο 100 decks/μήνα: 100 × 9,310 = ~931,000 credits/μήνα. Συγκρίνετε με τη σελίδα τιμολόγησης για να επιλέξετε ένα tier — και προϋπολογίστε για 4K μόνο όταν η έξοδος πηγαίνει σε ένα πλαίσιο που επωφελείται από αυτήν (μεγάλες οθόνες, premium βίντεο). Για βίντεο επανεξέτασης TikTok / Reels, 1K ή 2K είναι αρκετά.

Λειτουργικά μοτίβα που αποτρέπουν τις πυρκαγιές

Idempotency

Κάθε υποβολή deck πρέπει να είναι idempotent στο

. Αν ο worker σας καταρρεύσει στη μέση μιας παρτίδας, η επανεκκίνηση της ουράς δεν πρέπει να παράγει διπλά decks. Το πιο καθαρό μοτίβο: αποθηκεύστε σε μια γραμμή βάσης δεδομένων· μεταβείτε καταστάσεις ().

Πύλες ποιότητας

Μην διανέμετε αυτόματα. Πριν στείλετε στο TikTok ή στο Canvas, εκτελέστε έναν ελέγξιμο από μηχανή έλεγχο ποιότητας στο artifact:

• Ο αριθμός σελίδων ταιριάζει με τον αριθμό που ζητήθηκε
• Το ZIP περιέχει τον αναμενόμενο αριθμό αρχείων
  pages/page_NN.png
  και
  voices/page_NN.wav
• Η διάρκεια ήχου ανά σελίδα είναι μεταξύ 3 και 15 δευτερολέπτων (μια κάρτα 30 δευτερολέπτων σχεδόν πάντα σημαίνει ένα παραλληρητικό μακρύ script)
• Το
  transcript.txt
  δεν είναι κενό και περιέχει τις λέξεις-στόχο

Για τις πρώτες 50 παρτίδες, κάντε επίσης έναν χειροκίνητο spot check σε 1 στις 10 decks. Οι πρώτες 50 παρτίδες είναι όπου εμφανίζονται συστημικά προβλήματα prompt.

Versioning

Κάθε artifact αποθηκεύει: έκδοση template prompt, έκδοση μοντέλου εικόνας (

vs ), φωνή αφήγησης, χρονική σήμανση δημιουργίας. Όταν το μοντέλο βελτιώνεται ή ένα prompt αλλάζει, μπορείτε να επανεκτελέσετε μόνο τα επηρεαζόμενα decks.

Τηλεμετρία κόστους

Κάθε deck έχει γνωστό κόστος credit (δείτε τα μαθηματικά παραπάνω). Παρακολουθήστε τα credits που καταναλώνονται ανά deck. Όταν η χρήση credit ανά deck διπλασιάζεται απρόσμενα, κάτι άλλαξε (μετατόπιση αριθμού σελίδων, retries, μετάβαση σε 4K). Βρείτε το πριν ο λογαριασμός credit σας πιάσει απροετοίμαστους.

Διαχείριση αποτυχίας

Μια αποτυχημένη εργασία είναι φυσιολογική — διακοπή δικτύου, φόρτωση μοντέλου, σπάνιο 5xx. Δοκιμάστε ξανά μία φορά μετά από backoff. Μετά από δύο αποτυχίες, σπρώξτε το deck σε μια ουρά

. Μην κάνετε infinite loop.

Build vs buy: πότε να χρησιμοποιήσετε καθόλου το API

Το API είναι η σωστή απάντηση όταν:

• Παράγετε >10 decks/εβδομάδα
• Έχετε δομημένα δεδομένα πηγής
• Χρειάζεστε αφηγημένα MP4s που θα συνθέσετε server-side και θα διανείμετε
• Ενσωματώνεστε με ένα LMS, scheduler ή CMS
• Θέλετε αναπαραγωγιμότητα κάτω από prompt versioning

Το API είναι υπερβολικό όταν:

• Παράγετε 1 deck την εβδομάδα και ρυθμίζετε οπτικά κάθε φορά
• Είστε μαθητής που χτίζει decks για προσωπική μελέτη (το UI είναι ταχύτερο — και το UI του Workspace κάνει επίσης τη σύνθεση MP4 για εσάς)
• Είστε καθηγητής που χτίζει ένα deck ανά μάθημα (χρησιμοποιήστε το Create Slides from File ή το Create Slides Like This και παρακάμψτε την ενορχήστρωση)

Συχνές Ερωτήσεις

Πού παίρνω ένα API key;

2slides.com/api. Τα keys ζουν στο tab διαχείρισης API.

Γιατί δεν μπορώ να προσθέσω αφήγηση σε μια εργασία

/api/v1/slides/generate

;

Το endpoint

είναι Fast PPT — PPTX βασισμένο σε template. Η έξοδός του είναι ένα οριστικοποιημένο αρχείο .pptx, όχι μια εργασία slide-image-plus-text που μπορεί να διαβάσει ο γεννήτορας αφήγησης. Ο γεννήτορας αφήγησης δέχεται ρητά μόνο εργασίες από ή , που παράγουν εργασίες διαφανειών nano banana με δομημένο περιεχόμενο ανά σελίδα.

Μπορώ να εξάγω MP4 απευθείας από το API;

Όχι, όχι από το 2026. Η εξαγωγή MP4 είναι μια λειτουργία UI του Workspace υλοποιημένη client-side με FFmpeg.wasm. Το ισοδύναμο API είναι το

που επιστρέφει ένα ZIP από εικόνες διαφανειών, αρχεία ήχου και ένα transcript — συνθέτετε το MP4 μόνοι σας με αν το χρειάζεστε σε ένα pipeline εργοστασίου περιεχομένου. Δείτε το Βήμα 7.

Ποιες γλώσσες υποστηρίζει το API για δημιουργία;

22+ γλώσσες, συμπεριλαμβανομένων Ισπανικών, Γαλλικών, Γερμανικών, Αραβικών, Ιαπωνικών, Κορεάτικων, Χίντι, Βιετναμέζικων, Ρωσικών, Πολωνικών, Ιταλικών, Πορτογαλικών, Ινδονησιακών, Ταϊλανδέζικων, Τουρκικών και Κινέζικων (Απλοποιημένων/Παραδοσιακών). Περάστε μέσω

.

Ποιο είναι το κόστος credit;

Για decks Nano Banana: 10 (planning) + 100/διαφάνεια στα 1K/2K (ή 200/διαφάνεια στα 4K) για δημιουργία διαφανειών, συν 210/σελίδα (10 κείμενο + 200 ήχο) για αφήγηση. Η εξαγωγή pages + voices είναι δωρεάν. Ένα αφηγημένο deck 30 καρτών στα 2K είναι ~9,310 credits. Δείτε τη σελίδα τιμολόγησης και την παραπάνω ενότητα μαθηματικών κόστους.

Πώς χειρίζομαι τα όρια ρυθμού 429;

Exponential backoff. Ξεκινήστε από 1s, διπλασιάστε έως 60s. Μετά από τρία διαδοχικά 429, μειώστε τον αριθμό σύγχρονων worker σας στο μισό. Μην κάνετε poll το

γρηγορότερα από κάθε 20 δευτερόλεπτα — αυτή είναι η πιο κοινή αιτία 429.

Μπορώ να ενσωματωθώ με Zapier / Make / n8n;

Ναι — οποιοδήποτε εργαλείο μπορεί να κάνει αυθεντικοποιημένα HTTP requests μπορεί να οδηγήσει το 2Slides API. Το n8n ιδιαίτερα είναι δημοφιλές για εργοστάσια περιεχομένου επειδή χειρίζεται τα μοτίβα polling και ουράς εγγενώς.

Πώς αποτρέπω τα δημιουργημένα decks από το να ευρετηριαστούν δημόσια;

Τα decks που δημιουργούνται μέσω API είναι ιδιωτικά στον λογαριασμό σας από προεπιλογή. Η δημόσια κοινοποίηση είναι μια ξεχωριστή ρητή ενέργεια.

Πώς δημιουργώ κατακόρυφες (9:16) και οριζόντιες (16:9) εκδόσεις του ίδιου deck;

Δημιουργήστε το deck δύο φορές — μία με

και μία με . Οι διαφάνειες σχεδιάζονται ανά αναλογία διαστάσεων κατά τον χρόνο δημιουργίας, οπότε η εκ των υστέρων περικοπή σπάνια φαίνεται καλή. Ναι, αυτό σημαίνει διπλασιασμό του κόστους credit· είναι ένα σκόπιμο tradeoff για καθαρά οπτικά.

Το συμπέρασμα

Ένα εργοστάσιο περιεχομένου είναι δομημένα δεδομένα πηγής + ένας σταθερός orchestrator + τα σωστά API endpoints. Το 2Slides API είναι το τρίτο κομμάτι· εσείς είστε υπεύθυνοι για τα δύο πρώτα. Η πιο κοινή αποτυχία εργοστασίου είναι η χρήση του

(Fast PPT) και στη συνέχεια η προσπάθεια αφήγησης — αυτό το μονοπάτι είναι κλειστό. Χρησιμοποιήστε το ή το αντ' αυτού, αφηγηθείτε με , εξάγετε με και συνθέστε MP4 server-side με .

Για τη χειροκίνητη πλευρά της ίδιας ροής εργασίας, δείτε τον οδηγό καρτών λεξιλογίου και τον οδηγό ροής εργασίας δημιουργών. Τα μοτίβα UI εκεί είναι τα ίδια μοτίβα που αυτοματοποιείτε με το API· η κατανόηση πρώτα της χειροκίνητης ροής κάνει την ενσωμάτωση API πολύ ταχύτερη.