كيفية توليد 100 حزمة مفردات بالجملة باستخدام 2Slides API (دليل مصنع المحتوى لعام 2026)

بمجرد أن تتحقق من سير العمل اليدوي — توليد حزمة مفردات واحدة، التعليق عليها صوتيًا، تصدير الأصول — فالعنق التالي هو الحجم. مدرسة لغات بـ 12 مستوى و30 موضوعًا أسبوعيًا تحتاج 360 حزمة في السنة. قناة TikTok بدون وجه تنشر يوميًا تحتاج 365 حزمة بالإضافة إلى نسب الجوانب المتنوعة. فريق محتوى في شركة EdTech يحتاج مئات الحزم مقسمة حسب أزواج L1/L2.

لا تبني 360 حزمة يدويًا. تبني مصنع محتوى.

هذا الدليل هو دليل 2026 العملي لتوليد حزم المفردات (وأي محتوى شرائح آخر) بالجملة باستخدام 2Slides API. أهم قرار معماري — والذي يُخطئ فيه كثيرًا — هو اختيار endpoint التوليد الصحيح.

اختر الـ endpoint الصحيح أولًا (هنا تنكسر معظم المصانع)

يكشف 2Slides عن تدفقي توليد متمايزين عبر API. واحد منهما فقط ينتج حزمًا يمكن تعليقها صوتيًا لاحقًا.

لمصنع محتوى بطاقات مفردات بتعليق صوتي وصوت قابل للتصدير، استخدم

(أو

create-like-this

إذا كان لديك تخطيط مرجعي). لا تستخدم — هذا هو 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]

البيانات المصدر ← المنسق ← API ← ZIP من pages + voices ← التوزيع. تركيب MP4 اختياري وليس endpoint API عام في 2026 — إنه ميزة في واجهة Workspace باستخدام FFmpeg.wasm في المتصفح. المكافئ في API هو ZIP الـ pages-and-voices، الذي يمكنك تركيبه بـ

على جانب الخادم إذا كنت تحتاج MP4 في المصنع.

الخطوة 1 — صمم مخطط المصدر أولًا

أعلى تحرك في الرافعة هو تعريف مخطط بيانات المصدر قبل أي مكالمة API. الحزم المبنية من مخطط نظيف قابلة للتكرار؛ الحزم المبنية من موجهات مخصصة ليست كذلك.

صف مصدر حزمة مفردات يتوسع:

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

هذا الكائن هو وحدة العمل. كل ما يأتي في المراحل التالية يستهلكه.

ابنِ مخطط المصدر فيما لديك بالفعل: Google Sheet للفرق غير التقنية، جدول Postgres لفرق الهندسة، CMS بحقول مهيكلة لفرق المحتوى. تجنب بناءه في ملفات Markdown عادية — Markdown جيد للكتابة البشرية لكنه سيئ للأتمتة بالجملة.

الخطوة 2 — التوثيق

احصل على API key من صفحة إدارة API. الصيغة هي:

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

تستخدم جميع الطلبات bearer auth:

Authorization: Bearer sk-2slides-...

حدود المعدل لكل endpoint موثقة في 2slides.com/api.md. للإنتاج بالجملة:

• create-pdf-slides
  و
  create-like-this
  : صمم طابورك حول حدود التزامن مع exponential backoff على 429
• jobs/{id}
  (poll): احترم وتيرة الاستطلاع أدناه — 20-30 ثانية، ليس عدوانيًا
• download-slides-pages-voices
  : مجاني وأسرع، لكن محدود المعدل أيضًا

الخطوة 3 — قدم مهمة توليد Nano Banana

تعمل بطاقات المفردات بشكل أفضل في وضع async (يستغرق توليد الصور لكل شريحة 1-3 دقائق لحزمة 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). استطلع للاكتمال:

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

وتيرة الاستطلاع: كل 20-30 ثانية. لا تستطلع بشكل أسرع — توثيق API يصرح بهذا، والاستطلاع العدواني هو أكثر سبب شائع لـ 429. تكتمل معظم الحزم في 1-3 دقائق.

عندما تكون

، فإن المهمة تخزن صور الشرائح على R2 و لتجميع PDF. صور الشرائح نفسها هي ما ستجمعه لاحقًا مع الصوت.

الخطوة 4 — ابنِ قوالب موجه تصمد على نطاق واسع

أكبر فرق بين مصنع متذبذب ومصنع موثوق هو قوالب الموجه. لا تكتب موجهات في وقت التشغيل لكل حزمة. عرّف قالبًا لكل نوع حزمة واستبدل القيم.

قالب حزمة المفردات (

):

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.

يتم التحكم في النمط البصري بمعامل

(موجه مخصص) أو يُترك للإعداد الافتراضي ("clean infographic, no photographs, balanced typography"). احفظ الموجهات بإصدارات في git. عندما يتغير موجه، سجّل الإصدار مع كل حزمة مولدة لتربط تراجعات الجودة بتغييرات الموجه.

الخطوة 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
  }'

ثم استطلع نفس

حتى تنتقل الرسالة من "Voice narration generation in progress" إلى حالة نجاح.

نمطان من الأصوات يعملان جيدًا لبطاقات المفردات:

• mode: "single"
  بصوت واحد — قراءة كلمة + IPA + جملة مباشرة
• mode: "multi"
  بصوتين — أمثلة الجمل مقسمة بين المتحدثين، مثالية للأفعال والتعابير

كتالوج الأصوات منشور في

. تشمل الاختيارات الشائعة و و و. أكد الدعم بأحدث وثائق API قبل تثبيت صوت محدد في الإنتاج.

مهم: هذا الـ endpoint الواحد يولد كلًا من نص الصوت وصوت الصوت. لا تستدعِ endpoints منفصلة لـ "voice text" و"voice audio" — لا يوجد API عام لتلك الخطوات بشكل مستقل. اضبط طلب التعليق الصوتي مرة واحدة وAPI يقوم بكليهما.

الخطوة 6 — تصدير pages وvoices (مجاني)

بمجرد اكتمال التعليق الصوتي، استرجع جميع الأصول في 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"
  }'

تتضمن الاستجابة

(صالح لمدة ساعة) لـ ZIP يحتوي على:

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

هذا التصدير مجاني — لا تُستهلك أرصدة. نزّل ZIP وخزّن الأصول في مخزن الكائنات الخاص بك. ينتهي URL المُوقع مسبقًا بعد ساعة.

الخطوة 7 — (اختياري) تركيب MP4 على جانب الخادم

لا يكشف 2Slides API حاليًا عن endpoint لتركيب MP4 — توليد MP4 يعيش في واجهة Workspace عبر FFmpeg.wasm في المتصفح. لمصنع محتوى، ركّب MP4 على جانب الخادم بـ

:

# 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

وتيرة الصوت لكل صفحة هي ما ينتجه مولد التعليق الصوتي — عادة 5-12 ثانية لكل شريحة لبطاقات المفردات. النتيجة هي نفس MP4 الذي قد ينزله المستخدم من واجهة Workspace، لكنه أُنتج بدون رأس في خط أنابيب مصنعك.

إذا كنت تريد متغيرات عمودية (9:16) وأفقية (16:9) من نفس الحزمة، فالمسار الأنظف هو توليد الحزمة مرتين بنسب جوانب مختلفة في مرحلة توليد الشرائح (

مقابل ). قص FFmpeg بعد الحقيقة غالبًا ما ينتج نتائج قبيحة لأن الشرائح كانت مخططة لجانب محدد.

الخطوة 8 — ابنِ المنسق

يتعامل المنسق الأدنى مع خمس حلقات:

# 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 حزمة في اليوم، عامل واحد يكفي. لـ 1,000+، انشر إلى مجموعة عمال صغيرة — لكن تأكد من أن المجموعة تحترم حدود معدل كل endpoint API، وليس فقط عدد العمال.

الخطوة 9 — أنماط التوزيع

طبقة التوزيع تحول الأعمال الفنية إلى قيمة تجارية:

• LMS: ارفع MP4 المُركّب إلى Canvas / Moodle / Blackboard / Google Classroom عبر APIs الخاصة بكل منها
• TikTok / Reels / Shorts: أَدرج MP4 9:16 في أداة نشر (Buffer، Later، المجدول الأصلي)، واحد يوميًا
• Newsletter: أدرج تجميع PDF (من
  downloadUrl
  لمهمة التوليد الأصلية) كرابط تنزيل في العدد الأسبوعي
• مغناطيس مبيعات / عملاء محتملين: ارفع PDF إلى صفحة Stan Store / Gumroad؛ يدفع تيزر الكاروسيل حركة المرور

لا تحاول اختراع التوزيع. استخدم APIs الأصلية للمنصة ودع المنسق يُسقط صفًا في مجدولك.

رياضيات التكلفة (الجزء الذي يجب التخطيط له أولًا)

لحزم Nano Banana بتعليق صوتي، تتراكم الأرصدة أسرع من تسعير Fast PPT الذي قد يكون قرأه بعض القراء من قبل. الرياضيات لكل حزمة 30 بطاقة (دقة 1K/2K، مع تعليق صوتي):

• التخطيط: 10 أرصدة
• توليد الشرائح: 30 × 100 = 3,000 رصيد
• التعليق الصوتي (نص + صوت): 30 × 210 = 6,300 رصيد
• تصدير pages + voices: 0 رصيد (مجاني)
• المجموع: ~9,310 رصيد لكل حزمة 30 بطاقة بتعليق صوتي

بدون تعليق صوتي، الحزمة نفسها ~3,010 رصيد. بدقة 4K، ضاعف جزء توليد الشرائح: 30 × 200 = 6,000 → ~12,310 رصيد بتعليق صوتي.

لمصنع 100 حزمة/شهر: 100 × 9,310 = ~931,000 رصيد/شهر. قارن مع صفحة التسعير لاختيار طبقة — وضع ميزانية لـ 4K فقط عندما يذهب الإخراج إلى سياق يستفيد منها (شاشات كبيرة، فيديو متميز). لفيديوهات مراجعة TikTok / Reels، 1K أو 2K كافية.

أنماط تشغيلية تمنع الحرائق

Idempotency

يجب أن يكون كل تقديم حزمة idempotent على

. إذا تعطل عاملك في منتصف الدفعة، فإعادة تشغيل الطابور يجب ألا تنتج حزمًا مكررة. النمط الأنظف: خزّن في صف قاعدة بيانات؛ انتقل بين الحالات ().

بوابات الجودة

لا توزع تلقائيًا. قبل الدفع إلى TikTok أو Canvas، شغّل فحص جودة قابل للقراءة آليًا على العمل الفني:

• يطابق عدد الصفحات العدد المطلوب
• يحتوي ZIP على العدد المتوقع من ملفات
  pages/page_NN.png
  و
  voices/page_NN.wav
• مدة الصوت لكل صفحة بين 3 و15 ثانية (بطاقة 30 ثانية تعني تقريبًا دائمًا سكربتًا طويلًا مهلوسًا)
• transcript.txt
  غير فارغ ويحتوي على الكلمات المستهدفة

لأول 50 دفعة، قم أيضًا بـ فحص يدوي لـ 1 من كل 10 حزم. أول 50 دفعة هي حيث تظهر مشاكل الموجه النظامية.

Versioning

كل عمل فني يخزن: إصدار قالب الموجه، إصدار نموذج الصورة (

مقابل )، صوت التعليق، طابع زمني للتوليد. عندما يتحسن النموذج أو يتغير موجه، يمكنك إعادة تشغيل الحزم المتأثرة فقط.

قياس التكلفة عن بُعد

كل حزمة لها تكلفة رصيد معروفة (انظر الرياضيات أعلاه). تتبع الأرصدة المستهلكة لكل حزمة. عندما يتضاعف استخدام الرصيد لكل حزمة بشكل غير متوقع، فقد تغير شيء (انحراف عدد الصفحات، إعادة محاولات، التحول إلى 4K). اعثر عليه قبل أن تفاجئك فاتورة الرصيد.

معالجة الفشل

المهمة الفاشلة طبيعية — انقطاع شبكة، حمل نموذج، 5xx نادر. أعد المحاولة مرة واحدة بعد backoff. بعد فشلين، ادفع الحزمة إلى طابور

. لا تكرر إلى ما لا نهاية.

بناء مقابل شراء: متى تستخدم API أصلًا

API هو الإجابة الصحيحة عندما:

• تنتج >10 حزم/أسبوع
• لديك بيانات مصدر مهيكلة
• تحتاج MP4s بتعليق صوتي ستركبها على جانب الخادم وتوزعها
• تتكامل مع LMS أو مجدول أو CMS
• تريد قابلية التكرار تحت إصدارات الموجه

API مبالغ فيه عندما:

• تنتج حزمة واحدة في الأسبوع وتضبط بصريًا في كل مرة
• أنت متعلم تبني حزمًا للدراسة الشخصية (واجهة أسرع — وواجهة Workspace تقوم أيضًا بتركيب MP4 لك)
• أنت معلم تبني حزمة واحدة لكل درس (استخدم Create Slides from File أو Create Slides Like This وتخطَّ التنسيق)

الأسئلة الشائعة

من أين أحصل على API key؟

2slides.com/api. تعيش المفاتيح في علامة تبويب إدارة API.

لماذا لا يمكنني إضافة تعليق صوتي إلى مهمة

/api/v1/slides/generate

؟

endpoint

هو Fast PPT — PPTX مدفوع بقالب. مخرجاته ملف .pptx نهائي، وليس مهمة slide-image-plus-text يستطيع مولد التعليق الصوتي قراءتها. مولد التعليق الصوتي يقبل صراحة فقط المهام من أو ، التي تنتج مهام شرائح nano banana بمحتوى مهيكل لكل صفحة.

هل يمكنني تصدير MP4 مباشرة من API؟

لا، ليس في 2026. تصدير MP4 ميزة في واجهة Workspace مُنفذة على جانب العميل بـ FFmpeg.wasm. المكافئ في API هو

الذي يعيد ZIP من صور الشرائح وملفات الصوت ونص التحويل — أنت تركّب MP4 بنفسك بـ إذا كنت تحتاجه في خط أنابيب مصنع محتوى. انظر الخطوة 7.

ما اللغات التي يدعمها API للتوليد؟

أكثر من 22 لغة بما في ذلك الإسبانية والفرنسية والألمانية والعربية واليابانية والكورية والهندية والفيتنامية والروسية والبولندية والإيطالية والبرتغالية والإندونيسية والتايلاندية والتركية والصينية (المبسطة/التقليدية). مرّر عبر

.

ما هي تكلفة الرصيد؟

لحزم Nano Banana: 10 (تخطيط) + 100/شريحة بـ 1K/2K (أو 200/شريحة بـ 4K) لتوليد الشرائح، بالإضافة إلى 210/صفحة (10 نص + 200 صوت) للتعليق الصوتي. تصدير pages + voices مجاني. حزمة 30 بطاقة بتعليق صوتي بـ 2K هي ~9,310 رصيد. انظر صفحة التسعير وقسم رياضيات التكلفة أعلاه.

كيف أتعامل مع حدود معدل 429؟

Exponential backoff. ابدأ من 1s، ضاعف حتى 60s. بعد ثلاث 429 متتالية، أبطئ عدد العمال المتزامنين بمقدار النصف. لا تستطلع

أسرع من كل 20 ثانية — هذا أكثر سبب شائع لـ 429.

هل يمكنني التكامل مع Zapier / Make / n8n؟

نعم — أي أداة يمكنها إجراء طلبات HTTP موثقة يمكنها قيادة 2Slides API. n8n على وجه الخصوص شائعة لمصانع المحتوى لأنها تتعامل مع أنماط الاستطلاع والطوابير بشكل أصلي.

كيف أمنع الحزم المولدة من الفهرسة بشكل عام؟

الحزم المولدة عبر API خاصة بحسابك افتراضيًا. المشاركة العامة إجراء صريح منفصل.

كيف أولد إصدارات عمودية (9:16) وأفقية (16:9) من نفس الحزمة؟

ولّد الحزمة مرتين — مرة بـ

ومرة بـ . تُخطط الشرائح حسب نسبة الجوانب في وقت التوليد، لذا فإن القص بعد الحقيقة نادرًا ما يبدو جيدًا. نعم، هذا يعني مضاعفة تكلفة الرصيد؛ إنها مفاضلة متعمدة لمرئيات نظيفة.

الخلاصة

مصنع المحتوى هو بيانات مصدر مهيكلة + منسق مستقر + endpoints API الصحيحة. 2Slides API هو الجزء الثالث؛ أنت مسؤول عن الأولين. أكثر فشل مصنع شيوعًا هو استخدام

(Fast PPT) ثم محاولة التعليق عليه صوتيًا — هذا المسار مغلق. استخدم أو بدلًا من ذلك، علّق صوتيًا بـ ، صدّر بـ ، وركّب MP4 على جانب الخادم بـ .

للجانب اليدوي من سير العمل نفسه، انظر دليل بطاقات المفردات ودليل سير عمل المنشئين. أنماط الواجهة هناك هي نفس الأنماط التي تؤتمتها بـ API؛ فهم التدفق اليدوي أولًا يجعل تكامل API أسرع بكثير.