Skip to main content

Felo PPT API Artık Gerçek PPTX Dosyalarını Dışa Aktarıyor

· 7 dakika okuyun
Felo Search Tips Buddy
Felo Search Tips Buddy
Committed to answers at your fingertips

Felo OpenAPI'nin PPT Görev API'si, oluşturulan sunuları düzenlenebilir .pptx dosyaları olarak dışa aktarabiliyor. Tek bir API anahtarı, dört adımlı asenkron süreç ve bir indirme bağlantısı.

Aracınız bir konu araştırır, bir taslak oluşturur ve tamamlanmış bir slayt sunusu üretir. Tasarım aracına dokunmadan bu işlemi yapar. Ancak, ekibinizin PowerPoint'te açabileceği bir dosya sunamazdı.

Bu eksiklik giderildi. Felo OpenAPI artık oluşturulan sunuları gerçek .pptx dosyaları olarak dışa aktarıyor. PPT Görev API'si, Felo içinde düzenlenebilir slaytlar üretir; yeni dışa aktarma uç noktaları, bunları indirilebilir, düzenlenebilir ve paylaşılabilir bir PowerPoint dosyasına dönüştürür. Aynı API anahtarı, aynı asenkron desen, bir ek çağrı.

Şimdi deneyin: https://openapi.felo.ai/docs/api-reference/ppt-tasks

Felo PPT Görev API'si artık gerçek .pptx dosyalarını dışa aktarıyor: araştırmadan sunuya tek akışta, POST /v2/ppts/{id}/export, download_url 30 dakika geçerli

Neler değişti​

Bu güncellemeden önce, PPT Görev API'si bir Felo slayt URL'sinde sona ererdi. Bir sunu elde ederdiniz, ancak aktarım burada biterdi: sunuyu bir müşteriye, sınıfa veya kurula sunmak için biri sunuyu PowerPoint'te elle yeniden oluşturmak zorunda kalırdı.

Artık süreç tamamlanıyor. Bir PPT oluşturma görevi COMPLETED durumuna ulaştığında, bir dışa aktarma uç noktasını çağırır ve ikinci bir uç noktayı yoklarsınız. API, gerçek bir .pptx dosyasına işaret eden imzalı bir download_url döndürür — aynı sunu, herkesin kullandığı formatta.

Bu işlemi bir format dönüşümünden fazlası yapan iki özellik var:

  • Sunum düzenlenebilir. PDF değil, düz resim seti değil. Metin, düzenler ve tema yapısı PowerPoint'e aktarılır, böylece bir çalışma arkadaşı bir sayıyı değiştirebilir veya bir bölümü yeniden sıralayabilir.
  • Araştırma tamamlanmış olur. Felo'nun PPT oluşturması, sadece girdinizi slaytlara dökmez. Konuyu araştırır, kaynakları toplar, argümanı yapılandırır ve bir tema uygular. Sunum sunmaya hazır gelir, yeniden yazılması gereken bir ilk taslak değil.

Bu birleşim önemli. Çoğu araç ya iyi araştırır ve size metin verir, ya da iyi biçimlendirir ve size boş bir yapı sunar. Felo ikisini birden yapar ve sonucu dosya olarak sunar.

Dışa aktarma nasıl çalışır​

Dışa aktarma, PPT Görev API'sinin geri kalanıyla uyumlu şekilde asenkron ilerler. Bir iş gönderirsiniz, tamamlanana kadar yoklarsınız ve sonucu indirirsiniz.

Adım 1 — Sunuyu oluşturun​

Bir girdinizle PPT görevi oluşturun. Belirli bir görünüm isterseniz, önce mevcut temaları listeleyin ve tema kimliğini iletin.

POST https://openapi.felo.ai/v2/ppts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "query": "Q3 competitive landscape review, 12 pages",
  "ppt_config": {
    "ai_theme_id": "02968979-a69f-42c4-b136-de02c40ab2d7"
  }
}

Yanıt, bir task_id ve bir ppt_business_id döndürür. İkisini de saklayın — oluşturmayı yoklamak için görev kimliğine, dışa aktarmak için iş kimliğine ihtiyacınız var.

Adım 2 — Sunu hazır olana kadar yoklayın​

GET https://openapi.felo.ai/v2/tasks/{task_id}/historical
Authorization: Bearer YOUR_API_KEY

Her 2–5 saniyede bir yoklayın. task_status değeri COMPLETED olduğunda sunu oluşur ve dışa aktarabilirsiniz. Slaytları önce Felo'da önizlemek isterseniz, yanında bir ppt_url gelir.

Adım 3 — Dışa aktarma işlemini başlatın​

POST https://openapi.felo.ai/v2/ppts/YOUR_PPT_BUSINESS_ID/export
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{}

Tüm istek gövdesi budur: {}. Dışa aktarma arka planda çalışır.

Adım 4 — Dışa aktarmayı yoklayın ve indirin​

GET https://openapi.felo.ai/v2/ppts/{ppt_business_id}/export
Authorization: Bearer YOUR_API_KEY

Her 2–5 saniyede bir yoklayın. data.status sırasıyla NOT_STARTED, PROCESSING ve COMPLETED değerlerini alır. Sadece COMPLETED istediğiniz yükü taşır:

{
  "status": "ok",
  "message": null,
  "data": {
    "status": "COMPLETED",
    "download_url": "https://example.com/presentation.pptx?signature=...",
    "expires_at": "2026-09-29T10:30:00Z"
  }
}

Dosyayı download_url üzerinden indirin ve işlem tamamlanır.

PPTX dışa aktarma akışı: POST /v2/ppts sunuyu oluşturur, GET /v2/tasks/{task_id}/historical tamamlanana kadar yoklar, POST /v2/ppts/{id}/export dışa aktarmayı başlatır, GET /v2/ppts/{id}/export 30 dakika geçerli download_url döndürür

Gönderimden önce bilinmesi gereken dört detay​

İndirme bağlantısı, oluşturulduktan sonra 30 dakika geçerli olur. Bu imzalı bir URL'dir, kalıcı bir bağlantı değildir. Süresi dolarsa, GET dışa aktarma uç noktasını tekrar çağırın — bu, PPTX'i yeniden üretmeden yeni bir bağlantı verir ve ek maliyet oluşturmaz.

Tamamlandıktan sonra dışa aktarmayı tekrar çalıştırmak bir kredi harcar. Dışa aktarma devam ederken POST'u tekrarlamak güvenlidir ve ikinci bir iş başlatmaz. Ancak dışa aktarma tamamlandıktan sonra POST'u tekrar çağırmak dosyayı yeniden üretir ve mevcut PPT dışa aktarma kredisi kullanılır. Sadece yeni bir bağlantı gerekiyorsa GET'i kullanın.

API anahtarı sununun sahibi olmalı. Dışa aktarma, PPT'yi oluşturan anahtarla sınırlıdır. Sunuyu oluşturmayan bir anahtar dışa aktarma yapamaz, bu da sunuları oluşturan hesabın içinde tutar.

Başarısızlıklar tekrar denenebilir. FAILED dışa aktarma, aynı POST ile tekrar gönderilebilir. Yetersiz kredi HTTP 402 döndürür; hız sınırı HTTP 429 döndürür ve kısa bir beklemeden sonra tekrar denenebilir.

Bu özellik aracılar için neden önemli​

Önemli olan dosya formatı değil. Araştırmadan dosyaya tam bir süreç sunar.

Araştırıp dışa aktarabilen bir aracı, artık tüm döngüyü kendi başına tamamlar:

  • Haftalık iş incelemeleri — haftanın metriklerini çeker, sayıların arkasındaki bağlamı araştırır, sunuyu oluşturur, dışa aktarır ve .pptx dosyasını pazartesi toplantısından önce ortak sürücüye bırakır.
  • Müşteri teslimatları — bir brifi kaynaklı, temalı bir sunuya dönüştürür ve müşterinin kendi markasını ekleyebileceği düzenlenebilir bir dosya sunar.
  • Satış destek materyali — hesap araştırmasından her aday için özel bir sunu oluşturur, her birini dışa aktarır ve otomatik olarak CRM kaydına ekler.
  • Kurs ve eğitim materyali — bir konuyu araştırır, ders olarak yapılandırır, eğitmenin sınıf öncesi düzenleyebileceği slaytları dışa aktarır.

Her durumda insanın görevi inceleme ve düzeltmeye dönüşür. Kimse boş bir slayttan başlamaz.

Yoklama döngüsünü kendiniz yazmak istemezseniz, Felo PPT Skill bunu üstlenir. Felo AI aracı paketini kurun ve aracınız tek bir yetenek olarak sunu oluşturma, yoklama ve dışa aktarma işlemlerini kazanır — yukarıda anlatılan süreç, aracının doğrudan çağırabileceği şekilde paketlenir.

Başlangıç​

Dışa aktarma, PPT Görev API'sinde canlı ve her Felo OpenAPI anahtarıyla kullanılabilir.

  1. Felo OpenAPI panosundan API anahtarınızı alın.
  2. PPT Görev API referansını okuyun — Export PPTX bölümü tam istek ve yanıt biçimlerini içerir.
  3. Bir sunu oluşturun, dışa aktarın ve dosyayı PowerPoint'te açın.

Hızlı yol için Felo PPT Skill'i kurun ve aracınızın tüm süreci çalıştırmasına izin verin.

Felo OpenAPI ile geliştirmeye başlayın: https://openapi.felo.ai

Sıkça sorulan sorular​

Dışa aktarılan dosya PowerPoint'te gerçekten düzenlenebilir mi? Evet. Dışa aktarma standart bir .pptx dosyası üretir. Metin, düzen ve tema yapısı aktarılır, böylece sunu PowerPoint, Google Slides veya Keynote'ta düzenlenebilir.

Dışa aktarma ekstra maliyet oluşturur mu? Sunuyu oluşturduktan sonra dışa aktarma mevcut PPT dışa aktarma kredisi kullanır. Yetersiz kredi HTTP 402 döndürür. GET ile yeni bir indirme bağlantısı almak dosyayı yeniden üretmez ve ek ücret eklemez.

İndirme bağlantısı ne kadar geçerli? Oluşturulduktan sonra 30 dakika. Yeni bir bağlantı için GET dışa aktarma uç noktasını tekrar çağırın.

Farklı bir API anahtarıyla oluşturulan sunuyu dışa aktarabilir miyim? Hayır. Dışa aktarma isteğini yapan API anahtarı PPT'nin sahibi olmalı.

Dışa aktarma başarısız olursa ne olur? data.status değeri FAILED döner. POST dışa aktarma isteğini tekrar göndererek yeniden deneyin.

Bu yazı şu dillerde de mevcut: English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Italiano, ไทย, Español, বাংলা and Português.