Felo API PlatformFelo API Platform

Felo Sunum Oluştur

Sağlayıcı: Felo · Platform bakiyesinden ödenir

Kimlik doğrulama ve kurulumFaturalandırma ve hatalarTam iş akışı kılavuzu

Bir sunumu eşzamansız olarak oluşturun, ardından bir PPTX dosyası dışa aktarın. Oluşturma ve dışa aktarma adımlarını ayrı tutun: oluşturulmuş bir görev henüz bitmiş bir dosya değildir.

Tüm örnekler genel bakış içindeki FELO_API_KEY’i kullanır. Çağrılar Felo Pro kredilerini değil, platform bakiyesini kullanır. Yanıt örnekleri açıklayıcıdır; canlı içerik ve isteğe bağlı alanlar değişebilir.

1. Sunumu oluşturun

POST /api/v1/data/ppts

AlanTürGerekliAnlamı
querystringEvetOluşturma yönergeleri, 1–25.000 karakter
stream_protocolstringHayırVarsayılan message_center_v1; normalde değiştirmeden bırakın
ppt_configobjectHayırİsteğe bağlı yapılandırma; mevcut uygulama ai_theme_id okur
livedoc_short_idstringHayırMevcut bağlam kimliği, en fazla 100 karakter; yerel API sahipliği ve süre dolumu kontrollerinden geçmelidir
resource_idsstring arrayHayırEn fazla 100 UUID kaynak kimliği; aynı bağlam erişim kontrollerine tabidir

İlk entegrasyon için bağlam ve yapılandırma alanlarını atlayın. /v2 üzerinden oluşturulan bir bağlam burada otomatik olarak yeniden kullanım için uygun değildir.

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/ppts" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Create a 5-slide introduction to retrieval augmented generation for software developers."}'

HTTP 200, kökte tanımlayıcılar döndürür:

{
  "task_id":"example-task-id",
  "ppt_business_id":"example-ppt-id",
  "livedoc_short_id":"example-livedoc-id",
  "expires_at":"2026-11-13T00:00:00Z"
}

resource_id, stream_key ve thread_short_id gibi ek tanımlayıcılar bulunabilir. Başarılı bir oluşturma yanıtı, görevin kabul edildiği anlamına gelir; oluşturmanın tamamlandığı anlamına gelmez. İstenen slayt sayısı bir yönergedir; faturalandırma gerçek oluşturulan sayfa sayısını kullanır.

TASK_ID="example-task-id"
PPT_ID="example-ppt-id"

SSE ile oluşturma olaylarını okuyun

Oluşturma bir stream_key döndürürse, aynı hesaba ait bir API Anahtarı ile hemen bağlanın. Herhangi bir stream key döndürülmezse, aşağıdaki durum ve sonuç sorgularını kullanın.

curl -N 'https://openapi.felo.ai/api/v1/data/conversations/stream/YOUR_STREAM_KEY?format=structured' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: text/event-stream'
Sorgu parametresiAnlamı
formatraw (varsayılan) content dizesini korur; structured geçerli JSON’u bir nesneye veya diziye çözer
offsetYeniden bağlanma için isteğe bağlı üst akış devam konumu; bunu yerel olay sayınızdan çıkarsamayın

Her tamamlanmış SSE olayını okuyun, dıştaki JSON’unu çözün, ardından content öğesini işleyin. Bir answer uygulama olayı, data.text içinde metin taşır; finished ise akışta oluşturmanın tamamlandığını belirtir. Ayrıca üst akış done, [DONE] ve error sinyallerini de işleyin. Bağlantı bir tamamlanma sinyali olmadan kapanırsa, görev durumunu sorgulayın.

Ayrıntıları ve istemci örneğini SuperAgent SSE bölümündeki ayrıştırma kurallarıyla kullanın; bu bölümün /api/v1/data/conversations/stream/{stream_key} URL’si için. Akış bittikten sonra görev sonucunu okuyun; PPTX dışa aktarma ayrı bir adımdır. Bu uç nokta /api/v1/data/chat üzerinde stream: true etkinleştirmez.

Yaşam süresi, sahiplik ve faturalandırma

  • Sunumların süresi oluşturulmadan yedi gün sonra dolar. Sorgular ve dışa aktarmalar bu süreyi uzatmaz. Sunum expires_at değeri ile imzalı indirme URL’sinin expires_at değeri farklı ömürleri tanımlar.
  • Yalnızca oluşturan API hesabı kendi görevlerine ve sunumlarına erişebilir. Eksik veya erişilemeyen bir kaynak 404 döndürebilir; süresi dolmuş veya silinmiş bir kaynak 410, ya da temizlemeden sonra 404 döndürebilir.
  • Oluşturma, oluşturulan sayfa başına (ppt.generate) faturalandırılır. Sayfa fiyatlandırmasında, oluşturma on sayfanın fiyatını ayırır, ardından gerçek başarılı çıktıyla kesinleşir ve kullanılmayan rezervasyonu serbest bırakır. İstem daha az sayfa istese bile hesabınızın bu rezervasyon için yeterli kullanılabilir bakiyesi olmalıdır.
  • Dışa aktarma ayrı bir istek fiyatına sahiptir (ppt.export). Durum sorguları, sonuç sorguları, dışa aktarma-durumu sorguları ve silme yeni bir ücret oluşturmaz.
  • Zaman aşımından sonra başka bir sunum oluşturmak yerine kaydedilmiş görevi sorgulayın. Faturalandırma ve Hatalar bölümüne bakın.

Yardım mı gerekiyor?