pomocí nesprávného base_url
Použití standardní URL adresy OpenAI způsobí selhání vašich požadavků nebo přesměrování na zcela jiný model. Naše API vyžaduje, abyste změnili base_url na https://api.whatisopenrouterai.com/v1. Tento jediný řádek konfigurace zajistí, že vaše SDK se připojí k našim serverům místo globální infrastruktury OpenAI.
Mnoho vývojářů zkopíruje a vloží svůj stávající kód bez aktualizace této proměnné. Pokud ponecháte výchozí URL, dostanete buď chybu 404, nebo narazíte na model, který není bez omezení. Vždy ověřte připojení kontrolou /v1/models endpoint. Měli byste tam vidět naše specifické ID modelu. To potvrzuje, že směrování je správné, než odešlete svůj první požadavek na dokončení.
zapomínáním nastavit model id
Ihdy se správnou základní URL vynechání ID modelu vede k výchozímu obecnému nebo staršímu modelu. Musíte explicitně nastavit model parameter na "uncensored" v každém požadavku. To říká naší vrstvě směrování, aby obsloužila konkrétní open-weight model vyladěný pro neomezený obsah.
Bez tohoto explicitního pokynu můžete získat jiný model s jinými pravidly zarovnání. Některé modely odmítají zákonné dospělé témata ve výchozím nastavení. Vynucením uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
ignorování limitů tokenů a chyb
Překročení kontextového okna 100,000 tokenů nebo limitu výstupu 16,000 tokenů způsobí okamžité selhání požadavku. Naše API vynucuje maximální výstup 16,000 tokenů na požadavek. Pokud nenastavíte max_tokens, výchozí hodnota je pouze 2 048 tokenů. To je často příliš krátké pro složité úkoly odvozování.
Chyby a odmítnutí nespotřebovávají váš předplacený kredit. Nicméně neplatné požadavky, které narazí na limity rychlosti nebo překročí velikost těla (8 MB), stále započítávají do vašeho kvótu. Sledujte hlavičky odpovědí pro využití tokenů. Upravte inženýrství promptů tak, aby se vešly do kontextového okna. To zabraňuje nákladným opakováním a zajišťuje plynulý tok dat.
Nepochopení předplaceného platebního systému
Zůstatek vašeho účtu je vázán na předplacený kredit, nikoliv na měsíční předplatné. Účtujeme $0.15 za 1M vstupních tokenů a $0.50 za 1M výstupních tokenů. Chyby jsou zdarma, ale úspěšné dokončení spotřebovává kredit. Pro udržení dostupnosti služby musíte doplnit prostředky přes kryptoměny.
Přijímáme USDT (TRC20) nebo USDC (Base) pro dobíjení. Minimální vklady začínají na $20. Bonusy platí pro vyšší úrovně: +5 % od $50, +10 % od $100 a +15 % od $200. Kredit nevyprší. Před spuštěním velkých dávek se ujistěte, že máte kladný zůstatek. Zkontrolujte dashboard pro ověření aktuálního zůstatku a nedávných transakcí.
zaměňování streamování se standardními odpověďmi
Streamování přes SSE mění způsob, jakým parsovat stream odpovědi. Standardní odpovědi vracejí jeden JSON objekt. Streamování vrací více chunků. Musíte zpracovat poslední chunk, abyste získali přesné statistiky využití tokenů.
Naše implementace streamování zahrnuje využití tokenů v posledním chunku. Pokud stream předčasně ukončíte, můžete tato data ztratit. Ujistěte se, že vaše knihovna podporuje SSE. To je klíčové pro aplikace reálného času, kde zobrazujete tokeny během jejich generování. Špatně nakonfigurované streamování může vést k neúplnému textu nebo rozbitým stavům uživatelského rozhraní.
chyby konfigurace tool_choice
Nesprávné tool_choice nastavení mohou zabránit tomu, aby volání funkcí fungovalo podle očekávání. Můžete vynutit konkrétní nástroj nebo nechat model, aby se rozhodl. Nesprávná konfigurace často vede k tomu, že model ignoruje dostupné funkce.
Použít tool_choice pro ovládání toho, zda model volá nástroje automaticky. Nastavte na "auto" pro flexibilitu nebo zadejte ID nástroje pro přísné chování. Zajistěte, aby definice vašich funkcí odpovídaly očekávané schématu. To vyhne chybám za běhu, když se model pokusí zavolat neexistující funkci. Před nasazením do produkce důkladně otestujte definice nástrojů.
Chybějící režim json_object
Bez response_format: {"type": "json_object"}, model může vrátit markdown nebo čistý text. To rozbije parsery očekávající striktní JSON. Povolte režim JSON, aby byl výstup konzistentní a spolehlivě parsovatelný.
Tato funkce je nezbytná pro integraci s downstream systémy, které vyžadují strukturovaná data. Výrazně snižuje režii post-processing. Vždy validujte schéma výstupu v kódu klienta. To zajišťuje robustnost vůči občasné halucinaci modelu. Použijte tento režim při extrakci entit nebo generování konfiguračních souborů.
překvapení z limitů rychlosti
Naše API umožňuje 300 požadavků za minutu na klíč. Překročení tohoto limitu má za následek odpověď 429 Too Many Errors. Souběžné požadavky jsou omezeny na 8 na klíč. Nastavení souběžnosti si naplánujte příslušně.
Pokud spouštíte více procesů, ujistěte se, že sdílejí stejný klíč nebo vygenerujte samostatné klíče. Každý účet podporuje jeden aktivní klíč. Nový klíč nahrazuje ten starý. Sledujte hlavičky limitu rychlosti v odpovědi. Implementujte exponenciální backoff ve své logice opakování. To zabraňuje kaskádovým selháním během období vysoké zátěže.
zpoždění při doplňování kryptoměnami
Transakce kryptoměnami mohou na blockchainu vyžadovat čas na potvrzení. Váš kredit se nemusí objevit okamžitě po odeslání prostředků. Použijte správnou síť: TRC20 pro USDT nebo Base pro USDC. Odeslání na špatnou síť způsobí ztrátu prostředků.
Dobíjení je možné v částkách od 20 do 500 $. Ujistěte se, že odešlete přesnou částku, nebo zohledněte síťové poplatky. Zkontrolujte hash transakce na průzkumník blockchainu. Pokud je kredit zpožděn, kontaktujte podporu s ID transakce. Předpokládejte, že platba okamžitě selhala. Trpělivost během síťové přetížení je klíčová pro hladký chod.
