Felo vytvořit prezentaci
Poskytovatel: Felo · Hrazeno ze zůstatku platformy
Vytvořte prezentaci asynchronně a poté exportujte soubor PPTX. Udržujte kroky generování a exportu oddělené: vytvořená úloha ještě není hotový soubor.
Všechny příklady používají FELO_API_KEY z přehledu. Volání používají zůstatek platformy, nikoli Felo Pro credits. Příklady odpovědí jsou ilustrativní; živý obsah a volitelná pole se liší.
1. Vytvořte prezentaci
POST /api/v1/data/ppts
| Pole | Typ | Povinné | Význam |
|---|---|---|---|
query | string | Ano | Pokyny k vygenerování, 1–25 000 znaků |
stream_protocol | string | Ne | Výchozí message_center_v1; obvykle ponechte beze změny |
ppt_config | objekt | Ne | Volitelná konfigurace; současná implementace čte ai_theme_id |
livedoc_short_id | string | Ne | ID existujícího kontextu, až 100 znaků; musí projít nativními kontrolami vlastnictví API a vypršení |
resource_ids | pole stringů | Ne | Až 100 UUID resource ID; podléhá stejným kontrolám přístupu ke kontextu |
Pro první integraci vynechte pole kontextu a konfigurace. Kontext vytvořený přes /v2 zde není automaticky způsobilý k opětovnému použití.
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 vrací identifikátory v kořeni:
{
"task_id":"example-task-id",
"ppt_business_id":"example-ppt-id",
"livedoc_short_id":"example-livedoc-id",
"expires_at":"2026-11-13T00:00:00Z"
}Mohou být přítomny další identifikátory, jako resource_id, stream_key a thread_short_id. Úspěšná odpověď na vytvoření znamená, že úloha byla přijata, nikoli že generování bylo dokončeno. Požadovaný počet snímků je instrukce; účtování používá skutečný počet vygenerovaných stran.
TASK_ID="example-task-id"
PPT_ID="example-ppt-id"Čtení událostí generování pomocí SSE
Pokud vytvoření vrátí stream_key, připojte se okamžitě pomocí API Key patřícího stejnému účtu. Pokud není vrácen žádný stream key, použijte níže uvedené dotazy na stav a výsledek.
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'| Parametr dotazu | Význam |
|---|---|
format | raw (výchozí) zachová řetězec content; structured dekóduje platný JSON na objekt nebo pole |
offset | Volitelná upstream pozice pro obnovení po opětovném připojení; neodvozujte ji z počtu místních událostí |
Přečtěte každou kompletní SSE událost, dekódujte její vnější JSON a poté zpracujte content. Událost aplikace answer obsahuje text v data.text; finished signalizuje dokončení generování v proudu. Zpracujte také upstream signály done, [DONE] a error. Pokud se spojení uzavře bez signálu dokončení, dotazujte stav úlohy.
Použijte pravidla parsování a ukázku klienta v SuperAgent SSE s URL této sekce /api/v1/data/conversations/stream/{stream_key}. Po skončení streamu přečtěte výsledek úlohy; export PPTX zůstává samostatným krokem. Tento koncový bod nepovoluje stream: true na /api/v1/data/chat.
Životnost, vlastnictví a účtování
- Prezentace vyprší sedm dní po vytvoření. Dotazy a exporty tuto dobu neprodlužují.
expires_atprezentace aexpires_atpodepsané URL ke stažení popisují odlišné životnosti. - K úlohám a prezentacím může přistupovat pouze účet API, který je vytvořil. Chybějící nebo nepřístupný zdroj může vrátit 404; vypršelý nebo smazaný zdroj může vrátit 410, nebo po vyčištění 404.
- Generování je účtováno za vygenerovanou stránku (
ppt.generate). Při ceně za stránku rezervuje vytvoření cenu deseti stránek, poté zúčtuje skutečný úspěšný výstup a uvolní nevyužitou rezervaci. Váš účet potřebuje dostatečný dostupný zůstatek pro rezervaci, i když prompt požaduje méně stránek. - Export má samostatnou cenu za požadavek (
ppt.export). Dotazy na stav, dotazy na výsledky, dotazy na stav exportu a smazání nevytvářejí nový poplatek. - Po timeoutu dotazujte uloženou úlohu místo vytváření další prezentace. Viz Účtování a chyby.