Felo Buat Presentasi

Hasilkan presentasi secara asinkron, lalu ekspor file PPTX. Pisahkan langkah pembuatan dan ekspor: tugas yang dibuat belum merupakan file yang selesai.

Semua contoh menggunakan FELO_API_KEY dari gambaran umum. Panggilan menggunakan saldo platform, bukan kredit Felo Pro. Contoh respons bersifat ilustratif; konten langsung dan bidang opsional bervariasi.

1. Buat presentasi

POST /api/v1/data/ppts

Untuk integrasi pertama, hilangkan bidang konteks dan konfigurasi. Konteks yang dibuat melalui /v2 tidak otomatis memenuhi syarat untuk digunakan kembali di sini.

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 mengembalikan pengenal di root:

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

Pengenal tambahan seperti resource_id, stream_key, dan thread_short_id mungkin ada. Respons pembuatan yang sukses berarti tugas telah diterima, bukan bahwa pembuatan telah selesai. Jumlah slide yang diminta adalah instruksi; penagihan menggunakan jumlah halaman yang sebenarnya dihasilkan.

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

Baca peristiwa pembuatan dengan SSE

Jika pembuatan mengembalikan stream_key, segera sambungkan dengan API Key yang dimiliki akun yang sama. Jika tidak ada stream key yang dikembalikan, gunakan kueri status dan hasil di bawah.

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'

Baca setiap event SSE yang lengkap, dekode JSON luarnya, lalu proses content. Event aplikasi answer membawa teks di data.text; finished menandakan selesainya pembuatan di stream. Tangani juga sinyal upstream done, [DONE], dan error. Jika koneksi ditutup tanpa sinyal selesai, kueri status tugas.

Gunakan aturan parsing dan contoh klien dalam SSE SuperAgent, dengan URL bagian ini /api/v1/data/conversations/stream/{stream_key}. Baca hasil tugas setelah stream berakhir; ekspor PPTX tetap merupakan langkah terpisah. Endpoint ini tidak mengaktifkan stream: true pada /api/v1/data/chat.

Masa hidup, kepemilikan, dan penagihan

• Presentasi kedaluwarsa tujuh hari setelah dibuat. Kueri dan ekspor tidak memperpanjang periode ini. expires_at presentasi dan expires_at URL unduhan bertanda tangan menjelaskan masa hidup yang berbeda.
• Hanya akun API yang membuat yang dapat mengakses tugas dan presentasinya. Resource yang hilang atau tidak dapat diakses dapat mengembalikan 404; resource yang kedaluwarsa atau dihapus dapat mengembalikan 410, atau 404 setelah pembersihan.
• Pembuatan ditagihkan per halaman yang dihasilkan (ppt.generate). Di bawah harga per halaman, pembuatan mencadangkan harga sepuluh halaman, lalu menyelesaikan output sukses aktual dan melepaskan cadangan yang tidak terpakai. Akun Anda membutuhkan saldo tersedia yang cukup untuk cadangan tersebut meskipun prompt meminta lebih sedikit halaman.
• Ekspor memiliki harga permintaan terpisah (ppt.export). Kueri status, kueri hasil, kueri status ekspor, dan penghapusan tidak menimbulkan biaya baru.
• Setelah waktu habis, kueri tugas yang disimpan, bukan membuat presentasi lain. Lihat Penagihan dan Kesalahan.