OpenAPI účtování a chyby

Tato stránka se vztahuje na /api/v1/data/*, exkluzivní API platformy Felo OpenAPI. Volání používají zůstatek platformy, kreditový zůstatek služeb v USD. Nespotřebovávají Felo Pro credits. Starší Felo APIs pod /v2 používají Pro credits.

Přečtěte aktuální ceny

curl -sS https://openapi.felo.ai/api/v1/data/prices

Tento veřejný koncový bod nevyžaduje klíč. Položky porovnávejte podle ID operace a čtěte aktuální sazbu a účtovací jednotku; nepředpokládejte, že každá operace stojí stejně, ani nezamrazujte sazbu z příkladu do své aplikace.

Bezplatný dotaz na stav nedělá samotné generování ani export bezplatnými. U X může stránkování a zanořené vrácené záznamy zvýšit zpoplatněné použití.

Zůstatek a rezervace

Před provedením může služba rezervovat dostatečný zůstatek pro operaci. Úspěšná práce se zúčtuje proti této rezervaci; potvrzené selhání ji uvolní. U asynchronních úloh vrácení ID neznamená, že je účtování už konečné.

Cenotvorba za stránky PPT při vytvoření rezervuje deset stránek. Úspěšné generování zúčtuje skutečný výstup a uvolní nevyužité prostředky. Generování a export jsou samostatné poplatky. Viz workflow PPT pro chování při opakovaném exportu.

Pokud je provedení nebo zúčtování nejisté, může rezervace zůstat čekající, zatímco služba vše vyrovnává. Nepovažujte každý timeout nebo 5xx za důkaz, že se nic nestalo nebo že opakovaný požadavek je zdarma.

Zkontrolujte svůj dostupný zůstatek a využití v Console Billing. Pro pokyny k dobití na úrovni účtu viz Billing and Credits.

Dotazování využití peněženky přes API

Vlastníci účtů mohou kontrolovat záznamy volání peněženky pomocí Felo login tokenu. Tato přihlašovací údaje jsou odlišné od API klíče používaného pro volání Data API; nenahrazujte jimi FELO_API_KEY.

curl -sS 'https://openapi.felo.ai/api/wallet/usage?call_type=data' \
  -H 'Authorization: Bearer YOUR_FELO_LOGIN_TOKEN'

Záznamy jsou v data.items; call_type=data filtruje capability calls. Porovnejte využití s aktuálními cenami účtu. Čtení záznamů neposílá další generovací úlohu. Console Billing zůstává k dispozici pro kontrolu účtu a dobití.

Chyby čtěte defenzivně

Nejprve zkontrolujte HTTP stav. Chyby mohou používat jednu z těchto struktur; níže uvedené hodnoty jsou ilustrativní:

{"error":{"code":"invalid_parameter","message":"Check the request fields"},"request_id":"example-request-id"}

{"status":402,"code":"INSUFFICIENT_BALANCE","message":"Insufficient balance","request_id":"example-request-id"}

Čtěte error.code / error.message, pokud jsou přítomny, jinak code / message. Zachovejte request_id, pokud je vrácen. Úspěšné odpovědi se liší podle operace; nenuťte je všechny do stejného chybového nebo data obalu.

Rozhodněte, co dělat dál

execution_unconfirmed (409) a billing_settlement_pending (503) vyžadují zvláštní opatrnost: okamžitě zpoplatněnou práci znovu neodesílejte. Dotazujte známé úlohy nebo kontaktujte podporu s request ID. Úspěšný HTTP stav s prázdným výsledkem je něco jiného než chybová odpověď.

Opakování bez vytvoření duplicitní práce

• Pro dotazy pouze na čtení a stav exportu používejte omezený backoff a respektujte Retry-After, pokud je přítomen.
• Pro neúspěšný požadavek na vytvoření s uloženým task_id nejprve dotazujte tuto úlohu, než vytvoříte další.
• Pokud spojení selhalo dříve, než jste obdrželi ID, výsledek může být neznámý. Nepředpokládejte, že opětovné odeslání požadavek deduplikuje.
• U 429 rozlišujte krátký rate limit od okna kvóty API klíče; opakované pokusy kvótu neresetují.
• Zastavte opakování po nastaveném termínu a zobrazte volajícímu akční chybu.

Pro podporu uveďte koncový bod, přibližný čas, HTTP stav a request ID. Nikdy neuvádějte celý API klíč.