The OpenRouter API Wyjaśnione

Czym jest API kompatybilne z OpenAI?

To API REST, które podąża za interfejsem chat-completions OpenAI. Wysyłasz prompty i otrzymujesz wyjścia tekstowe za pomocą standardowych ładunków JSON. Ta kompatybilność oznacza, że Twój istniejący kod klienta działa bez większych zmian.

Podstawowym punktem końcowym jest POST /v1/chat/completions. Przyjmuje on wiadomości jako tablicę obiektów z rolą i treścią. Możesz również wyświetlić dostępne modele za pomocą GET /v1/models. Standaryzacja ta znacząco skraca czas integracji.

Nasza usługa zapewnia dokładnie ten interfejs. Udostępniamy jeden model bez cenzury pod identyfikatorem "uncensored". Działa on na naszych własnych serwerach. Nie przekieruje do innych dostawców. Otrzymujesz bezpośredni dostęp do potrzebnego Ci modelu.

Okna kontekstowe obsługują do 100,000 tokenów łącznie. Limity outputu wynoszą 16,000 tokenów na żądanie. Strumieniowanie jest dostępne poprzez Server-Sent Events. Wywoływanie funkcji i tryb JSON są w pełni obsługiwane.

Zrozumienie adresów URL bazowych i kluczy API

Podstawowy adres URL wskazuje na serwer obsługujący Twoje żądania. Zastępujesz domyślny adres URL OpenAI naszym konkretnym punktem końcowym. Nasz podstawowy adres URL to HTTPS://api.openrouterabliterated.com/v1. Ta zmiana kieruje ruch do naszej infrastruktury bez cenzury.

Klucze API uwierzytelniają Twoje żądania. Generujesz jeden klucz na konto. Klucz jest wyświetlany natychmiast po rejestracji. Możesz go zastąpić w razie potrzeby. Każde konto ma jednocześnie jeden aktywny klucz.

Ograniczenia szybkości są egzekwowane dla każdego klucza. Możesz wysyłać 300 żądań na minutę. Do 8 żądań może działać jednocześnie. Ciała żądań są ograniczone do 8 MB. Te limity dobrze radzą sobie z dużym wolumenem użycia.

Rejestracja wymaga tylko adresu e-mail lub konta Google. Nie jest wymagany numer telefonu. Klucz pojawia się natychmiast. Możesz zacząć wysyłać żądania natychmiast. Prywatność jest zachowana; prompty nie są używane do trenowania.

Dlaczego wybrać model bez cenzury do Twojego przypadku użycia?

Modele uncensored nie odrzucają legalnej treści dla dorosłych, fikcyjnych ani tematów kontrowersyjnych. Są idealne do pisania kreatywnego, gier fabularnych lub badań. Modele mainstreamowe często stosują ścisłe osłony. Mogą one przerywać ciągłość generowania.

Nasz model jest dostrojony do bezpośredniej odpowiedzi. Obsługuje treści NSFW bez sprzeciwu. Działa dobrze w filozofii politycznej lub niszowych gatunkach. Otrzymujesz spójne zachowanie bez dodatkowych promptów.

Używanie narzędzi jest obsługiwane. Możesz zdefiniować narzędzia dla swojej aplikacji. Model szanuje wybory narzędzi. Dzięki czemu nadaje się do złożonych przepływów pracy. Błędy i odrzucenia są darmowe. Płacisz tylko za rzeczywiste użycie.

Ograniczenia treści nadal mają zastosowanie. Treści seksualne z udziałem małoletnich są zawsze odrzucane. To jest twardy limit. Zapewnia to podstawowe standardy bezpieczeństwa. Wszystko inne jest dozwolone dla Twojego przypadku użycia.

Ceny tokenów: Jak obliczane są koszty

Cena opiera się na zużyciu tokenów. Tokeny wejściowe kosztują $0.15 za milion tokenów. Tokeny wyjściowe kosztują $0.50 za milion tokenów. Płacisz tylko za to, czego używasz. Nie ma ukrytych opłat.

Kredyt jest z góry opłacony. Doładowujesz go wyłącznie krypto. Akceptowane są USDT w sieci TRC20 lub USDC na Base. Dozwolona jest dowolna kwota całkowita od $20 do $500. Kredyty nigdy nie wygasają. To unika wiązania subskrypcją.

Dodatkowe środki są dostępne przy doładowaniach. Otrzymujesz +5% przy $50. +10% przy $100. +15% przy $200. Obniża to efektywny koszt. Błędy są darmowe. Odrzucenia są darmowe. Płacisz tylko za pomyślne tokeny.

Konto próbne otrzymuje 0,50 $. Jest ważne przez 7 dni. Pozwala to dokładnie przetestować API. Możesz zweryfikować integrację przed doładowaniem konta.

Odpowiedzi strumieniowe vs. nie-strumieniowe

Strumieniowanie wysyła tokeny, gdy są generowane. Zmniejsza to postrzeganą latencję. Użytkownicy widzą tekst pojawiający się w czasie rzeczywistym. Jest to kluczowe dla interfejsów czatu. Strumieniowanie bez strumieniowania czeka na pełną odpowiedź. Może to wydawać się wolne dla długich wyjść.

Obsługujemy strumieniowanie przez SSE. Ostatni fragment zawiera użycie tokenów. Pozwala to na dokładne śledzenie rozliczeń. Możesz obsłużyć częściowe odpowiedzi w sposób elegancki. Błędy są obsługiwane spójnie.

Tryb niestrumieniowy jest również dostępny. Zwraca pełną odpowiedź naraz. Jest prostszy do przetwarzania wsadowego. Wybierz tryb zgodnie z potrzebami. Oba tryby używają tego samego endpointu.

Wywoływanie funkcji może być strumieniowane. Narzędzia są wykonywane w miarę ich identyfikacji. Poprawia to interaktywność. Możesz rozpocząć przetwarzanie danych wejściowych wcześniej. API przejmuje złożoność za Ciebie.

Wywoływanie funkcji i dane strukturalne

Wywoływanie funkcji pozwala modelowi wywoływać narzędzia. Definiujesz schematy narzędzi w żądaniu. Model zwraca wywołania funkcji. Twój kod je wykonuje. To umożliwia złożone przepływy pracy. Możesz budować agentów lub asystentów.

Tryb JSON wymusza dane strukturalne. Model zwraca poprawny JSON. Jest to przydatne do ekstrakcji danych. Otrzymujesz spójne formaty. Parsowanie jest łatwiejsze. Błędy są rzadkie.

Parametry takie jak temperatura i top_p kontrolują zachowanie. Sekwencje stop ograniczają wynik. Seed zapewnia reproducowalność. Kary zmniejszają powtarzalność. Masz drobną kontrolę.

Wybór narzędzia może być automatyczny lub wymuszony. Określasz preferencje modelu. Kieruje to procesem generowania. Poprawia to niezawodność. Twoja aplikacja pozostaje solidna.

Typowe biblioteki klienckie i SDK

Większość bibliotek SDK działa po drobnych zmianach. Aktualizujesz tylko adres bazowy. Reszta kodu pozostaje bez zmian. Dotyczy to Pythona, Node.js i innych. Integracja jest prosta.

SDK OpenAI jest standardem. Obsługuje uwierzytelnianie i ponawianie prób. Przekazujesz swój klucz API. URL bazowy wskazuje na naszą usługę. Żądania są wysyłane normalnie.

Strumieniowanie jest obsługiwane we wszystkich SDK. Iterujesz po fragmentach. Użycie tokenów jest dostępne w ostatnim fragmencie. Pasuje to do naszego modelu rozliczeniowego. Błędy są przechwytywane konsekwentnie.

Wywoływanie funkcji jest wbudowane we współczesne SDK. Przekazujesz definicje narzędzi. SDK parsuje odpowiedzi. Twój kod wykonuje narzędzia. Pętla trwa do zakończenia. Jest to wydajne i niezawodne.

Rozwiązywanie typowych błędów API

Limit szybkości zwraca błędy 429. Możesz wysłać 300 żądań na minutę. Przekroczenie tego limitu wymusza oczekiwanie. Zaimplementuj wykładnicze zwalnianie. Zapobiega to przeciążeniu serwera.

Nieprawidłowe klucze zwracają błędy 401. Sprawdź swój klucz API. Upewnij się, że jest aktywny. Zmień go w razie potrzeby. Każde konto ma jeden klucz. Wygeneruj nowy, jeśli zostanie utracony.

Błędy JSON występują w trybie JSON. Upewnij się, że Twój schemat jest poprawny. Model musi zwrócić poprawny JSON. Jeśli dojdzie do błędu, spróbuj ponownie. Dostosuj temperaturę dla lepszej stabilności.

Przekroczenia limitu czasu występują przy długich generacjach. Zwiększ wartość limitu czasu. Strumieniowanie zmniejsza ryzyko przekroczenia limitu czasu. Częściowe odpowiedzi są obsługiwane. Możesz odtworzyć pełną odpowiedź.

Kolejne kroki: Uzyskanie pierwszego klucza API

Odwiedź stronę rejestracji. Użyj Google lub e-maila. Nie jest wymagany numer telefonu. Proces jest szybki. Otrzymujesz natychmiastowy dostęp.

Twój klucz API jest wyświetlany. Skopiuj go bezpiecznie. Użyj go w swoim SDK. Ustaw base URL na nasz endpoint. Zacznij wysyłać żądania.

Doładuj kryptowalutą. Akceptujemy USDT lub USDC. Otrzymaj bonusowy kredyt za większe kwoty. Kredyty nie wygasają. Używaj ich w swoim tempie.

Przetestuj kredytem próbnym. Trwa 7 dni. Zweryfikuj strumieniowanie i wywoływanie funkcji. Poznaj możliwości modelu. Zintegruj go ze swoją aplikacją. API jest gotowe do produkcji.