Felo API PlatformFelo API Platform

Stato esportazione Felo

Provider: Felo · Pagato con il saldo della piattaforma

Autenticazione e configurazioneFatturazione ed erroriGuida completa al workflow

Genera una presentazione in modo asincrono, poi esporta un file PPTX. Mantieni separati i passaggi di generazione ed esportazione: un task creato non è ancora un file completato.

Tutti gli esempi usano FELO_API_KEY dalla panoramica. Le chiamate usano il saldo della piattaforma, non i crediti Felo Pro. Gli esempi di risposta sono illustrativi; il contenuto live e i campi opzionali variano.

Usa gli identificatori restituiti quando crei il task. Imposta TASK_ID su task_id e PPT_ID su ppt_business_id; anche {business_id} significa ppt_business_id.

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

5. Interroga l'esportazione e scarica

GET /api/v1/data/ppts/{business_id}/export

curl -sS --request GET "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID/export" \
  -H "Authorization: Bearer $FELO_API_KEY"
StatoAzione successiva
NOT_STARTEDInvia l'esportazione una volta
PROCESSINGAttendi, poi interroga di nuovo con GET
COMPLETEDLeggi download_url e scarica il file
FAILEDEsamina l'errore e lo stato del task prima di inviare una nuova esportazione
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

L'URL di esempio è illustrativo. Usa l'URL firmato effettivo restituito dalla risposta. È valido per 30 minuti; lo stato di esportazione GET può restituire un link تازه mentre la presentazione rimane disponibile. Salva il file entro la sua durata di validità. Non inviare la tua chiave API Felo all'host di download del file.

Durata, proprietà e fatturazione

  • Le presentazioni scadono sette giorni dopo la creazione. Le query e le esportazioni non estendono questo periodo. L'expires_at della presentazione e l'expires_at dell'URL di download firmato descrivono durate diverse.
  • Solo l'account API che ha creato la presentazione può accedere ai propri task e presentazioni. Una risorsa mancante o non accessibile può restituire 404; una risorsa scaduta o eliminata può restituire 410, oppure 404 dopo la pulizia.
  • La generazione è fatturata per pagina generata (ppt.generate). Con la tariffazione per pagina, la creazione riserva il prezzo di dieci pagine, poi effettua il saldo dell'output effettivamente riuscito e libera la riserva inutilizzata. Il tuo account deve avere saldo disponibile sufficiente per la riserva anche se il prompt richiede meno pagine.
  • L'esportazione ha un prezzo separato per richiesta (ppt.export). Le query di stato, le query di risultato, le query di stato esportazione e l'eliminazione non creano nuovi addebiti.
  • Dopo un timeout, interroga il task salvato invece di creare un'altra presentazione. Vedi Fatturazione ed errori.

Serve aiuto?