أتمتة عروض تقارير التسويق: واجهة برمجة التطبيقات Deck to Video (2026)

لأتمتة عروض تقارير التسويق، قم بتشغيل مهمة مجدولة يوم الاثنين تسحب مقاييس الحملات، تطلب من نموذج لغة كبير (LLM) سردًا من 8 شرائح، وتستدعي ثلاث نقاط نهاية من 2Slides: create-pdf-slides لإنشاء عرض ملخص مصمم بالصور بنسبة عرض إلى ارتفاع 16:9، وgenerate-narration في وضع multi لإنشاء مسار صوتي بصوتين، وdownload-slides-pages-voices للحصول على ملفات PNG وWAV لكل صفحة يتم دمجها بواسطة ffmpeg في ملف MP4. تكلفة عرض ملخص من 8 صفحات بدقة 2K هي 810 رصيد (حوالي 2 دولار)، والتعليق الصوتي يضيف 1,680 رصيد (حوالي 4.20 دولار)، لذا فإن ملخصًا أسبوعيًا مع تعليق صوتي يكلف حوالي 6 دولارات لكل عميل. مصمم لفرق عمليات التسويق، مهندسي النمو، والوكالات.

النقاط الرئيسية

مهمة مجدولة واحدة تحل محل طقوس يوم الاثنين: تصدير المقاييس، عرض ملخص من 8 شرائح، تعليق صوتي بصوتين، وملف MP4 بدقة 1920×1080.
ثلاث نقاط نهاية من 2Slides تقوم بالعمل: create-pdf-slides (10 + 100 رصيد لكل صفحة بدقة 2K)، generate-narration (210 رصيد لكل صفحة)، وdownload-slides-pages-voices (مجاني).
تكلفة ملخص مع تعليق صوتي من 8 شرائح هي 2,490 رصيد، أي حوالي 5 إلى 6.25 دولار حسب حزمة الأرصدة؛ العرض فقط يكلف 810 رصيد.
كل نقطة نهاية للكتابة محدودة بـ 6 طلبات في الدقيقة لكل مفتاح، لذا يجب ترتيب تشغيل 50 عميلًا في قائمة انتظار وليس تنفيذها بالتوازي.
Fast PPT (generate) لا يمكن إضافة تعليق صوتي له؛ للفيديو، ابدأ من create-pdf-slides أو create-like-this.

لمن هذا موجه

قادة عمليات التسويق الذين يعيدون بناء نفس عرض الملخص كل يوم اثنين، مهندسو النمو الذين لديهم المقاييس بالفعل في مستودع بيانات، والوكالات التي تقدم تحديثًا أسبوعيًا لـ 20 أو 50 أو أكثر من العملاء. المشكلة نفسها: الأرقام جاهزة بحلول الساعة 6 صباحًا، والعرض جاهز عند الغداء، ونصف أصحاب المصلحة لا يفتحونه أبدًا.

لا تستخدم هذه الوصفة إذا كان أصحاب المصلحة بحاجة إلى تعديل الشرائح في PowerPoint بعد ذلك؛ لأن خط أنابيب التصميم بالصور ينتج ملف PDF نهائي بالإضافة إلى صور الصفحات، وليس PPTX أصلي. للعروض الأسبوعية القابلة للتعديل، يناسب مسار Fast PPT في أتمتة التقارير الأسبوعية باستخدام Zapier و2Slides بشكل أفضل.

نظرة عامة على سير العمل

الخطوة	الأداة	ماذا يحدث	نقطة نهاية 2Slides / الأرصدة
1. المشغل	Cron (GitHub Actions، Cloud Scheduler، cron على VM)	يُشغل يوم الاثنين الساعة 06:00 بتوقيت العميل	لا شيء
2. سحب المقاييس	Google Ads، Meta، تصدير GA4، أو استعلام SQL من مستودع بيانات	كائن JSON واحد لكل عميل: الإنفاق، الخطة، التحويلات، CPA، القنوات الأعلى، الإعلانات الأعلى أداءً	لا شيء
3. كتابة السرد	نموذج اللغة الكبير الذي تختاره	يعيد 8 أقسام معنونة: النتيجة الرئيسية، الإنفاق مقابل الخطة، القنوات الأعلى، الفائزون الإبداعيون، ملاحظات الجمهور، الاختبارات، المخاطر، خطة الأسبوع القادم	لا شيء
4. إنشاء العرض	2Slides	عرض مصمم بالصور بنسبة 16:9 بدقة 2K مع `designStyle` الخاص بعلامتك التجارية	`POST /api/v1/slides/create-pdf-slides`، 810 رصيد لـ 8 صفحات
5. إضافة التعليق الصوتي	2Slides	صوتان يتناوبان عبر العرض	`POST /api/v1/slides/generate-narration`، 1,680 رصيد لـ 8 صفحات
6. جلب الأصول	2Slides	ملف ZIP يحتوي على `pages/page_01.png`، `voices/page_01.wav`، و`transcript.txt`	`POST /api/v1/slides/download-slides-pages-voices`، مجاني
7. التجميع والتسليم	ffmpeg على العامل الخاص بك، أو Workspace Export	ملف MP4 H.264 يُنشر على Slack، البريد الإلكتروني، أو بوابة العميل	ffmpeg: مجاني؛ Workspace Generate Video: 20 رصيد لكل صفحة

كل استدعاء لـ 2Slides يستخدم نفس رأس Authorization: Bearer $SLIDES_API_KEY، وكل مهمة غير متزامنة يتم الاستعلام عنها عبر GET /api/v1/jobs/{jobId}.

الخطوة 1: الحصول على مفتاح API وربط المجدول

أنشئ مفتاحًا في 2slides.com/api ضمن تبويب مفاتيح API. الحسابات الجديدة تحصل على 500 رصيد مجاني بدون اشتراك، تكفي لتشغيل هذا الخط بالكامل مرة واحدة قبل شراء حزمة. خزّن المفتاح كـ SLIDES_API_KEY في مخزن الأسرار الخاص بالمجدول، لا تخزنه في المتصفح أو دفتر ملاحظات مشترك، وتأكد منه باستخدام نقطة النهاية echo قبل جدولة أي شيء.

curl -s https://2slides.com/api/v1/echo \
  -H "Authorization: Bearer $SLIDES_API_KEY"

مرجع API الخاص بـ 2Slides مع مصادقة Bearer

الشكل 1: مرجع API في 2slides.com/api يعرض كل نقطة نهاية، رأس Bearer، وتكاليف الأرصدة.

للمشغل، يكفي سير عمل GitHub Actions مع on: schedule: - cron: "0 6 * * 1" لعدد قليل من العملاء. لأكثر من 50، ضع العملاء في قائمة انتظار ودع عاملًا واحدًا يعالجها بالتتابع، مما يحافظ على الحد الأقصى 6 طلبات في الدقيقة مع إمكانية إعادة المحاولة.

الخطوة 2: سحب المقاييس ودع نموذج اللغة الكبير يكتب السرد من 8 شرائح

واجهة 2Slides لا تعرف ما هو الملخص الأسبوعي الجيد؛ هذا الجزء لك، وهو ما يحدد جودة العرض. اسحب أرقام الأسبوع الماضي من منصات الإعلانات أو المستودع إلى كائن JSON مسطح لكل عميل، ثم اطلب من نموذج اللغة الكبير أن يعيد بالضبط ثمانية أقسام معنونة:

النتيجة الرئيسية: رقم واحد، جملة واحدة ("انخفض CPA بنسبة 18% أسبوعًا بعد أسبوع مع إنفاق ثابت").
الإنفاق مقابل الخطة: الفعلي، المخطط، الفارق، وتيرة الشهر.
القنوات الأعلى: ثلاث قنوات مع الإنفاق، التحويلات، CPA، والتغير.
الفائزون الإبداعيون: الإعلانان أو الثلاثة الذين حققوا أفضل تحويل ولماذا.
ملاحظات الجمهور والجغرافيا: ما تغير.
الاختبارات الجارية: الفرضية، الحالة، تاريخ القراءة.
المخاطر والمعوقات: حدود الميزانية، فجوات التتبع، الموسمية.
خطة الأسبوع القادم: ثلاث نقاط مع المسؤولين.

اطلب جملًا بسيطة مع الأرقام مضمنة وأقل من 60 كلمة لكل قسم. create-pdf-slides يعتبر نصك المصدر الحقيقي للنص والتخطيط، لذا سرد نظيف من 400 إلى 500 كلمة ينتج عرضًا أكثر إحكامًا من تفريغ 3,000 كلمة لكل مقياس.

// narrative.mjs: تشكيل مخرجات LLM قبل وصولها إلى 2Slides
export function toUserInput(client, sections) {
  const header = `ملخص أسبوعي للإعلام المدفوع لـ ${client.name}، أسبوع ${client.week}. ` +
    `الجمهور: ${client.stakeholders}. النغمة: مباشرة، الأرقام أولاً.`;
  const body = sections
    .map((s, i) => `الشريحة ${i + 1}: ${s.title}\n${s.body}`)
    .join("\n\n");
  return `${header}\n\n${body}`;
}

الخطوة 3: أتمتة تقرير الحملة باستخدام create-pdf-slides

أرسل السرد إلى create-pdf-slides. عيّن page: 8 ليطابق عدد الشرائح ثمانية أقسام، وaspectRatio: "16:9" للشاشات، وresolution: "2K" حتى تحتفظ صور PNG بالجودة عند 1920×1080 بدون تكبير. designStyle هو مكان علامتك التجارية: الألوان، نوع الخط، قواعد التخطيط، وما يجب تجنبه.

curl -s https://2slides.com/api/v1/slides/create-pdf-slides \
  -H "Authorization: Bearer $SLIDES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userInput": "ملخص أسبوعي للإعلام المدفوع لشركة Northwind Outdoor، الأسبوع من 2026-09-01 إلى 2026-09-07. الجمهور: المدير التنفيذي للتسويق وقائد التجارة الإلكترونية. النغمة: مباشرة، الأرقام أولاً.\n\nالشريحة 1: النتيجة الرئيسية\nانخفض CPA بنسبة 18% إلى 31.40 دولارًا مع إنفاق ثابت 48,200 دولار؛ 1,535 عملية شراء مقابل 1,301 الأسبوع السابق.\n\nالشريحة 2: الإنفاق مقابل الخطة\nمخطط 50,000 دولار، تم الإنفاق 48,200 دولار (-3.6%). وتيرة الشهر عند 97% من الخطة.\n\nالشريحة 3: القنوات الأعلى\nMeta إنفاق 22,100 دولار، 812 عملية شراء، CPA 27.20 دولار (-22%). Google Search 18,400 دولار، 571 عملية شراء، CPA 32.20 دولار (-9%). YouTube 7,700 دولار، 152 عملية شراء، CPA 50.66 دولار (+4%).\n\nالشريحة 4: الفائزون الإبداعيون\nفيديو UGC \"جاهز للمسار في 3 طبقات\": 334 عملية شراء، CTR 3.1%. إعلان ثابت \"تخفيضات الخريف، إرجاع مجاني\": 218 عملية شراء.\n\nالشريحة 5: ملاحظات الجمهور والجغرافيا\nDMAs شمال غرب المحيط الهادئ ارتفعت 31% في عمليات الشراء؛ النساء 25-34 الآن 41% من تحويلات Meta.\n\nالشريحة 6: الاختبارات الجارية\nاستهداف واسع مقابل استهداف الاهتمامات على Meta، اليوم 9 من 14، قراءة في 12 سبتمبر. اختبار استبعاد العلامة التجارية في البحث متوقف لإصلاح التتبع.\n\nالشريحة 7: المخاطر والمعوقات\nتباين أعداد الشراء بين GA4 وMeta بنسبة 11%; CPA على YouTube يرتفع لمدة أسبوعين متتاليين.\n\nالشريحة 8: خطة الأسبوع القادم\nنقل 3,000 دولار من YouTube إلى Meta UGC (المسؤول: بريا). إطلاق نسختين جديدتين من UGC (المسؤول: سام). إغلاق فجوة وسم GA4 بحلول الأربعاء (المسؤول: ديف).",
    "designStyle": "علامة Northwind Outdoor: أخضر غابات عميق #1F3D2B، رمل #E8DCC4، أبيض؛ عناوين هندسية جريئة بدون سيريف؛ رقم كبير واحد لكل شريحة؛ بطاقات بيانات نظيفة ومقارنات شريطية بسيطة؛ هوامش واسعة؛ لا صور مخزنة، لا تدرجات لونية",
    "aspectRatio": "16:9",
    "resolution": "2K",
    "page": 8,
    "contentDetail": "concise",
    "imageModel": "gemini-3-pro-image",
    "responseLanguage": "English",
    "mode": "async"
  }'

الاستجابة هي { "jobId": "..." }. استعلم عبر GET https://2slides.com/api/v1/jobs/{jobId} كل 5 إلى 10 ثوانٍ حتى يصبح status هو success (الـ PDF موجود في downloadUrl) أو failed. توقع بضع دقائق لثماني صفحات بدقة 2K. التكلفة: 10 أرصدة تخطيط بالإضافة إلى 100 رصيد لكل صفحة، أي 810 رصيد للعرض المكون من 8 صفحات.

صفحة شرائح مصممة بالصور من 2Slides Nano Banana، الخط الأنبوبي خلف create-pdf-slides

الشكل 2: خط الأنابيب المصمم بالصور خلف شرائح عرض Nano Banana هو ما توفره create-pdf-slides عبر API.

لمطابقة شريحة علامة تجارية موجودة بدلاً من وصف نصي، استخدم create-like-this مع referenceImageUrl يشير إلى صورة عامة لشريحة واحدة على العلامة التجارية. الجسم، التكلفة، والحدود متطابقة بخلاف ذلك.

الخطوة 4: صوتان مع واجهة برمجة التطبيقات للفيديو التعليقي

بمجرد أن يبلغ تقرير المهمة عن success، استدعِ generate-narration على نفس jobId. استخدم mode: "multi" مع اسمي متحدثين وصوتين من بين 30 صوتًا متاحًا؛ Kore وPuck متباعدان بما يكفي ليتمكن المستمعون من متابعة من يتحدث دون إشارة بصرية. includeIntro: true يضيف مقدمة قصيرة تذكر اسم العميل والأسبوع.

curl -s https://2slides.com/api/v1/slides/generate-narration \
  -H "Authorization: Bearer $SLIDES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jobId": "<deck jobId from step 3>",
    "mode": "multi",
    "speaker1Name": "Maya",
    "speaker2Name": "Theo",
    "speaker1Voice": "Kore",
    "speaker2Voice": "Puck",
    "contentMode": "standard",
    "includeIntro": true
  }'

ترد نقطة النهاية بـ 202 وتعود المهمة إلى حالة processing. استعلم عن نفس jobId حتى تعود success مرة أخرى. التعليق الصوتي يكلف 210 رصيد لكل صفحة (10 للنص، 200 للصوت)، أي 1,680 رصيد لثماني شرائح. لإرشادات طول النص وتوقيته، راجع أفضل ممارسات التعليق الصوتي والفيديو للشرائح.

مقارنة واحدة، لأن الناس يسألون: موقع مطوري Gamma (https://developers.gamma.app) يوثق وصفة فيديو مع تعليق صوتي تربط n8n، Synthesia، ElevenLabs، وواجهة Generate الخاصة به، ومفاتيح API تتطلب خطة Pro. مسار 2Slides أعلاه يستخدم بائعًا واحدًا ومفتاحًا واحدًا يعمل على أي حساب، مع ffmpeg على جانبك للتجميع؛ لا ينتج مقدمًا افتراضيًا مثل طبقة Synthesia. إفصاح: 2Slides هو منتجنا.

الخطوة 5: تحويل تقرير التسويق الأسبوعي إلى فيديو باستخدام ffmpeg

استدعِ download-slides-pages-voices بنفس jobId. يعيد ملف ZIP مجاني يحتوي على pages/page_01.png حتى page_08.png، وvoices/page_01.wav حتى page_08.wav، وtranscript.txt مع نص الكلام للترجمة أو ملخص البريد الإلكتروني.

curl -s https://2slides.com/api/v1/slides/download-slides-pages-voices \
  -H "Authorization: Bearer $SLIDES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "jobId": "<deck jobId>" }' \
  -o recap.zip && unzip -q -o recap.zip -d recap

ثم اربط كل PNG مع WAV الخاص به وادمجها. هذا الأمر الواحد ينتج ملف MP4 بدقة 1920×1080 H.264 حيث تبقى كل شريحة على الشاشة بالضبط طوال مدة تعليقها الصوتي:

cd recap && for i in $(seq -w 1 8); do ffmpeg -y -loop 1 -i pages/page_$i.png -i voices/page_$i.wav -c:v libx264 -tune stillimage -pix_fmt yuv420p -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" -c:a aac -b:a 192k -shortest clip_$i.mp4; done && printf "file 'clip_%s.mp4'\n" $(seq -w 1 8) > list.txt && ffmpeg -y -f concat -safe 0 -i list.txt -c copy weekly-recap.mp4

موثق دمج الملفات في مرجع صيغ ffmpeg. لقص عمودي، غيّر كلا القيمتين 1920:1080 إلى 1080:1920 وأعد إنشاء العرض مع aspectRatio: "9:16".

لا يوجد عامل مع ffmpeg؟ افتح نفس المهمة في 2Slides Workspace واستخدم التصدير، ثم إنشاء الفيديو. يقوم بإنشاء MP4 H.264 بدقة 1920×1080 أو 1080×1920 في المتصفح مقابل 20 رصيد لكل صفحة (160 لملخص من 8 شرائح). هذا مناسب لمرة واحدة؛ ffmpeg مناسب لـ 50 عميلًا كل يوم اثنين.

الخطوة 6: خط أنابيب Node.js لأتمتة عروض تقارير التسويق

البرنامج الكامل كسكريبت Node 20 بدون تبعيات سوى fetch. استبدل loadMetrics وwriteNarrative باستعلام المستودع الخاص بك واستدعاء نموذج اللغة الكبير.

// weekly-recap.mjs: Node 20+، يُشغل من مهمة cron يوم الاثنين
import { writeFile } from "node:fs/promises";
import { execFile } from "node:child_process";
import { promisify } from "node:util";
import { toUserInput } from "./narrative.mjs";
import { loadMetrics, writeNarrative } from "./your-data-layer.mjs";

const BASE = "https://2slides.com";
const headers = {
  Authorization: `Bearer ${process.env.SLIDES_API_KEY}`, // للسيرفر فقط
  "Content-Type": "application/json",
};
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
const run = promisify(execFile);

async function post(path, body) {
  const res = await fetch(`${BASE}${path}`, { method: "POST", headers, body: JSON.stringify(body) });
  if (!res.ok) throw new Error(`${path} -> ${res.status}: ${await res.text()}`);
  return res.json();
}

async function waitForJob(jobId, everyMs = 8000) {
  for (;;) {
    const res = await fetch(`${BASE}/api/v1/jobs/${jobId}`, { headers });
    const job = await res.json();
    console.log(`  job ${jobId}: ${job.status} ${job.progress ?? ""}`);
    if (job.status === "success") return job;
    if (job.status === "failed") throw new Error(`job ${jobId} failed: ${job.message ?? ""}`);
    await sleep(everyMs); // استعلام كل 5-10 ثوانٍ؛ jobs/{id} يسمح بـ 10 طلبات/دقيقة
  }
}

export async function buildRecap(client) {
  // 1) المقاييس -> سرد من 8 أقسام
  const metrics = await loadMetrics(client);
  const sections = await writeNarrative(client, metrics);

  // 2) عرض مصمم بالصور: 10 + 100 رصيد/صفحة بدقة 2K
  const { jobId } = await post("/api/v1/slides/create-pdf-slides", {
    userInput: toUserInput(client, sections),
    designStyle: client.designStyle,
    aspectRatio: "16:9",
    resolution: "2K",
    page: 8,
    contentDetail: "concise",
    responseLanguage: client.language ?? "English",
    mode: "async",
  });
  const deck = await waitForJob(jobId);
  console.log("deck PDF:", deck.downloadUrl);

  // 3) تعليق صوتي بصوتين: 210 رصيد/صفحة
  await post("/api/v1/slides/generate-narration", {
    jobId,
    mode: "multi",
    speaker1Name: "Maya",
    speaker2Name: "Theo",
    speaker1Voice: "Kore",
    speaker2Voice: "Puck",
    contentMode: "standard",
    includeIntro: true,
  });
  await waitForJob(jobId);

  // 4) PNG + WAV لكل صفحة (مجاني) -> MP4 عبر ffmpeg
  const zipRes = await fetch(`${BASE}/api/v1/slides/download-slides-pages-voices`, {
    method: "POST", headers, body: JSON.stringify({ jobId }),
  });
  if (!zipRes.ok) throw new Error(`download failed: ${zipRes.status}`);
  const zipPath = `out/${client.slug}.zip`;
  await writeFile(zipPath, Buffer.from(await zipRes.arrayBuffer()));
  await run("bash", ["./stitch.sh", zipPath, `out/${client.slug}-recap.mp4`]); // حلقة ffmpeg من الخطوة 5

  return { jobId, pdf: deck.downloadUrl, video: `out/${client.slug}-recap.mp4` };
}

// معالجة العملاء واحدًا تلو الآخر: 3 طلبات كتابة لكل عميل تبقيك تحت 6 طلبات/دقيقة
const clients = JSON.parse(process.env.CLIENTS_JSON ?? "[]");
for (const client of clients) {
  try {
    const out = await buildRecap(client);
    console.log(`تم الانتهاء من ${client.name}`, out);
  } catch (err) {
    console.error(`فشل ${client.name}:`, err.message); // تنبيه، لا تعيد المحاولة بشكل أعمى
  }
}

كل عميل يكلف ثلاث طلبات كتابة (العرض، التعليق الصوتي، التنزيل) بالإضافة إلى استعلامات قراءة للانتظار ضمن حد 10 طلبات في الدقيقة منفصلة.

اختيار نمط مرجعي

إذا لم تنجح وصف علامتك التجارية في designStyle، استخدم صورة مرجعية. تستضيف معرض 2Slides عروضًا حقيقية يمكنك تصفحها للحصول على اتجاه أو تمريرها إلى create-like-this كـ referenceImageUrl. هذه عروض مرجعية، ليست مخرجات API: الشرائح أدناه من عرض Adobe Creative Trends 2026 في المعرض وتظهر النمط المعتدل، الموجه بالبيانات، الذي يُقرأ جيدًا في ملخص أسبوعي.

عرض Adobe Creative Trends 2026 المرجعي من معرض 2Slides، مرجع نمط لعروض ملخصات التسويق

الشكل 3: شريحة الغلاف لعرض Adobe Creative Trends 2026 المرجعي في معرض 2Slides.

الشكل 4: شريحة داخلية من نفس العرض في المعرض. مرر شريحة مثل هذه كـ referenceImageUrl وcreate-like-this يستخلص الألوان، النوع، والتخطيط منها.

معرض 2Slides لعروض الشرائح الجاهزة للتحميل

الشكل 5: معرض 2Slides. افتح عرضًا ونسخ عنوان URL لصورة الشريحة التي تريد وراثة مظهرها.

للوكالات، خزّن عنوان URL لشريحة مرجعية واحدة لكل عميل بجانب تكوين المقاييس الخاص به، ويبقى عرض كل يوم اثنين ضمن نظام العميل البصري.

التكلفة

لكل ملخص من 8 شرائح: 810 رصيد للعرض بدقة 2K، 1,680 للتعليق الصوتي، لا شيء لملف ZIP أو ffmpeg على العامل الخاص بك. حزم الأرصدة تبدأ من 5 دولارات لـ 2,000 رصيد (0.0025 دولار لكل رصيد) إلى 80 دولارًا لـ 40,000 رصيد (0.002 دولار لكل رصيد).

الحجم	أرصدة العرض	أرصدة التعليق الصوتي	إجمالي الأرصدة	بالدولار عند 0.0025$	بالدولار عند 0.002$ (حزم 80$)
ملخص واحد مع تعليق صوتي	810	1,680	2,490	6.23$	4.98$
20 ملخصًا / شهر (5 حملات أسبوعيًا)	16,200	33,600	49,800	124.50$	99.60$
500 ملخص / شهر (125 عميل أسبوعيًا)	405,000	840,000	1,245,000	غير متوفر	2,490$
20 عرضًا / شهر، بدون تعليق صوتي	16,200	0	16,200	40.50$	32.40$

ملاحظتان. الانتقال إلى resolution: "1K" لا يوفر شيئًا (100 رصيد لكل صفحة ينطبق على 512px، 1K، و2K؛ فقط 4K يضاعف التكلفة)، لذا ابق على 2K. إنشاء MP4 في Workspace بدلاً من ffmpeg يضيف 160 رصيد (0.32 إلى 0.40 دولار) لكل ملخص.

Fast PPT أم شرائح مصممة بالصور لهذا الاستخدام؟

الحاجة	Fast PPT `generate`	`create-pdf-slides` / `create-like-this`
أصحاب المصلحة يعدلون العرض في PowerPoint	نعم، PPTX أصلي من 1,500+ قالب	لا، الناتج PDF بالإضافة إلى صور الصفحات
فيديو للمشاهدة بدلاً من القراءة مع تعليق صوتي	لا، التعليق الصوتي غير متاح	نعم، `generate-narration` ثم MP4
التكلفة لـ 8 صفحات	80 رصيد (حوالي 0.20 دولار)	810 رصيد للعرض، 2,490 مع التعليق الصوتي
زمن التنفيذ	حوالي 30 ثانية، تزامن افتراضي	بضع دقائق، غير متزامن افتراضيًا
التحكم بالعلامة التجارية	اختيار `themeId` من `GET /api/v1/themes/search`	نص حر في `designStyle` أو `referenceImageUrl`

تشغل العديد من الفرق كلاهما: عرض Fast PPT لمدير الحساب الذي يعلّق عليه، والفيديو المعلق للعميل الذي يشاهده على الهاتف. كيف تولد فرق التسويق عروض تقديمية بالذكاء الاصطناعي على نطاق واسع يغطي الجانب القابل للتعديل بعمق.

الأخطاء الشائعة

تشغيل 50 عميلًا بالتوازي. كل نقطة نهاية كتابة تسمح بـ 6 طلبات في الدقيقة لكل مفتاح. ضع العملاء في قائمة انتظار وعالجهم بالتتابع، أو وزع الإرسال عبر الساعة.
استدعاء generate-narration على مهمة Fast PPT. التعليق الصوتي يقبل فقط مهام من create-pdf-slides أو create-like-this؛ مهمة generate تُرفض ولا يمكن تحويلها.
وضع مفتاح API في لوحة تحكم المتصفح. احتفظ بـ SLIDES_API_KEY على الخادم أو في مخزن أسرار المجدول. إذا كانت صفحة موجهة للعميل تحتاج الفيديو، قدم MP4 الذي أنشأته مسبقًا.
استخدام page: 0 عندما تريد بالضبط ثماني شرائح. 0 يعني اكتشاف عدد الشرائح تلقائيًا. عيّن page: 8 ليكون لكل فيديو أسبوعي نفس الشكل والطول.
تمرير رمز لغة. responseLanguage يأخذ اسمًا مثل "Spanish"، وليس "es". خزّن الاسم في تكوين كل عميل.
إرسال تصدير المقاييس الخام. CSV من 3,000 صف ملصوق في userInput ينتج عرضًا مشوشًا. لخّص أولًا، وقدم سردًا من 400 إلى 500 كلمة، واحتفظ بالـ CSV كمرفق.

الأسئلة المتكررة

كم تكلفة أتمتة تقرير تسويقي أسبوعي كفيديو مع تعليق صوتي؟

ملخص مع تعليق صوتي من 8 شرائح يكلف 2,490 رصيد، بين 4.98 و6.23 دولار حسب حزمة الأرصدة. يتجزأ إلى 810 رصيد للعرض المصمم بالصور بدقة 2K (10 تخطيط + 100 لكل صفحة) و1,680 رصيد لتعليق صوتي بصوتين (210 لكل صفحة). التنزيل لكل صفحة PNG وWAV مجاني، والتجميع باستخدام ffmpeg على جهازك لا يضيف تكلفة.

هل يمكن لواجهة برمجة تطبيقات التعليق الصوتي للشرائح استخدام صوتين مختلفين في عرض واحد؟

نعم. generate-narration مع mode: "multi" يأخذ speaker1Name، speaker2Name، speaker1Voice، وspeaker2Voice، ويتناوب المتحدثان عبر الشرائح. هناك 30 صوتًا للاختيار من بينها، بما في ذلك Kore، Puck، Zephyr، Charon، Aoede، وLeda. استخدم mode: "single" مع speakerName وvoice عندما يكون راوي واحد كافيًا، بنفس تكلفة 210 رصيد لكل صفحة.

ما هي نقاط النهاية التي يحتاجها خط أنابيب واجهة برمجة تطبيقات عرض فيديو مع تعليق صوتي؟

ثلاثة، بالترتيب: POST /api/v1/slides/create-pdf-slides (أو create-like-this مع referenceImageUrl) لتصميم العرض، POST /api/v1/slides/generate-narration على jobId الناتج لإضافة الصوت، وPOST /api/v1/slides/download-slides-pages-voices لجلب أزواج PNG وWAV. استعلم عبر GET /api/v1/jobs/{jobId} كل 5 إلى 10 ثوانٍ بين الخطوات. generate الخاص بـ Fast PPT ليس جزءًا من هذه السلسلة لأنه لا يمكن إضافة تعليق صوتي له.

هل يمكنني تقديم نفس التقرير الأسبوعي بعدة لغات؟

نعم. عيّن responseLanguage في create-pdf-slides إلى اسم لغة مثل "Spanish" أو "Japanese" ويُكتب نص الشريحة بتلك اللغة؛ التعليق الصوتي يتبع محتوى الشريحة. يدعم أكثر من 20 لغة. كل لغة مهمة عرض منفصلة، لذا العميل الذي يريد فيديوهات بالإنجليزية والإسبانية يدفع مقابل تشغيلتين بـ 2,490 رصيد.

كم يستغرق خط أنابيب يوم الاثنين لكل عميل؟

خطط لبضع دقائق لكل عميل: عرض من 8 صفحات بدقة 2K يستغرق بضع دقائق للإنشاء، التعليق الصوتي يضيف بضع دقائق أخرى، وتجميع ffmpeg عادة أقل من دقيقة لثماني مقاطع. الاستعلام كل 5 إلى 10 ثوانٍ ومعالجة العملاء واحدًا تلو الآخر يحترم حد 6 طلبات في الدقيقة، وتشغيل 50 عميلًا يبدأ الساعة 06:00 عادة ما ينتهي قبل الاجتماع الصباحي الأول.

الخطوات التالية

احصل على مفتاح API في 2slides.com/api. الأرصدة المجانية الـ 500 تغطي ملخصًا واحدًا مع تعليق صوتي كامل لتتمكن من التحقق من الخط قبل شراء حزمة، ثم أتمتة عروض تقارير التسويق لكل عميل على نفس الجدول.
تصفح الوصفات الأخرى حسب الفريق في منشور المحور، حالات استخدام واجهة برمجة تطبيقات العروض التقديمية بالذكاء الاصطناعي حسب الفريق.
نسخة المالية من هذا سير العمل، مع بيانات نهاية الشهر بدلاً من مقاييس الإعلانات، موجودة في أتمتة عروض التقارير المالية مع التعليق الصوتي بالذكاء الاصطناعي؛ لقواعد النص والتوقيت، اقرأ أفضل ممارسات التعليق الصوتي والفيديو للشرائح.

أتمتة عروض تقارير التسويق: واجهة برمجة التطبيقات Deck to Video (2026)

لمن هذا موجه

نظرة عامة على سير العمل

الخطوة 1: الحصول على مفتاح API وربط المجدول

الخطوة 2: سحب المقاييس ودع نموذج اللغة الكبير يكتب السرد من 8 شرائح

الخطوة 3: أتمتة تقرير الحملة باستخدام create-pdf-slides

الخطوة 4: صوتان مع واجهة برمجة التطبيقات للفيديو التعليقي

الخطوة 5: تحويل تقرير التسويق الأسبوعي إلى فيديو باستخدام ffmpeg

الخطوة 6: خط أنابيب Node.js لأتمتة عروض تقارير التسويق

اختيار نمط مرجعي

التكلفة

Fast PPT أم شرائح مصممة بالصور لهذا الاستخدام؟

الأخطاء الشائعة

الأسئلة المتكررة

كم تكلفة أتمتة تقرير تسويقي أسبوعي كفيديو مع تعليق صوتي؟

هل يمكن لواجهة برمجة تطبيقات التعليق الصوتي للشرائح استخدام صوتين مختلفين في عرض واحد؟

ما هي نقاط النهاية التي يحتاجها خط أنابيب واجهة برمجة تطبيقات عرض فيديو مع تعليق صوتي؟

هل يمكنني تقديم نفس التقرير الأسبوعي بعدة لغات؟

كم يستغرق خط أنابيب يوم الاثنين لكل عميل؟

الخطوات التالية

About 2Slides

Summarize with AI

Products

Features

Gallery

Templates

Integrations

Resources

Comparison