Créer une présentation Felo

Générez une présentation de façon asynchrone, puis exportez un fichier PPTX. Gardez les étapes de génération et d'export séparées : une tâche créée n'est pas encore un fichier terminé.

Tous les exemples utilisent FELO_API_KEY depuis l'aperçu. Les appels utilisent le solde de plateforme, et non les crédits Felo Pro. Les exemples de réponse sont illustratifs ; le contenu réel et les champs facultatifs varient.

1. Créer la présentation

POST /api/v1/data/ppts

Pour une première intégration, omettez les champs de contexte et de configuration. Un contexte créé via /v2 n'est pas automatiquement éligible à la réutilisation ici.

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 renvoie les identifiants à la racine :

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

Des identifiants supplémentaires tels que resource_id, stream_key et thread_short_id peuvent être présents. Une réponse de création réussie signifie que la tâche a été acceptée, pas que la génération est terminée. Le nombre de diapositives demandé est une instruction ; la facturation utilise le nombre réel de pages générées.

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

Lire les événements de génération avec SSE

Si la création renvoie une stream_key, connectez-vous immédiatement avec une clé API appartenant au même compte. Si aucune clé de flux n'est renvoyée, utilisez les requêtes de statut et de résultat ci-dessous.

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'

Lisez chaque événement SSE complet, décodez son JSON externe, puis traitez content. Un événement d'application answer contient du texte dans data.text ; finished signale l'achèvement de la génération dans le flux. Gérez aussi les signaux amont done, [DONE] et error. Si la connexion se ferme sans signal d'achèvement, interrogez le statut de la tâche.

Utilisez les règles d'analyse et l'exemple client de SuperAgent SSE, avec l'URL /api/v1/data/conversations/stream/{stream_key} de cette section. Lisez le résultat de la tâche après la fin du flux ; l'export PPTX reste une étape séparée. Ce point de terminaison n'active pas stream: true sur /api/v1/data/chat.

Durée de vie, propriété et facturation

• Les présentations expirent sept jours après leur création. Les requêtes et les exports ne prolongent pas cette période. Le expires_at de la présentation et le expires_at de l'URL signée de téléchargement décrivent des durées de vie différentes.
• Seul le compte API créateur peut accéder à ses tâches et présentations. Une ressource manquante ou inaccessible peut renvoyer 404 ; une ressource expirée ou supprimée peut renvoyer 410, ou 404 après nettoyage.
• La génération est facturée par page générée (ppt.generate). Avec la tarification par page, la création réserve le prix de dix pages, puis régularise la production réussie réelle et libère la réservation inutilisée. Votre compte doit disposer d'un solde disponible suffisant pour la réservation, même si l'invite demande moins de pages.
• L'export a un prix de requête séparé (ppt.export). Les requêtes de statut, de résultat, de statut d'export et la suppression ne créent aucun nouveau frais.
• Après un délai d'attente, interrogez la tâche enregistrée plutôt que de créer une autre présentation. Consultez Facturation et erreurs.