Best LLM API Dokumentacja
Przewodnik szybkiego startu: Integracja typu drop-in
Zintegruj nasze API LLM bez cenzury ze swoją aplikacją, zmieniając bazowy URL i klucz API w istniejącym kodzie kompatybilnym z OpenAI.
Wymagania wstępne
Przed wysłaniem pierwszej prośby upewnij się, że posiadasz ważny klucz API. Zarejestruj się na stronie Pobierz klucz API, aby natychmiast otrzymać swój klucz. Nie jest wymagana karta kredytowa do początkowego okresu próbnego. Będziesz potrzebował środowiska wspieranego języka programowania (Python 3.8+ lub Node.js 18+) oraz zainstalowanego oficjalnego SDK OpenAI w swoim projekcie.
Nasza usługa działa jako gotowa zastępcza funkcja dla standardowych endpointów chat-completions. Nie musisz instalować niestandardowej biblioteki klienta; standardowe SDK OpenAI obsługuje protokół komunikacji, w tym strumieniowanie i wywoływanie narzędzi, pod warunkiem prawidłowej konfiguracji bazowego URL.
Uwierzytelnianie
Uwierzytelnianie jest obsługiwane za pomocą nagłówka Authorization. Przekaż swój klucz API jako token Bearer. Jeśli klucz jest nieprawidłowy lub wygasł, API zwróci błąd 401 Unauthorized. Jeśli saldo Twojego konta jest niewystarczające, otrzymasz błąd 402 Payment Required. Dodaj swój klucz do zmiennych środowiskowych lub pliku konfiguracyjnego, aby uniknąć hardcodinga poświadczeń.
- Nagłówek:
Authorization: Bearer YOUR_API_KEY - Bazowy URL:
https://api.bestllmapi.com/v1
Chroń swój klucz API. Możesz go wygenerować ponownie w dowolnym momencie w panelu, co natychmiast unieważnia poprzedni klucz.
Podstawowe uzupełnianie czatu
Wyślij żądanie POST do /v1/chat/completions z identyfikatorem model ustawionym na uncensored oraz historią wiadomości. API zwraca odpowiedź tekstową. Ten endpoint obsługuje standardowe struktury JSON OpenAI, co ułatwia migrację z innych dostawców.
Upewnij się, że poprawnie strukturyzujesz swoje wiadomości z rolami takimi jak system, user i assistant. Model przetwarza dane wejściowe i generuje uzupełnienie na podstawie kontekstu Twojego promptu.
curl https://api.bestllmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Odpowiedzi strumieniowe
Aby zapewnić użytkownikom doświadczenie w czasie rzeczywistym, włącz strumieniowanie, ustawiając stream: true w ciele żądania. API zwraca strumień zdarzeń wysłanych przez serwer (SSE) zawierający obiekty delta. Każda delta zawiera fragment wygenerowanego tekstu. Przetwarzaj te fragmenty inkrementalnie, aby wyświetlać tekst w miarę jego generowania, co zmniejsza postrzegane opóźnienie dla użytkowników końcowych.
Obsługa strumienia jest identyczna ze standardowym protokołem strumieniowania OpenAI. Musisz obsłużyć zdarzenie zakończenia strumienia, aby wiedzieć, kiedy generowanie się zakończyło.
from openai import OpenAI
client = OpenAI(base_url="https://api.bestllmapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Wywoływanie funkcji
Zdefiniuj funkcje w ciele żądania za pomocą parametru tools. Model może zwrócić obiekt wywołania narzędzia zamiast bezpośredniego tekstu. Przeanalizuj nazwę funkcji i argumenty, wykonaj funkcję w swoim kodzie, a następnie wyślij wyniki z powrotem do modelu w celu uzyskania ostatecznej odpowiedzi. Pozwala to Twojemu LLM na dynamiczną interakcję z zewnętrznymi API lub bazami danych.
Wywoływanie funkcji podąża za standardowym schematem OpenAI. Upewnij się, że definicje Twoich funkcji są precyzyjne, aby poprawić dokładność modelu w wyborze właściwego narzędzia i wyodrębnieniu argumentów.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.bestllmapi.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Ograniczenia okna kontekstu
Model obsługuje okno kontekstu o rozmiarze 100 000 tokenów, łączące tokeny promptu i uzupełnienia. Monitoruj zużycie tokenów, aby uniknąć przekroczenia tego limitu, co skutkuje błędem 400 Bad Request. Jeśli przekroczysz limit zapytań wynoszący 300 zapytań na minutę, otrzymasz błąd 429 Too Many Requests.
Wdroż wykładnicze opóźnienie dla ponownych prób. Ciała żądań są ograniczone do 8 MB. W przypadku długich rozmów rozważ podsumowanie wcześniejszych wiadomości, aby pozostać w limicie tokenów, zachowując jednocześnie kontekst.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Specyfikacja techniczna
Wszystkie rzeczywiste limity i funkcje API w jednym miejscu — sprawdź je przed doładowaniem.
| Element | Wartość |
|---|---|
| Format API | zgodne z OpenAI: działa każdy SDK OpenAI — zmień base URL i klucz |
| Uwierzytelnianie | Authorization: Bearer YOUR_KEY |
| Endpointy | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.bestllmapi.com/v1 |
| ID modelu | uncensored |
| Wywoływanie funkcji | tak — tools, tool_choice; odpowiedź zawiera tool_calls, także w strumieniu; wyniki jako role: tool |
| Tryb JSON | response_format: {"type": "json_object"} |
| Maks. odpowiedź | do reszty okna 100 000 tokenów; max_tokens opcjonalne (bez osobnego limitu) |
| Okno kontekstu | 100 000 tokenów (wejście + odpowiedź) |
| Parametry | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Strumieniowanie | tak — server-sent events; ostatni fragment zawiera zużycie tokenów |
| Równoległe zapytania | do 8 jednocześnie na klucz |
| Limit zapytań | 300 zapytań na minutę na klucz |
| Rozmiar zapytania | do 8 MB |
| Nagłówki odpowiedzi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Ważność | opłacony kredyt nie wygasa, bez subskrypcji |
| Bonus | +5% od $50, +10% od $100, +15% od $200 |
| Doładowanie | USDT (TRC20) lub USDC (Base), dowolna pełna kwota od $20 do $500 |
| Cena | $0,15 za 1 mln tokenów wejścia · $0,50 za 1 mln tokenów wyjścia |
| Rozliczenie | przedpłacony kredyt według rzeczywistego zużycia; błędy i odmowy są darmowe |
| Darmowy kredyt | $0,50 na 7 dni, bez karty · Klucz próbny: 2 równoległe żądania, 60 na minutę; pełne limity (8 i 300) po pierwszym doładowaniu |
| Klucze | jeden aktywny klucz na konto; nowy zastępuje stary |
| Treści | treści dla dorosłych dozwolone; treści seksualne z udziałem nieletnich są odrzucane |
| Logowanie | Google albo e-mail i hasło |
Kody błędów
Błędy wracają jako JSON ze stałym type; nieudane i odrzucone zapytania są bezpłatne.
| Kod | Typ | Znaczenie |
|---|---|---|
400 | bad_request | błędny JSON, puste wiadomości, zły parametr lub za długi kontekst |
401 | missing_key · invalid_key · key_revoked | brak klucza, zły klucz lub klucz zastąpiony nowym |
402 | no_credit | brak kredytu — doładuj, działa od razu |
403 | content_blocked | treści seksualne z nieletnimi — odmowa, bez opłaty |
404 | not_found | nieznany endpoint |
413 | request_too_large | treść większa niż 8 MB |
429 | rate_limited · concurrency | ponad 300/min lub 8 równolegle — odczekaj i ponów |
503 | upstream_busy | model zajęty — ponów za kilka sekund |
Pytania i odpowiedzi
Czy to API jest kompatybilne z oficjalnym SDK OpenAI?
Tak, jest w pełni kompatybilne. Wystarczy zmienić bazowy URL i klucz API w istniejącej konfiguracji SDK OpenAI, aby korzystać z tej usługi.
Co się stanie, przekroczę limit zapytań?
API zwróci błąd 429 Too Many Requests. Powinieneś wdrożyć logikę ponownych prób z wykładniczym opóźnieniem, aby obsłużyć to w sposób elegancki.
Czy mogę użyć tego API do generowania obrazów?
Nie, to API obsługuje tylko uzupełnianie tekstu. Nie obsługuje endpointów do generowania obrazów, audio ani wideo.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.