Časté dotazy

Řešení problémů

Řešte problémy s ověřováním, modely, streamováním, úlohami a limity rychlosti podle příznaků.

Začněte příznakem a potom postupujte podle opravy. Většina selhání pochází ze základní URL, klíče, ID modelu nebo zůstatku.

Tabulka podle příznaků

Příznak	Pravděpodobná příčina	Oprava
401 `UNAUTHORIZED`	Klíč chybí, je nesprávný, zrušený nebo nebyl odeslán	Odešlete `Authorization: Bearer $FELO_API_KEY`; pokud byl klíč zrušen, vytvořte nový
402 `INSUFFICIENT_CREDITS`	Zůstatek nepokrývá volání	Dobijte v Console Billing
404 u každého požadavku	Základní URL obsahuje cestu, kterou endpoint již přidává	Použijte `https://openapi.felo.ai/api/v1` pro klienty OpenAI a `https://openapi.felo.ai/api` pro klienty Anthropic
404 u jednoho modelu	ID modelu není veřejné nebo jej endpoint neobsluhuje	Zkontrolujte ID modelu na stránce modelů a v dokumentaci endpointu
Chyba 400 u pole `model` nebo `max_tokens`	Chybí povinné pole nebo model nepřijímá tvar požadavku	Přidejte `max_tokens` pro Messages; odstraňte nepodporovaná pole
429	Limit rychlosti nebo limit upstreamového poskytovatele	Přečtěte `Retry-After`; viz Chyby, limity a opakování
5xx	Selhání upstreamu nebo služby	Opakujte s rostoucím odstupem; pokud přetrvává, uveďte `request_id`
Stream se připojí, ale nic neposílá	Proxy bufferuje odpověď nebo parser událostí očekává nesprávný formát	Čtěte stream přírůstkově; vypněte bufferování odpovědí ve své proxy
Úloha se nikdy nedokončí	Nesprávný endpoint pro dotazování nebo nebyl obsloužen koncový stav	Dotazujte vlastní endpoint stavu úlohy a zastavte na koncových hodnotách
Volání nástrojů jsou ignorována	Model tuto možnost neinzeruje	Zkontrolujte `supported_parameters` v katalogu
Data API vrací 404	Prefix `/v1/beta` byl přidán dvakrát	Použijte cestu přesně tak, jak je uvedena v referenci

Ověřování

Zrušený klíč vrací zprávu, která uvádí prefix klíče:

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "API Key has been revoked (keyPrefix=...)"
}

Kontrolní seznam:

Hlavička je Authorization: Bearer <key> pro Model API a Felo API.
Data API také přijímá X-API-Key: <key>.
Klíč není obalen v uvozovkách a na konci není nový řádek ze zkopírované proměnné prostředí.
Nasazené prostředí skutečně má proměnnou nastavenou; klíč, který funguje lokálně, může v produkci chybět.
Klíč nebyl smazán ani rotován. Smazaný nebo rotovaný klíč nelze znovu zobrazit; vytvořte nový.

Vytváření klíčů a limity najdete v části Ověřování.

Nástrahy základní URL

Klient	Správná základní URL
OpenAI SDK	`https://openapi.felo.ai/api/v1`
Anthropic SDK	`https://openapi.felo.ai/api`
Přímý modelový endpoint	`https://openapi.felo.ai/api/v1/chat/completions`, `/responses` nebo `/messages`
Data API	`https://openapi.felo.ai/v1/beta`
Felo API `/v2`	`https://openapi.felo.ai/v2`

Dvě běžné chyby:

Přidání /chat/completions k základní URL, kterou SDK již rozšiřuje.
Nastavení základní URL Anthropic na https://openapi.felo.ai/api/v1. SDK připojuje /v1/messages, takže požadavek se změní na /api/v1/v1/messages.

Problémy s ID modelu

ID modelů jsou veřejná ID z katalogu, nikoli interní názvy upstreamového poskytovatele ani zobrazovaný název.

Vyhledejte ID na stránce modelů nebo v GET /api/v1/models.
Potvrďte, že model podporuje protokol, který voláte (supported_protocols).
Pokud jste připnuli kanál, potvrďte, že daný kanál je publikovaný a spustitelný pro tento model. Nedostupný kanál není náhradou.

Viz Kanály a směrování poskytovatelů.

Problémy se streamováním

Nastavte stream: true v těle požadavku, nikoli jako parametr dotazu.
Čtěte tělo odpovědi jako stream. Čekání na celou odpověď streamování maří.
Některé proxy a serverless platformy bufferují odpovědi. Vypněte bufferování pro trasu, která požadavek proxuje.
Chat Completions streamuje choices[0].delta, nikoli choices[0].message. Konečný obsah přichází v mnoha chuncích.
Stream může skončit bez čisté koncové události, pokud se připojení přeruší. Považujte přerušené připojení za neúplnou odpověď.

Problémy s asynchronními úlohami

Dotazujte endpoint stavu, který patří dané rodině úloh. Workflow Felo používají GET /v2/tasks/{task_id}/status; úlohy modelů pro video a obrázky používají vlastní generovací endpointy.
Zastavte u každého koncového stavu, včetně selhání a expirací, nejen u úspěchu.
Zpětná volání pro video a obrázky jsou aktuálně ignorována. Nečekejte na webhook.
URL výsledku může být krátkodobá. Pokud stahování expiruje, vyžádejte si novou URL z endpointu stavu.
Před opětovným odesláním úlohu zkontrolujte. Opětovné odeslání běžící úlohy vytvoří duplikát a obě se účtují.

Viz Asynchronní úlohy.

Problémy s Data API

Zachovejte přesnou cestu metody z reference Data API.
Těla požadavků jsou specifická pro poskytovatele. Pole, které funguje u jednoho poskytovatele, nemusí fungovat u jiného.
Chyba poskytovatele může dorazit uvnitř odpovědi 4xx se zprávou specifickou pro poskytovatele. Zaznamenejte request_id a tělo odpovědi.

Bezpečnostní připomínky

Nikdy nedávejte API klíč do kódu prohlížeče, balíčku mobilní aplikace ani veřejného repozitáře. Uchovávejte jej na serveru a požadavky proxujte.
Nezaznamenávejte celý klíč. Pokud potřebujete klíč identifikovat, zaznamenejte prefix.
Pokud mohl klíč uniknout, okamžitě jej rotujte.

Než kontaktujete podporu

Shromážděte:

Endpoint a metodu HTTP.
Stav HTTP, code a request_id.
ID modelu nebo ID úlohy.
Časové razítko s časovým pásmem.
Minimální tělo požadavku s odstraněnými tajnými údaji.

Pošlete je podpoře s e-mailem účtu. Neuvádějte celý API klíč.