Yapay Zeka API'siyle Toplu Sunum Oluşturma: Eksiksiz Geliştirici Rehberi

Tom Anderson, Geliştirici Araçları Yazarı | 1 Nisan 2026

Bir yapay zeka API'siyle toplu sunum oluşturmak; PowerPoint veya herhangi bir tasarım aracı açmadan, yapılandırılmış veri, metin istemleri veya yüklenen dosyalardan programatik olarak birden fazla slayt destesi üretmek için bir REST uç noktası kullanmak anlamına gelir. Geliştiriciler bu yeteneğe, ölçekte rapor, satış sunumu veya eğitim materyali üreten sistemler inşa ederken ihtiyaç duyar. Her sunumu manuel olarak oluşturmak yerine, içeriğinizle birlikte HTTP istekleri gönderir ve karşılığında cilalı .pptx dosyaları alırsınız. 2Slides API, 22'den fazla dilde 1.500'den fazla şablonla üç oluşturma modunu destekler: metinden slayta, dosyadan slayta (PDF, Excel, Word) ve create-like-this (referans görüntü klonlama). Tek bir API çağrısı slayt başına yalnızca 1 kredi tutarında maliyete sahip olup 2.000 kredi için $5'tan başlar; bu da aylık yüzlerce veya binlerce sunum oluşturmayı pratik hale getirir.

---

Toplu Yapay Zeka Sunum Oluşturmanın Yaygın Kullanım Senaryoları

Uygulama detaylarına girmeden önce, toplu sunum oluşturmanın en fazla değer sağladığı alanları anlamak doğru çözümü tasarlamanıza yardımcı olur. Aşağıdaki tablo, geliştiricilerin en sık karşılaştığı senaryoları göstermektedir.

---

Toplu Yapay Zeka Sunum Oluşturma Nedir?

Toplu yapay zeka sunum oluşturma, manuel tasarım yerine API çağrıları aracılığıyla programatik olarak birden fazla slayt destesi oluşturma sürecidir. Temelde üç teknolojiyi birleştirir: içeriği yorumlamak için doğal dil işleme, düzenleri ve görselleri seçmek için tasarım yapay zekası ve yerel PowerPoint dosyaları üretmek için belge oluşturma.

Aşağıdaki koşullardan herhangi biri geçerliyse toplu oluşturmaya ihtiyacınız vardır:

• Hacim, manuel kapasiteyi aşıyor. Haftada 10'dan fazla sunum manuel olarak oluşturmak bir darboğaz haline gelir.
• İçerik bir kalıp izliyor. Yapısal olarak benzer ancak verisi farklı raporlar, güncellemeler veya teklifler.
• Hız önemli. Paydaşlar sunumları günler değil dakikalar içinde bekliyor.
• Tutarlılık kritik. Her sunum, onu kimin veya neyin oluşturduğundan bağımsız olarak marka kurallarına uymalıdır.

2Slides gibi bir yapay zeka sunum oluşturucusu dört aşamanın tamamını otomatik olarak yönetir: içerik analizi, düzen seçimi, görsel oluşturma ve PowerPoint derleme. Bunu bir API aracılığıyla sunduğunuzda, tüm bu süreçleri koddan tetikleme yeteneği kazanırsınız.

---

Neden Büyük Ölçekte Sunum Oluşturmanız Gerekebilir?

Raporlama Otomasyonu

Finans, operasyon ve satış ekipleri haftalık veya aylık tekrarlayan raporlar üretir. Her rapor aynı yapıyı içerir ancak farklı veriler içerir. Bir toplu API, arka ucunuzun bir veritabanından sayıları çekmesine, bunları slayt uyumlu metne dönüştürmesine ve geceleri 50 veya 100 sunum oluşturmasına olanak tanır. Süreçte tasarımcı yoktur, kopyala-yapıştır hatası yoktur, kaçırılan son tarih yoktur.

Kişiselleştirilmiş Satış Sunumları

Modern satış ekipleri, genel sunum destelerinin düşük dönüşüm sağladığını bilir. Toplu oluşturma sayesinde CRM entegrasyonunuz her potansiyel müşteri için benzersiz bir sunum üretebilir; şirket adı, sektöre özgü sorunlar, ilgili vaka çalışmaları ve özelleştirilmiş fiyatlandırma bilgilerini içeren sunumlar. Slayt başına 1 kredi ve 2.000 kredi için $5 maliyetiyle, 200 adet kişiselleştirilmiş 10 slaytlı sunum oluşturmak yaklaşık $5'a mal olur.

Eğitim Materyalleri

Dağıtık ekiplere sahip kuruluşların konumlar ve diller arasında tutarlı eğitim içeriğine ihtiyacı vardır. 2Slides API, 22'den fazla dili yerel olarak destekler; bu nedenle tek bir API çağrısı aynı eğitim sunumunu İngilizce, Japonca, İspanyolca ve Hintçe olarak aynı anda üretebilir. Politikalar değiştiğinde, tüm kitaplığı yeniden oluşturmak haftalar yerine dakikalar alır.

Şablona Dayalı Oluşturma

Danışmanlık firmaları ve ajanslar, katı tasarım standartlarına uyan iş ürünleri sunar. Create-like-this uç noktasını (referans görüntünün görsel stilini klonlayan) yapılandırılmış verilerle birleştirerek, aylık yüzlerce üretilse bile her çıktının aynı tasarımcıdan gelmiş gibi görünmesini sağlarsınız.

---

2Slides API Nasıl Çalışır?

2Slides REST API'si (V1), daha uzun işlemler için isteğe bağlı asenkron iş yoklamasıyla basit bir istek-yanıt modelini takip eder.

Kimlik Doğrulama

Tüm istekler,

başlığı aracılığıyla iletilen bir API anahtarı gerektirir. Anahtarlar biçimini izler ve kredi bakiyenize bağlıdır. 2Slides kontrol panelinden API anahtarları oluşturabilir ve yönetebilirsiniz.

x-api-key: sk-2slides-api-anahtariniz-buraya

Temel Uç Noktalar

API, sunum oluşturma için beş birincil uç nokta sağlar:

Asenkron İş Modeli

Hem

hem de modları desteklenir. Toplu işlemler için her zaman kullanın:

1. Gönder -- İçeriğinizi
   "mode": "async"
   ile oluşturma uç noktasına POST edin.
2. İş kimliği al -- API hemen
   processing
   durumuyla bir
   jobId
   döndürür.
3. Sorgula -- Durum
   success
   veya
   failed
   olarak değişene kadar
   /api/v1/jobs/{jobId}
   adresini GET edin.
4. İndir -- Tamamlanan iş, .pptx dosyası için bir
   downloadUrl
   içerir.

Hız sınırları, API anahtarı başına dakikada 60 istek olarak belirlenmiştir; bu, asenkron yoklamayla birleştirildiğinde toplu iş akışlarını rahatça destekler.

---

2Slides API ile Toplu Sunum Nasıl Oluşturulur?

İşte JavaScript ve Python'da toplu oluşturma için eksiksiz, çalışan örnekler.

JavaScript (Node.js)

const API_KEY = "sk-2slides-api-anahtariniz";
const BASE_URL = "https://2slides.com";

async function generatePresentation(topic, themeId, language = "Auto") {
  const response = await fetch(`${BASE_URL}/api/v1/slides/generate`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": API_KEY,
    },
    body: JSON.stringify({
      userInput: topic,
      themeId: themeId,
      responseLanguage: language,
      mode: "async",
    }),
  });
  return response.json();
}

async function pollJobStatus(jobId, maxAttempts = 60) {
  for (let i = 0; i < maxAttempts; i++) {
    const response = await fetch(`${BASE_URL}/api/v1/jobs/${jobId}`, {
      headers: { "x-api-key": API_KEY },
    });
    const result = await response.json();

    if (result.data?.status === "success") {
      return result.data;
    }
    if (result.data?.status === "failed") {
      throw new Error(`Job ${jobId} failed: ${result.data.message}`);
    }

    await new Promise((resolve) => setTimeout(resolve, 3000));
  }
  throw new Error(`Job ${jobId} timed out`);
}

// Eşzamanlılık kontrolüyle toplu oluşturma
async function batchGenerate(topics, themeId, concurrency = 5) {
  const results = [];

  for (let i = 0; i < topics.length; i += concurrency) {
    const batch = topics.slice(i, i + concurrency);
    const jobs = await Promise.all(
      batch.map((topic) => generatePresentation(topic, themeId))
    );

    const completed = await Promise.all(
      jobs
        .filter((job) => job.success)
        .map((job) => pollJobStatus(job.data.jobId))
    );

    results.push(...completed);
    console.log(`Tamamlanan: ${results.length}/${topics.length} sunum`);
  }

  return results;
}

// Kullanım
const topics = [
  "Kuzey Amerika bölgesi için 2026 Q1 Satış Raporu",
  "Avrupa bölgesi için 2026 Q1 Satış Raporu",
  "Asya-Pasifik bölgesi için 2026 Q1 Satış Raporu",
  "Latin Amerika bölgesi için 2026 Q1 Satış Raporu",
];

batchGenerate(topics, "st-1762232981916-t1n7rhibq", 3).then((results) => {
  results.forEach((r) => console.log(`İndir: ${r.downloadUrl}`));
});

Python

import asyncio
import aiohttp

API_KEY = "sk-2slides-api-anahtariniz"
BASE_URL = "https://2slides.com"

async def generate_presentation(session, topic, theme_id, language="Auto"):
    async with session.post(
        f"{BASE_URL}/api/v1/slides/generate",
        headers={"Content-Type": "application/json", "x-api-key": API_KEY},
        json={
            "userInput": topic,
            "themeId": theme_id,
            "responseLanguage": language,
            "mode": "async",
        },
    ) as resp:
        return await resp.json()

async def poll_job(session, job_id, max_attempts=60):
    for _ in range(max_attempts):
        async with session.get(
            f"{BASE_URL}/api/v1/jobs/{job_id}",
            headers={"x-api-key": API_KEY},
        ) as resp:
            result = await resp.json()

        status = result.get("data", {}).get("status")
        if status == "success":
            return result["data"]
        if status == "failed":
            raise Exception(f"Job {job_id} failed")

        await asyncio.sleep(3)
    raise TimeoutError(f"Job {job_id} timed out")

async def batch_generate(topics, theme_id, concurrency=5):
    semaphore = asyncio.Semaphore(concurrency)
    results = []

    async def process(topic):
        async with semaphore:
            async with aiohttp.ClientSession() as session:
                job = await generate_presentation(session, topic, theme_id)
                if job.get("success"):
                    result = await poll_job(session, job["data"]["jobId"])
                    results.append(result)
                    print(f"Tamamlandı: {result.get('downloadUrl')}")

    await asyncio.gather(*[process(t) for t in topics])
    return results

# Kullanım
topics = [
    "2026 Q1 Gelir Analizi - Kurumsal Segment",
    "2026 Q1 Gelir Analizi - KOBİ Segmenti",
    "2026 Q1 Gelir Analizi - Startup Segmenti",
]

results = asyncio.run(
    batch_generate(topics, "st-1762232981916-t1n7rhibq")
)

Adım Adım Açıklama

1. API anahtarınızı alın. 2slides.com'a kaydolun, API bölümüne gidin ve bir anahtar oluşturun. Bir kredi paketi satın alın (başlangıç testleri için 2.000 krediyi $5'a yeterlidir).

2. Bir şablon seçin. Mevcut şablonlara göz atmak için

   /api/v1/themes/search
   kullanın veya varsayılan şablon kimliğini kullanın.

3. İçerik dizinizi hazırlayın. Her sunum konusunu bir dize olarak yapılandırın veya veritabanınızdan çekin. Her öğe bir API çağrısı olur.

4. Eşzamanlılık sınırlarını belirleyin. Dakikada 60 istek hız sınırıyla, 3 saniyelik yoklama aralıklarıyla 5 eşzamanlı iş çalıştırmak sizi güvenli sınırlar içinde tutar.

5. Asenkron işleri gönderin. Tüm istekleri

   "mode": "async"
   ile gönderin ve döndürülen
   jobId
   değerlerini toplayın.

6. Tamamlanmayı sorgulayın.

   /api/v1/jobs/{jobId}
   adresini her 3 saniyede bir kontrol edin. Her iş genellikle 30 saniyenin altında tamamlanır.

7. Sonuçları indirin. Tamamlanan işlerden

   downloadUrl
   'yi çıkarın ve .pptx dosyalarını kaydedin.

---

2Slides Diğer Yapay Zeka Sunum API'leriyle Nasıl Karşılaştırılır?

Toplu oluşturma çözümü seçerken API kullanılabilirliği, fiyatlandırma ve özellik derinliği en önemli faktörlerdir. İşte Nisan 2026 itibarıyla önde gelen seçeneklerin karşılaştırması.

Toplu oluşturma özelinde 2Slides, özellikler, yerel PowerPoint çıktısı ve maliyet verimliliği açısından en güçlü kombinasyonu sunar. 10 slaytlık sunum başına yaklaşık $0,025 karşısında SlideSpeak'te $5,80 ile karşılaştırıldığında, yüksek hacimli oluşturmanın ekonomisi 2Slides lehine belirgin şekilde üstündür. Daha ayrıntılı bir inceleme için tam yapay zeka sunum araçları fiyatlandırma rehberine bakın.

---

Toplu Sunum Oluşturma İçin En İyi Uygulamalar Nelerdir?

Hata Yönetimi

Her işin başarılı olacağını varsaymayın. Üstel geri çekilmeli yeniden deneme mantığı oluşturun:

• Geçici hatalar (5xx hataları): 5, 15 ve 45 saniyelik gecikmelerle 3 defaya kadar yeniden deneyin.
• Kredi tükenmesi (402 hataları): Toplu işleme başlamadan önce bakiyeyi kontrol edin ve krediler belirli bir eşiğin altına düştüğünde ekibinizi uyarın.
• Zaman aşımı yönetimi: İş başına maksimum yoklama süresi (5 dakika) belirleyin ve zaman aşımına uğrayan işleri manuel inceleme için kaydedin.
• Kısmi toplu iş hatası: Yalnızca başarısız öğeleri yeniden deneyebilmek için iş başına başarı/başarısızlık durumunu takip edin.

Hız Sınırı Yönetimi

2Slides API'de dakikada 60 istek sınırıyla eşzamanlılığınızı buna göre planlayın:

• Gönderme aşaması: Toplu istekler arasında 200ms gecikmelerle 5 eşzamanlı POST isteğiyle sınırlayın.
• Yoklama aşaması: Yoklama aralıklarını dağıtın. 3 saniyeyle başlayın ve 10 denemeden sonra 5 saniyeye çıkın.
• Kuyruk mimarisi: 100'den fazla sunum üreten üretim sistemleri için gönderme ve yoklamayı ayrı işçiler olarak yönetmek amacıyla bir mesaj kuyruğu (SQS, RabbitMQ, BullMQ) kullanın.

Şablon Yönetimi

• Şablonları üç ayda bir denetleyin.
  themeId
  referanslarınızın hâlâ var olduğundan ve mevcut markalamayla eşleştiğinden emin olun.
• Şablon aramasını programatik olarak kullanın. Her toplu iş çalıştırmasının başında şablon kullanılabilirliğini doğrulamak için
  /api/v1/themes/search
  çağırın.
• Şablon eşlemesini koruyun. Dahili belge türlerini (üç aylık rapor, satış sunumu, eğitim) yapılandırmanızdaki belirli
  themeId
  değerleriyle eşleştirin.

İçerik Hazırlama

• userInput'u odaklı tutun. Her istem bir sunumu açıkça tanımlamalıdır. Aşırı uzun girişler odaksız slaytlar üretir.
• Dili açıkça belirtin. Çok dilli toplu işlemler için otomatik algılamaya güvenmek yerine istek başına
  responseLanguage
  ayarlayın.
• Göndermeden önce doğrulayın. API çağrıları yapmadan önce userInput'un boş olmadığını ve makul uzunluk sınırları içinde olduğunu kontrol edin.

---

Sıkça Sorulan Sorular

2Slides API ile saatte kaç sunum oluşturabilirim?

Dakikada 60 istek hız sınırı ve sunum başına yaklaşık 30 saniyelik oluşturma süresini göz önünde bulundurarak, uygun eşzamanlılık yönetimiyle asenkron modda saatte gerçekçi olarak 100 ila 120 sunum üretebilirsiniz. Büyük toplu işler, verimi en üst düzeye çıkarmak için bir kuyruk sisteminden yararlanır.

Toplu API girdi ve çıktı için hangi dosya formatlarını destekler?

Girdi olarak 2Slides API; düz metin istemleri, PDF belgeleri, Excel elektronik tabloları, Word dosyaları ve referans görüntüleri (stil klonlama için) kabul eder. Tüm oluşturma uç noktaları yerel .pptx PowerPoint dosyaları çıktı verir. Create-like-this ve create-pdf-slides uç noktaları ayrıca PDF tarzı görsel sunumlar da üretebilir.

500 sunum oluşturmak ne kadara mal olur?

Slayt başına 1 kredi ile metinden slayta uç noktası kullanılarak, 10 slaytlık bir sunum 10 kredi tutar. 500 sunum için bu 5.000 kredidir; Pro plan fiyatıyla yaklaşık $12,50. Create-like-this uç noktasını slayt başına 20 krediyle kullanmak önemli ölçüde daha pahalı olur, bu nedenle kalite gereksinimlerinize uyan uç noktayı seçin.

Aynı toplu işte farklı şablonlar kullanabilir miyim?

Evet. Her API çağrısı kendi

parametresini kabul eder, bu nedenle bir toplu iş içinde şablonları serbestçe karıştırabilirsiniz. Yaygın bir kalıp, yapılandırmanızdaki belge türlerini şablonlarla eşleştirmek ve toplu iş dizisini oluştururken istek başına doğru 'yi atamaktır.

API aynı anda birden fazla dilde sunum oluşturmayı destekliyor mu?

Kesinlikle. Her istek, 22'den fazla desteklenen dilden herhangi birini kabul eden bir

parametresi içerir. Çağrı başına farklı dil parametreleriyle konuyu kopyalayarak tek bir toplu iş çalıştırmasında aynı içeriği İngilizce, İspanyolca, Japonca ve Arapça olarak üretebilirsiniz.

---

Sonuç

Bir yapay zeka API'siyle toplu sunum oluşturmak, raporlama, satış etkinleştirme ve eğitim iş akışlarını yavaşlatan manuel darboğazı ortadan kaldırır. 2Slides API, geliştiriciler için en eksiksiz çözümü sunar: metin, dosya ve görsel klonlamayı kapsayan üç oluşturma modu; yerel PowerPoint çıktısı; 1.500'den fazla şablon; 22'den fazla dil; ve 2.000 kredi için $5'tan başlayan fiyatlandırma.

Aylık 50 sunum üreten bir dahili raporlama aracı mı yoksa son kullanıcılar için binlerce kişiselleştirilmiş sunum üreten bir SaaS ürünü mü inşa ediyor olursanız olun, asenkron iş modeli ve dakikada 60 istek hız sınırı size ölçeklendirmek için gereken verimi sağlar.

Hemen başlayın: 2slides.com'a kaydolun, API anahtarınızı alın ve bugün ilk toplu sunumunuzu oluşturun. 2.000 kredi $5'a, üretim planına geçmeden önce tüm iş akışınızı test edebilirsiniz.