Chápání základní URL
Základní URL definuje, kam váš klient odesílá požadavky. Nesrovnání zde způsobí okamžité selhání připojení nebo neočekávané odpovědi modelu. Mnoho vývojářů předpokládá, že standardní URL OpenAI funguje univerzálně, ale poskytovatelé nekorigovaných modelů často používají odlišné endpointy k směrování provozu do specifických poolů modelů.
Ověřte, že vaše konfigurace ukazuje na https://api.openrouterabliteratedmodels.com/v1 pro naše služby. Pokud používáte třetího agregátora, ujistěte se, že základní URL přesně odpovídá jejich dokumentaci. Nesprávné URL často vedou k chybám 404 nebo k odpovědím z výchozích modelů místo zamýšlené necenzurované varianty.
- Zkontrolujte proměnné prostředí na
BASE_URLneboAPI_HOST. - Ujistěte se, že cesta obsahuje
/v1pro standardní kompatibilitu. - Otestujte připojení pomocí jednoduché žádosti o seznam modelů před náročným využitím.
Zvládání limitů rychlosti
Omezení rychlosti (rate limits) omezují, kolik požadavků můžete odeslat v rámci určitého časového úseku. Naše API uplatňuje limit 300 požadavků za minutu na klíč. Překročení tohoto prahu má za následek chyby HTTP 429, které dočasně zablokují další požadavky, dokud se okno neobnoví.
Existuje limit souběžných požadavků 8 požadavků najednou na klíč. Pokud odešlete více než 8 souběžných požadavků, přebytky se budou čekat nebo selžou v závislosti na vaší knihovně klienta. Sledujte souběžnost vaší aplikace, abyste se vyhnuli překročení těchto pevných limitů. V kódu používejte strategie exponenciálního zpětného odstupňování pro graceful zpracování chyb 429 bez spamování serveru.
Pamatujte, že každý klíč je pro váš účet unikátní. Sdílení klíčů mezi více službami může urychlit dosažení těchto limitů. Vygenerujte nový klíč, pokud potřebujete samostatné pooly limitů rychlosti pro různé části vaší aplikace.
Odpovědi streamování vs. nestreamování
Streamované návraty data postupně, jak jsou generovány tokeny, zatímco nestreamované čeká na celou odpověď. Streamování je klíčové pro uživatelské zážitky v reálném čase, ale vyžaduje pečlivé zpracování Server-Sent Events (SSE).
Při streamování obsahuje poslední chunk statistiky využití tokenů. Pokud zpracování ukončíte dříve, tato data můžete přehlédnout. Ujistěte se, že váš klient parsoval poslední zprávu SSE pro přesné získání počtu vstupních a výstupních tokenů. Nestreamované odpovědi jsou jednodušší, ale mohou způsobit vysokou latenci u dlouhých výstupů.
Vyberte streamování pro chatová rozhraní, kde uživatelé vidí text, jak se objevuje znak po znaku. Použijte nestreamované zpracování pro dávkové zpracování nebo když potřebujete kompletní odpověď před pokračováním. Naše API podporuje oba režimy prostřednictvím stream parameter v těle požadavku.
Chyby v režimu JSON
Režim JSON zajišťuje, že model výstupuje platný JSON, což je kritické pro programovou integraci. Chyby zde často pramení z nesprávných hlaviček nebo neshod schémat. API vyžaduje response_format: {"type": "json_object"} pro vynucení přísného výstupu JSON.
Pokud obdržíte neplatný JSON, zkontrolujte definici schématu. Model může zahrnovat bloky kódu v markdownu nebo vysvětlující text mimo strukturu JSON. Použijte robustní parser, který umí odstranit markdown ohraničení nebo ověřit výstup proti vašemu očekávanému schématu. Vyhněte se příliš složitým schématům, která model mohou zmást.
Otestujte nejdříve jednoduché struktury. Postupně přidávejte složitost, abyste identifikovali, kde model selhává. Ujistěte se, že teplota je nastavena vhodně, protože vyšší teploty mohou zvýšit náhodnost a snížit platnost JSON.
Chyby v počítání tokenů
Počty tokenů určují vaše fakturaci a využití okna kontextu. Nesprávné výpočty mohou vést k neočekávaným poplatkům nebo ořezaným odpovědím. Naše API účtuje $0.15 za 1M vstupních tokenů a $0.50 za 1M výstupních tokenů.
Použijte spolehlivou knihovnu tokenizátoru, která odpovídá schématu tokenizace modelu. Různé modely mohou tokenizovat bílé znaky nebo interpunkci odlišně, což vede k nesrovnalostem mezi vaším lokálním počtem a počtem v API. Vždy spoléhejte na spotřebu tokenů vrácenou v odpovědi pro přesné fakturování.
Mějte na paměti, že vaše kontextové okno má celkem 100 000 tokenů. Jeho překročení způsobí chyby. Pro udržení se v mezích ořežte starší zprávy nebo souhrny. Sledujte spotřebu tokenů v čase, abyste optimalizovali strukturu promptů a snížili náklady.
Zpoždění plateb kryptoměnami
Nabíjení kryptoměnami přes USDT (TRC20) nebo USDC (Base) je na naší straně zpracováno okamžitě. Přetížení sítě však může někdy způsobit mírná zpoždění při potvrzení. Ujistěte se, že posíláte správnou částku a síť, abyste předešli ztrátě.
Nahrávání se pohybuje od $20 do $500 v celých částkách. Bonusové kredity se aplikují automaticky: +5% od $50, +10% od $100 a +15% od $200. Ověřte hash transakce pro potvrzení platby. Pokud kredity neobjeví během několika minut, zkontrolujte průzkumníka blockchainu pro stav transakce.
Úvěr nevyprší, takže není třeba ho okamžitě využít. Chyby, jako jsou dvojí účty, se řeší prostřednictvím stránky Podpora. Uchovávejte si záznamy o transakcích pro snadnou referenci, pokud vzniknou problémy.
Konfigurace ID modelu
ID modelu identifikuje, kterou verzi modelu bez cenzury používáte. Pro naši službu je ID modelu uncensored. Použití nesprávného ID může vést k chybám nebo neočekávanému chování.
Ujistěte se, že vaše žádosti specifikují model: "uncensored" v těle požadavku. Toto ID ukazuje na náš konkrétní open-weight model vyladěný pro neomezené odpovědi. Není to obecný identifikátor, ale specifický ukazatel na náš hostovaný instanci.
Zkontrolujte dokumentaci knihovny klienta, jak nastavit ID modelu. Některé knihovny používají model pole, zatímco jiné mohou používat jiný parametr. Konzistence v používání ID modelu ve vaší aplikaci zabraňuje zmatení a zajišťuje, že vždy voláte určený uncensored model.
Překročení okna kontextu
Kontextové okno omezuje celkový počet tokenů, které můžete odeslat v jednom požadavku. Naše API podporuje okno o velikosti 100 000 tokenů, včetně promptu i odpovědi. Překročení tohoto limitu způsobí chybu.
Pro správu kontextu implementujte strategii klouzavého okna. Odstraňte starší zprávy nebo je shrňte, abyste uvolnili místo. Sledujte počet tokenů ve vašem vstupu, aby zůstal v mezích limitu 100,000 tokenů. Pokud tento limit překročíte, API požadatek odmítne.
Použijte max_tokens parametr pro řízení délky výstupu. Maximální výstup na požadavek je 16 000 tokenů. Nastavení tohoto parametru pomáhá předcházet nadměrnému využívání tokenů a udržuje odpovědi v mezích, které jsou pro vaši aplikaci zvládnutelné.
Podpora a politika vrácení peněz
Účetní zůstatek není po spotřebování vrácen, ale nevyprší. Pokud narazíte na problémy s platbami nebo službou, kontaktujte podporu prostřednictvím příslušné stránky. Chyby, jako je dvojí účtování, jsou řešeny týmem podpory.
Pro technické problémy nejprve zkontrolujte dokumentaci. Naše API je přehledné, ale mohou nastat hraniční případy. Při hledání pomoci uveďte svůj API klíč a podrobnosti o požadavku. Doby odezvy se liší, ale snažíme se problémy vyřešit rychle.
Pamatujte, že úvěr je předplacen. Platíte za to, co spotřebujete, přičemž chyby a odmítnutí jsou zdarma. Tento model zajišťuje transparentnost v fakturaci. Pro jakékoli nesrovnalosti nebo dotazy ohledně vašeho účtu použijte stránku Podpora.
