Szybki start: Połącz swój klient
Wysyłaj żądania do https://api.isgeminiuncensored.com/v1 używając standardowych SDK OpenAI. Nasza usługa działa jako zamiennik typu drop-in dla innych dostawców, więc wystarczy zaktualizować bazowy URL i podać swój klucz API. Możesz wygenerować klucz natychmiast przez panel, używając Google lub e-maila. To rozwiązanie eliminuje potrzebę złożonego proxy lub niestandardowych promptów jailbreak.
Uwierzytelnianie opiera się na jednym aktywnym kluczu API na konto. Jeśli wygenerujesz nowy klucz, poprzedni staje się nieprawidłowy natychmiast. Gwarantuje to ścisłą kontrolę nad użyciem, jednocześnie zachowując prywatność Twoich danych. Twoje prompty nie są używane do trenowania modeli, więc Twoje dzieła pozostają Twoje.
Pierwsze żądanie: przykład cURL
Upewnij się o połączeniu, wysyłając prosty request na uzupełnienie tekstu (text completion). Użyj standardowego endpointu uzupełnień czatu z identyfikatorem modelu uncensored. Odpowiedź zwróci wygenerowany tekst na podstawie Twojego wejścia bez standardowych odrzuceń treści.
To podstawowe testowanie potwierdza, że Twój klucz jest ważny, a endpoint jest osiągalny. Możesz następnie zintegrować ten wzorzec z logiką swojej aplikacji. Struktura odpowiedzi odzwierciedla format OpenAI, zapewniając kompatybilność z większością istniejących narzędzi.
curl https://api.isgeminiuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top five Linux commands for network troubleshooting."}]
}'Zacznij od prostych promptów, aby zweryfikować jakość wyjścia. Możesz następnie zwiększyć skalę do bardziej złożonych interakcji, gdy będzie to potrzebne. System przejmuje ciężką pracę zarządzania kontekstem za Ciebie.
Integracja SDK Python
Korzystaj z oficjalnej biblioteki Pythona, aby zintegrować nasze API ze swoimi skryptami. Ustaw base URL na nasz endpoint i podaj swój klucz API. To podejście pozwala wykorzystać istniejące bazy kodu przy minimalnych zmianach. Możesz używać strumieniowania lub wywołań synchronicznych w zależności od swoich potrzeb.
SDK Python automatycznie obsługuje serializację Twoich żądań. Możesz przekazywać parametry takie jak temperature i top_p, aby kontrolować wynik. Ta elastyczność pozwala na dopracowanie zachowania modelu dla Twojego konkretnego przypadku użycia. Niezależnie od tego, czy budujesz chatbota, czy narzędzie analityczne, SDK upraszcza ten proces.
from openai import OpenAI
client = OpenAI(base_url="https://api.isgeminiuncensored.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)Upewnij się, że poprawnie obsługujesz obiekty odpowiedzi. SDK zwraca dane strukturalizowane, które można łatwo przeanalizować. Ułatwia to debugowanie i testowanie. Możesz również używać klientów async dla aplikacji o wysokim przepływie.
Integracja SDK Node
Zintegruj się z aplikacjami Node.js, korzystając z oficjalnego pakietu npm OpenAI. Wskaż klienta na nasz bazowy adres URL i ustaw klucz API. Pozwala to na korzystanie z znanych wzorców w projektach JavaScript. Możesz wykonywać wywołania synchroniczne lub asynchroniczne bez trudu.
SDK Node obsługuje nowoczesne funkcje JavaScript, takie jak promise i async/await. To sprawia, że obsługa błędów i przetwarzanie odpowiedzi są czyste. Możesz przekazać te same parametry co w SDK Python, aby dostosować zachowanie modelu. Ta spójność między językami zmniejsza krzywą uczenia się dla zespołów używających wielu technologii.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.isgeminiuncensored.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);Przetestuj swoją integrację prostym zapytaniem. Odpowiedź potwierdzi, że Twoja konfiguracja jest poprawna. Możesz następnie przejść do budowania bardziej złożonych interakcji. SDK efektywnie obsługuje żądania HTTP, zapewniając niskie opóźnienia.
Odpowiedzi strumieniowe
Włącz strumieniowanie, ustawiając stream ustaw na true. Pozwala to na otrzymywanie tokenów w miarę ich generowania. Funkcja ta jest idealna dla interfejsów czatu, gdzie natychmiastowa informacja zwrotna jest kluczowa. Zmniejsza to znacząco postrzeganą latencję dla użytkownika końcowego.
Odpowiedź jest dostarczana jako sekwencja zdarzeń wysyłanych przez serwer (SSE). Każdy fragment zawiera część wygenerowanego tekstu. Możesz połączyć te fragmenty, aby utworzyć kompletną odpowiedź. Ostatni fragment zawiera również statystyki użycia tokenów do rozliczeń.
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)Obsługuj przerwy w sieci w sposób elegancki. Strumieniowanie może być wstrzymane lub wznowione w zależności od możliwości klienta. Ta elastyczność zapewnia płynne doświadczenie użytkownika nawet na niestabilnych połączeniach. Możesz zatrzymać strumień wcześniej, jeśli użytkownik zmieni swoje wejście.
Limity, Błędy i Kontekst
Twoje konto ma limit szybkości 300 żądań na minutę i 8 równoległych żądań na klucz. Jeśli przekroczysz ten limit, otrzymasz błąd 429. Możesz monitorować swoje użycie w panelu, aby uniknąć przerw. Ten limit zapewnia sprawiedliwy dostęp dla wszystkich użytkowników.
Wsparcie okna kontekstowego wynosi do 100 000 tokenów dla promptu i odpowiedzi łącznie. Możesz ustawić maksymalną długość odpowiedzi na 16 000 tokenów na żądanie. Jeśli nie określisz limitu, domyślnie wynosi on 2 048 tokenów. Błędy i odrzucenia nie pobierają Twojej zaliczonej kredytu.
Typowe błędy obejmują 401 dla nieprawidłowych kluczy oraz 402 dla niewystarczającego kredytu. Doładować można tylko kryptowalutą. Akceptowane są USDT w sieci TRC20 lub USDC w sieci Base. Błędy, takie jak podwójne obciążenia, są naprawiane przez Wsparcie. Twój kredyt z góry opłacony nigdy nie wygasa, więc możesz doładować we własnym tempie. Ta struktura zapewnia przewidywalność i przejrzystość kosztów.
