za pomocą nieprawidłowego base_url
Użycie standardowego adresu URL OpenAI powoduje awarię żądań lub przekierowanie do innego modelu. Nasze API wymaga zmiany base_url do https://api.whatisopenrouterai.com/v1. Ta pojedyncza linia konfiguracji zapewnia, że Twoje SDK łączy się z naszymi serwerami zamiast globalnej infrastruktury OpenAI.
Wielu programistów kopiuje i wkleja swój istniejący kod bez aktualizacji tej zmiennej. Jeśli zostawisz domyślny URL, otrzymasz błąd 404 lub trafisz na model, który nie jest uncensored. Zawsze weryfikuj połączenie, sprawdzając /v1/models endpoint. Powinieneś zobaczyć tam nasz specyficzny identyfikator modelu. Potwierdza to poprawność routingu przed wysłaniem pierwszego żądania uzupełnienia.
zapominając o ustawieniu id modelu
Nawet przy poprawnym bazowym URL, pominięcie ID modelu domyślnie wybiera ogólny lub starszy model. Musisz jawnie ustawić model parametr do "uncensored" w każdym żądaniu. Informuje to warstwę routingu o obsłudze konkretnego modelu open-weight dostosowanego do treści bez ograniczeń.
Bez tego jawnego polecenia możesz otrzymać inny model z innymi zasadami wyrównania (alignment). Niektóre modele domyślnie odrzucają legalne tematy dla dorosłych. Wymuszając uncensored ID, gwarantujesz oczekiwane zachowanie. Sprawdź swój kod pod kątem zakodowanych na stałe nazw modeli, które mogą nadpisać domyślne ustawienia twojego SDK.
ignoring token limits and errors
Przekroczenie okna kontekstowego 100,000 tokenów lub limitu wyjściowego 16,000 tokenów powoduje natychmiastowe niepowodzenie żądań. Nasze API narzuca maksymalną ilość 16,000 tokenów na żądanie. Jeśli nie ustawisz max_tokens, domyślnie tylko 2 048 tokenów. To często za krótkie do zadań złożonego rozumowania.
Błędy i odrzucenia nie zużywają Twojego kredytu z góry opłaconego. Jednak żądania o nieprawidłowym formacie, które przekraczają limity szybkości lub przekraczają rozmiar treści (8 MB), nadal wliczają się do Twojego limitu. Monitoruj nagłówki odpowiedzi pod kątem użycia tokenów. Dostosuj inżynierię promptów, aby zmieścić się w oknie kontekstowym. Zapobiega to kosztownym ponownym próbom i zapewnia płynny przepływ danych.
niezrozumienie płatności z góry
Saldo Twojego konta jest powiązane z kredytem prepaidowym, a nie z subskrypcją miesięczną. Pobieramy $0.15 za 1M tokenów wejściowych i $0.50 za 1M tokenów wyjściowych. Błędy są darmowe, ale pomyślne uzupełnienia zużywają kredyt. Musisz doładować konto za pomocą kryptowalut, aby utrzymać dostępność usługi.
Akceptujemy USDT (TRC20) lub USDC (Base) do doładowań. Minimalne wpłaty zaczynają się od $20. Bonusy stosuje się przy wyższych progach: +5% od $50, +10% od $100 oraz +15% od $200. Kredyt nie wygasa. Upewnij się, że Twoje saldo jest dodatnie przed uruchomieniem dużych partii. Sprawdź panel, aby zweryfikować aktualne saldo i ostatnie transakcje.
mylenie strumieniowania ze standardowymi odpowiedziami
Strumieniowanie przez SSE zmienia sposób parsowania strumienia odpowiedzi. Standardowe odpowiedzi zwracają pojedynczy obiekt JSON. Strumieniowanie zwraca wiele kawałków. Musisz obsłużyć ostatni kawałek, aby uzyskać dokładne statystyki zużycia tokenów.
Nasza implementacja strumieniowania uwzględnia użycie tokenów w ostatnim cząstku. Jeśli przerwiesz czytanie strumienia wcześniej, możesz stracić te dane. Upewnij się, że Twoja biblioteka klienta poprawnie obsługuje SSE. Jest to kluczowe dla aplikacji w czasie rzeczywistym, w których tokeny są wyświetlane w miarę ich generowania. Nieprawidłowo skonfigurowane strumieniowanie może prowadzić do niekompletnego tekstu lub uszkodzonych stanów interfejsu.
błędy konfiguracji wyboru narzędzia
Niepoprawny tool_choice ustawienia mogą spowodować, że wywoływanie funkcji nie będzie działać zgodnie z oczekiwaniami. Możesz wymusić konkretne narzędzie lub pozwolić modelowi na podjęcie decyzji. Zła konfiguracja często prowadzi do ignorowania dostępnych funkcji przez model.
Użyj tool_choice do kontrolowania, czy model automatycznie wywołuje narzędzia. Ustaw na "auto" dla elastyczności lub określ ID narzędzia dla ścisłego zachowania. Upewnij się, że definicje funkcji pasują do oczekiwanego schematu. Zapobiega to błędom czasu wykonania, gdy model próbuje wywołać nieistniejącą funkcję. Przetestuj definicje narzędzi dokładnie przed wdrożeniem w produkcji.
brak trybu json_object
Bez response_format: {"type": "json_object"}, model może wygenerować markdown lub tekst zwykły. Zaburza to parsery oczekujące ścisłego formatu JSON. Włącz tryb JSON, aby zapewnić spójny, możliwy do sparsowania wynik.
Ta funkcja jest niezbędna do integracji z systemami downstreamowymi, które wymagają danych ustrukturyzowanych. Znacznie redukuje nakład pracy na przetwarzanie wsteczne. Zawsze waliduj schemat wyjściowy w kodzie klienta. Zapewnia to odporność na okresowe halucynacje modelu. Użyj tego trybu przy ekstrakcji encji lub generowaniu plików konfiguracyjnych.
zaskoczenia limitami szybkości
Nasz API obsługuje 300 żądań na minutę na klucz. Przekroczenie tego limitu skutkuje odpowiedzią 429 Too Many Errors. Żądania równoległe są ograniczone do 8 na klucz. Zaplanuj ustawienia współbieżności odpowiednio.
Jeśli uruchamiasz wiele procesów, upewnij się, że dzielą się tym samym kluczem lub wygeneruj osobne klucze. Każde konto obsługuje jeden aktywny klucz. Nowy klucz zastępuje stary. Monitoruj nagłówki limitu szybkości w odpowiedzi. Wdróż wykładnicze opóźnienie w logice ponawiania. Zapobiega to kaskadowym awariom podczas dużych obciążeń.
opóźnienia w doładowaniu krypto
Transakcje kryptowalutowe mogą wymagać czasu na potwierdzenie w blockchainie. Twój kredyt może nie pojawić się natychmiast po wysłaniu środków. Używaj właściwej sieci: TRC20 dla USDT lub Base dla USDC. Wysłanie na niewłaściwą sieć powoduje utratę środków.
Doładowania wynoszą od $20 do $500. Upewnij się, że wysyłasz dokładną kwotę lub uwzględnij opłaty sieciowe. Sprawdź hash transakcji w eksploratorze blockchain. Jeśli kredyt zostanie opóźniony, skontaktuj się z pomocą techniczną, podając identyfikator transakcji. Nie zakładaj od razu, że płatność się nie powiodła. Geduld podczas przeciążenia sieci jest kluczowa dla płynnego działania.
