Zrozumienie adresu bazowego
Podstawowy adres URL definiuje, gdzie klient wysyła żądania. Błąd w tym miejscu powoduje natychmiastowe awarie połączenia lub nieoczekiwane odpowiedzi modelu. Wielu deweloperów zakłada, że standardowy adres URL OpenAI działa uniwersalnie, ale dostawcy bez cenzury często używają odrębnych endpointów do kierowania ruchu do konkretnych puli modeli.
Upewnij się, że Twoja konfiguracja wskazuje na https://api.openrouterabliteratedmodels.com/v1 dla naszej usługi. Jeśli korzystasz z agregatora stron trzecich, upewnij się, że adres URL podstawowy dokładnie odpowiada dokumentacji. Nieprawidłowe adresy URL często prowadzą do błędów 404 lub odpowiedzi z modeli domyślnych zamiast zamierzonej wersji bez cenzury.
- Sprawdź swoje zmienne środowiskowe pod kątem
BASE_URLlubAPI_HOST. - Upewnij się, że ścieżka zawiera
/v1dla standardowej kompatybilności. - Przetestuj łączność za pomocą prostego żądania listy modeli przed intensywnym użytkowaniem.
Obsługa limitów szybkości
Limity szybkości ograniczają liczbę żądań, które możesz wysłać w określonym przedziale czasowym. Nasze API narzuca limit 300 żądań na minutę na klucz. Przekroczenie tego progu powoduje błędy HTTP 429, tymczasowo blokując dalsze żądania do momentu zresetowania okna.
Istnieje limit żądań współbieżnych wynoszący 8 żądań jednocześnie na klucz. Jeśli wyślesz więcej niż 8 żądań jednocześnie, nadmiarowe żądania będą kolejkowane lub odrzucone w zależności od Twojej biblioteki klienta. Monitoruj współbieżność aplikacji, aby uniknąć przekroczenia tych sztywnych limitów. Używaj strategii wykładniczego backoff w kodzie, aby gracefulnie obsługiwać błędy 429 bez spamowania serwera.
Pamiętaj, że każdy klucz jest unikalny dla Twojego konta. Udostępnianie kluczy między wieloma usługami może przyspieszyć osiągnięcie tych limitów. Wygeneruj nowy klucz, jeśli potrzebujesz oddzielnych puli limitów szybkości dla różnych części aplikacji.
Odpowiedzi strumieniowe vs. nie-strumieniowe
Strumieniowanie zwraca dane stopniowo, w miarę generowania tokenów, podczas gdy niestrumieniowanie czeka na pełną odpowiedź. Strumieniowanie jest kluczowe dla doświadczeń użytkownika w czasie rzeczywistym, ale wymaga starannej obsługi Server-Sent Events (SSE).
Podczas strumieniowania ostatni fragment zawiera statystyki użycia tokenów. Jeśli przestaniesz przetwarzać wcześniej, możesz przegapić te dane. Upewnij się, że Twój klient parsuje ostatnią wiadomość SSE, aby dokładnie pobrać liczbę tokenów wejściowych i wyjściowych. Odpowiedzi nie-strumieniowe są prostsze, ale mogą powodować wysokie opóźnienia przy długich wyjściach.
Wybierz strumieniowanie dla interfejsów czatu, gdzie użytkownicy widzą tekst pojawiający się znak po znaku. Użyj trybu nie-strumieniowego dla przetwarzania wsadowego lub gdy potrzebujesz pełnej odpowiedzi przed kontynuacją. Nasze API obsługuje oba tryby za pośrednictwem stream parametr w ciele żądania.
Błędy trybu JSON
Tryb JSON zapewnia, że model zwraca poprawny JSON, co jest krytyczne dla integracji programistycznej. Błędy w tym miejscu często wynikają z nieprawidłowych nagłówków lub niespójności schematów. API wymaga response_format: {"type": "json_object"} do wymuszenia ścisłego wyjścia JSON.
Jeśli otrzymasz niepoprawny JSON, sprawdź definicję schematu. Model może zawierać bloki kodu w formacie markdown lub tekst wyjaśniający spoza struktury JSON. Użyj niezawodnego parsera, który potrafi usuwać znaczniki markdown lub zweryfikować wynik zgodnie z oczekiwanym schematem. Unikaj zbyt złożonych schematów, które mogą mylić model.
Przetestuj najpierw proste struktury. Stopniowo dodawaj złożoność, aby zidentyfikować, gdzie model ma trudności. Upewnij się, że temperatura jest ustawiona odpowiednio, ponieważ wyższe temperatury mogą zwiększać losowość i zmniejszać poprawność JSON.
Błędne obliczenia liczby tokenów
Liczby tokenów określają Twoje rozliczenia i użycie okna kontekstowego. Błędne obliczenia mogą prowadzić do nieoczekiwanych opłat lub obciętych odpowiedzi. Nasze API nalicza $0.15 za 1M tokenów wejściowych i $0.50 za 1M tokenów wyjściowych.
Użyj niezawodnej biblioteki tokenizującej, która pasuje do schematu tokenizacji modelu. Różne modele mogą inaczej tokenizować spacje lub interpunkcję, co prowadzi do rozbieżności między Twoim lokalnym liczeniem a liczeniem w API. Zawsze polegaj na użyciu tokenów zwróconym w odpowiedzi do dokładnego rozliczenia.
Uważaj na okno kontekstowe, które wynosi łącznie 100,000 tokenów. Przekroczenie tego limitu spowoduje błędy. Skracaj starsze wiadomości lub podsumowania, aby mieścić się w granicach. Monitoruj zużycie tokenów w czasie, aby zoptymalizować strukturę promptów i obniżyć koszty.
Opóźnienia w płatnościach kryptowalutami
Doładowania kryptowalutami za pomocą USDT (TRC20) lub USDC (Base) są przetwarzane natychmiast po naszej stronie. Jednakże zatłoczenie sieci może czasami powodować niewielkie opóźnienia w potwierdzeniu. Upewnij się, że wysyłasz prawidłową kwotę i używasz właściwej sieci, aby uniknąć utraty środków.
Wpłaty wynoszą od $20 do $500 w kwotach całkowitych. Bonusowe kredyty stosują się automatycznie: +5% od $50, +10% od $100 i +15% od $200. Zweryfikuj hash transakcji, aby potwierdzić płatność. Jeśli kredyty nie pojawią się w ciągu kilku minut, sprawdź eksplorator blockchain pod kątem statusu transakcji.
Kredyt nie wygasa, więc nie ma pilności jego natychmiastowego użycia. Błędy, takie jak podwójne obciążenia, są rozwiązywane przez stronę Wsparcie. Przechowuj dowody transakcji dla łatwego wglądu w przypadku wystąpienia problemów.
Konfiguracja ID modelu
ID modelu identyfikuje, której wersji modelu uncensored używasz. W naszym serwisie ID modelu to uncensored. Użycie nieprawidłowego identyfikatora może spowodować błędy lub nieoczekiwane zachowanie.
Upewnij się, że żądania określają model: "uncensored" w ciele żądania. To ID wskazuje na nasz konkretny model open-weight dostosowany do odpowiedzi bez ograniczeń. Nie jest to ogólny identyfikator, ale konkretny wskaźnik do naszej zhostowanej instancji.
Sprawdź dokumentację biblioteki klienta, aby dowiedzieć się, jak ustawić identyfikator modelu. Niektóre biblioteki używają model pole, podczas gdy inne mogą używać innego parametru. Spójność w używaniu identyfikatora modelu w całej aplikacji zapobiega pomyłkom i zapewnia, że zawsze wywołujesz zamierzony model uncensored.
Przekroczenia okna kontekstu
Okno kontekstowe ogranicza całkowitą liczbę tokenów, jakie możesz wysłać w jednym żądaniu. Nasze API obsługuje okno o rozmiarze 100,000 tokenów, obejmujące zarówno prompt, jak i uzupełnienie. Przekroczenie tego limitu powoduje błąd.
Aby zarządzać kontekstem, zaimplementuj strategię okna przesuwającego. Usuń starsze wiadomości lub je podsumuj, aby zwolnić miejsce. Monitoruj liczbę tokenów swojego wejścia, aby upewnić się, że mieści się w limicie 100 000 tokenów. Jeśli przekroczysz limit, API odrzuci żądanie.
Korzystaj z max_tokens parametr kontrolujący długość odpowiedzi. Maksymalna długość odpowiedzi na żądanie wynosi 16 000 tokenów. Ustawienie tego parametru pomaga zapobiegać nadmiernemu zużyciu tokenów i utrzymuje odpowiedzi w granicach rozsądnego zakresu dla Twojej aplikacji.
Polityka wsparcia i zwrotów
Kredyt nie jest zwracany po zużyciu, ale nie wygasa. W przypadku problemów z płatnościami lub usługą skontaktuj się z Wsparciem przez wyznaczoną stronę. Błędy, takie jak podwójne obciążenia, są rozwiązywane przez zespół Wsparcia.
W przypadku problemów technicznych najpierw sprawdź dokumentację. Nasze API jest proste, ale mogą wystąpić przypadki brzegowe. Podaj swój klucz API i szczegóły żądania, szukając pomocy. Czas odpowiedzi się różni, ale dążymy do szybkiego rozwiązywania problemów.
Pamiętaj, że kredyt jest prepayowany. Płacisz za to, co zużywasz, a błędy i odmowy są darmowe. Ten model zapewnia przejrzystość w rozliczeniach. Użyj strony Wsparcie w przypadku jakichkolwiek rozbieżności lub pytań dotyczących Twojego konta.
