Bazowy URL i uwierzytelnianie
Nasz API jest zgodny ze standardem OpenAI Chat Completions. Aby korzystać z usługi, skieruj klienta pod https://api.grokapikey.com/v1 i dołącz swój unikalny klucz API w nagłówku Authorization. Możesz wygenerować ten klucz natychmiast po rejestracji, podając tylko adres e-mail i hasło. Klucz jest wyświetlany raz przy tworzeniu, więc zapisz go bezpiecznie. Jeśli go zgubisz, możesz wygenerować nowy klucz z pulpitu nawigacyjnego, co natychmiast unieważnia poprzedni. Nie musisz podawać karty kredytowej do konta próbnej.
Twoje pierwsze zapytanie
Zacznij od wysłania prostego promptu tekstowego, aby zweryfikować łączność. Użyj standardowego endpointu chat/completions z identyfikatorem modelu uncensored. Poniższy przykład pokazuje podstawowe polecenie curl do przetestowania połączenia. Potwierdza to poprawność uwierzytelniania i reakcję usługi. Możesz następnie dostosować tę strukturę do logiki swojej aplikacji.
Zamień YOUR_API_KEY na swój właściwy klucz przed uruchomieniem tego polecenia.
curl https://api.grokapikey.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."}]
}'Integracja z Python SDK
Jeśli tworzysz aplikację w Pythonie, użyj oficjalnej biblioteki openai. Skonfiguruj klienta tak, aby używał naszego bazowego URL i Twojego klucza API. Pozwala to wykorzystać znane idiomaty Pythona przy jednoczesnym dostępie do modelu bez cenzury. Klient obsługuje serializację i strumieniowanie automatycznie. Upewnij się, że w Twoim środowisku zainstalowana jest najnowsza wersja biblioteki dla najlepszej kompatybilności z naszymi endpointami.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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)Integracja z Node.js SDK
Dla projektów JavaScript lub TypeScript Node.js OpenAI SDK działa od razu. Ustaw właściwości apiKey i baseURL w swoim obiekcie konfiguracji. Zapewnia to, że wszystkie kolejne zapytania są kierowane przez naszą infrastrukturę. Możesz używać standardowych wzorców async/await do obsługi odpowiedzi. To podejście jest idealne dla aplikacji serwerowych lub funkcji brzegowych wymagających bezpośredniego dostępu do API bez przekierowania przez OpenAI.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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);Strumieniowanie odpowiedzi
Dla aplikacji korzystających z generowania tokenów w czasie rzeczywistym, włącz strumieniowanie, ustawiając stream: true w ciele żądania. API zwraca strumień zdarzeń wysłanych przez serwer (SSE) z częściowymi odpowiedziami. Zmniejsza to postrzeganą opóźnienie dla użytkowników i pozwala na natychmiastowe wyświetlanie wygenerowanego tekstu. Każdy fragment zawiera delta odpowiedzi. Obsłuż te zdarzenia w kodzie klienta, aby aktualizować interfejs użytkownika stopniowo. Strumieniowanie zużywa tokeny normalnie i nie wpływa na cenę.
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)Limity, błędy i kontekst
Każdy klucz API jest ograniczony do 300 zapytań na minutę i maksymalnego rozmiaru ciała żądania 8 MB. Jeśli przekroczysz limit zapytań, API zwróci kod statusu 429; poczekaj kilka sekund i spróbuj ponownie. Błąd 401 oznacza nieprawidłowy lub unieważniony klucz, podczas gdy błąd 402 oznacza, że Twój przedpłacony kredyt został wyczerpany. Model obsługuje okno kontekstu 100 000 tokenów dla sumy wejścia i wyjścia. Upewnij się, że Twoje prompty mieszczą się w tym limicie, aby uniknąć obcinania. Filtry treści pozostają minimalne, z wyjątkiem twardego bloku treści seksualnych involving minors.
