a helytelen base_url
A szabványos OpenAI base URL használata kérés sikertelenségéhez vagy egy másik modellhez való irányításhoz vezet. API-nk megköveteli, hogy változtasson a base_url a https://api.whatisopenrouterai.com/v1. Ez a konfigurációs sor egyetlen biztosítja, hogy az SDK a szervereinkhez csatlakozzon a globális OpenAI infrastruktúra helyett.
Sok fejlesztő másolja-beilleszti a meglévő kódját anélkül, hogy frissítené ezt a változót. Ha hagyja az alapértelmezett URL-t, vagy 404-es hibát kap, vagy egy nem uncensored modellhez csatlakozik. Mindig ellenőrizze a kapcsolatot a /v1/models endpoint. Itt kell látnod a specifikus modell azonosítónkat. Ez megerősíti, hogy az átirányítás helyes, mielőtt elküldenéd az első completion kérést.
ne felejtsd el beállítani a modellszem azonosítót
A helyes base URL ellenére a modell ID elhagyása egy általános vagy régebbi modellre defaultol. Expliciten be kell állítania a model paramétert "uncensored" minden kérésben. Ez azt jelzi az irányítási rétegnek, hogy a korlátozás nélküli tartalomra hangolt specifikus nyílt súlyú modellt szolgálja ki.
Ennek a kifejezett utasítás nélkül más modellt kaphat más igazítási szabályokkal. Egyes modellek alapértelmezés szerint visszautasítják a törvényes felnőtt témákat. A uncensored Az ID garantálja a várt viselkedést. Ellenőrizze a kódját, hogy nincs-e benne hardcode modellnév, amely felülírja az SDK alapértelmezéseit.
tokenkorlátok és hibák figyelmen kívül hagyása
Az 100,000 tokenes kontextusablak vagy a 16,000 tokenes kimeneti limit átlépése azonnali kéréssikertelenséget okoz. API-nk maximum 16,000 token kimenetet engedélyez egy kérésre. Ha nem állítja be max_tokens, az alapértelmezett érték csak 2 048 token. Ez gyakran túl rövid a komplex érvelési feladatokhoz.
A hibák és a visszautasítások nem fogyasztják az előre fizetett kreditet. Azonban a hibás kérések, amelyek eléri az átfolyási korlátot vagy meghaladják a törzsméretet (8 MB), továbbra is számítanak a kvótájába. Figyelje a válasz fejléceit a tokenfelhasználásért. Igazítsa a prompt mérnökséget, hogy beleférjen a kontextus ablakba. Ez megakadályozza a költséges újrapróbálkozásokat és biztosítja a sima adatfolyamot.
az előre fizetett számlázás félreértése
Az egyenleged az előre fizetett hitelhez kötődik, nem egy havi előfizetéshez. $0.15-öt számítunk fel 1M bemeneti tokenenként és $0.50-ot 1M kimeneti tokenenként. A hibák ingyenesek, de a sikeres befejezések felhasználják a hitelt. A szolgáltatás fenntartásához kriptovalutával kell töltened.
USDT-t (TRC20) vagy USDC-t (Base) fogadunk feltöltésekhez. A minimális betét $20. A bónuszok magasabb szinteken érvényesülnek: +5% $50-től, +10% $100-tól és +15% $200-tól. A hitel nem jár le. Győződj meg róla, hogy az egyenleged pozitív, mielőtt nagy kötegelt feldolgozást hajtanál végre. Ellenőrizd a műszerfalat a jelenlegi egyenleged és a legutóbbi tranzakciók megtekintéséhez.
a streamelés összekeverése a szabványos válaszokkal
Az SSE streamelés megváltoztatja a válasz stream feldolgozását. A szabványos válaszok egyetlen JSON objektumot adnak vissza. A streamelés több darabot ad. A pontos token-felhasználási statisztikákhoz a végső darapot kell kezelned.
Streamelő megvalósításunk a tokenhasználatot az utolsó darabban is tartalmazza. Ha idő előtt leállítja a stream olvasását, elveszhet ez az adat. Győződjön meg arról, hogy ügyfélkönyvtára megfelelően támogatja az SSE-t. Ez kritikus fontosságú a valós idejű alkalmazásoknál, ahol a tokeneket generálás közben jeleníti meg. A hibásan konfigurált streamelés hiányos szöveghez vagy sérült UI állapotokhoz vezethet.
eszközválasztási konfigurációs hibák
Helytelen tool_choice beállítások megakadályozhatják, hogy a függvényhívás a várt módon működjön. Kényszeríthet egy specifikus eszközt, vagy hagyhatja, hogy a modell döntsön. A rossz konfiguráció gyakran ahhoz vezet, hogy a modell figyelmen kívül hagyja az elérhető funkciókat.
Használat tool_choice arra, hogy a modell automatikusan hívja-e az eszközöket. Állítsa be a "auto" rugalmassághoz vagy adjon meg egy eszközazonosítót a szigorú viselkedéshez. Győződjön meg arról, hogy a funkciódefiníciók megfelelnek a várt sémának. Ez elkerüli a futásidejű hibákat, amikor a modell egy nem létező funkciót próbál meghívni. Alaposan tesztelje az eszközeinek definícióit éles környezetbe helyezés előtt.
hiányzó json_object mód
Nélkül response_format: {"type": "json_object"}, a modell markdown vagy sima szöveget adhat vissza. Ez felborítja a szigorú JSON-t váró parserokat. Engedélyezze a JSON módot a konzisztens, elemezhető kimenet érdekében.
Ez a funkció elengedhetetlen a downstream rendszerekkel való integrációhoz, amelyek strukturált adatokat igényelnek. Jelentősen csökkenti az utófeldolgozási terhet. Mindig validáld a kimeneti sémát az ügyfélkódban. Ez biztosítja a robusztusságot a néha előforduló modellhallucinációkkal szemben. Használd ezt a módot entitások kinyerésekor vagy konfigurációs fájlok generálásakor.
rate limit meglepetések
Az API percenként 300 kérést tesz lehetővé kulcsonként. Ennek túllépése 429 Too Many Errors választ eredményez. A párhuzamos kérések száma kulcsonként 8-ban korlátozott. Tervezze meg a párhuzamossági beállításait ennek megfelelően.
Ha több folyamatot futtat, győződjön meg arról, hogy ugyanazt a kulcsot használják, vagy generáljon külön kulcsokat. Minden fiók egy aktív kulcsot támogat. Egy új kulcs felülírja a régit. Figyelje a válaszban szereplő rate limit fejléceket. Implementáljon exponenciális backoffot a retry logikájában. Ez megakadályozza a kaskád hibákat nagy forgalom esetén.
kriptovalutás feltöltés késedelmei
A kriptovalutás tranzakcióknak időbe telhet a megerősítés a blokkláncon. A hitel nem jelenhet meg azonnal a küldés után. Használja a megfelelő hálózatot: TRC20 USDT-hez vagy Base USDC-hez. A rossz hálózatra küldés pénzügyi veszteséggel jár.
A feltöltések $20 és $500 közötti összegek. Győződj meg róla, hogy pontos összeget küldesz, vagy vedd figyelembe a hálózati díjakat. Ellenőrizd a tranzakció hash-jét a blokklánc-felderítőn. Ha a kredit késik, vedd fel a kapcsolatot az ügyfélszolgálattal a tranzakció azonosítójával. Ne feltételezd, hogy a fizetés azonnal sikertelen volt. A türelem kulcsfontosságú a hálózati zsúfoltság idején a zökkenőmentes működés érdekében.
