Szybki start dla użytkowników Grok NSFW

Uwierzytelnianie i URL bazowy

Nasz API implementuje openai kompatybilny protokół. Uwierzytelniasz się, przekazując swój unikalny klucz API w nagłówku Authorization. Podstawowy URL dla wszystkich zapytań to https://api.groknsfw.cc/v1. W przeciwieństwie do standardowych dostawców, nie wymagamy identyfikatora organizacji. Po prostu wygeneruj swój klucz przez panel lub stronę szybkiej rejestracji. Chroń swój klucz; zapewnia pełny dostęp do przedpłaconego kredytu. Nie ma miesięcznych opłat ani subskrypcji, tylko płatność za tokeny bez wygaśnięcia.

Każde zapytanie musi zawierać identyfikator modelu uncensored. Jest to model o otwartych wagach, duży model językowy hostowany na naszej infrastrukturze, odróżniający się od modeli innych dostawców. Jest dostrojony do dostarczania nieograniczonych odpowiedzi dla legalnej treści dla dorosłych, przy jednoczesnym zachowaniu wysokiej dokładności faktów. Nie musisz zmieniać wersji biblioteki klienckiej; standardowe biblioteki OpenAI SDK działają od razu.

Podstawowe uzupełnianie czatu

Wyślij standardowe zapytanie o uzupełnienie czatu, aby wygenerować tekst. Endpoint akceptuje listę wiadomości, w tym role systemowe, użytkownika i asystenta. Ta struktura pozwala zdefiniować kontekst, instrukcje i historię rozmowy. Model zwraca odpowiedź tekstową na podstawie dostarczonego promptu. Możesz kontrolować kreatywność wyjścia za pomocą parametrów takich jak temperature i top_p. Jeśli nie zostanie określony max_tokens, domyślny limit odpowiedzi to 2048 tokenów. Możesz zwiększyć to do 32 000 tokenów na zapytanie, w ramach całkowitego okna kontekstu 100 000 tokenów.

Błędy są zwracane w standardowym formacie JSON. Powszechne problemy obejmują nieprawidłowe klucze lub niewystarczający kredyt. API nie wykonuje tokenizacji za Ciebie; wysyłasz tekst, a model przetwarza go wewnętrznie. Otrzymujesz wygenerowany tekst końcowy lub częściowe strumienie, jeśli są włączone.

Odpowiedzi strumieniowe

Wywoływanie funkcji i narzędzia

API obsługuje wywoływanie funkcji, pozwalając modelowi na generowanie danych strukturalnych zamiast zwykłego tekstu. Zdefiniuj swoje narzędzia w parametrze tools, określając nazwę funkcji, opis i schemat parametrów. Gdy model uzna, że wywołanie narzędzia jest konieczne, zwraca nazwę funkcji i argumenty w formacie JSON. Twoja aplikacja wykonuje następnie funkcję i przekazuje wynik z powrotem do rozmowy. To umożliwia złożone przepływy pracy, ekstrakcję danych i automatyczne akcje. Ustaw tool_choice, aby kontrolować, czy model musi użyć narzędzia, czy może wybrać swobodnie.

Tryb JSON

Dla aplikacji wymagających ścisłych formatów wyjściowych, użyj trybu JSON. Ustaw parametr response_format na {"type": "json_object"}. Model ograniczy swoje wyjście do poprawnego JSON. Jest to idealne do parsowania danych do systemów backendowych lub generowania skonfigurowanych struktur. Zauważ, że tryb JSON może nieznacznie zmniejszyć elastyczność rozumowania modelu w porównaniu do tekstu swobodnego. Upewnij się, że Twój prompt wyraźnie instruuje model do wyprowadzania tylko JSON. Ta funkcja działa wraz z wywoływaniem funkcji, ale zapewnia prostszy interfejs, gdy potrzebujesz tylko danych strukturalnych bez definicji narzędzi.

Użycie tokenów i limity

Twoje konto jest ograniczone do 300 zapytań na minutę i 8 równoległych zapytań na klucz. Maksymalny rozmiar ciała zapytania to 8 MB. Jeśli przekroczysz te limity, API zwróci kod statusu 429. Błędy uwierzytelnienia zwracają 401, a niewystarczający kredyt zwraca 402. Cennik to $0,25 za milion tokenów wejściowych i $1,00 za milion tokenów wyjściowych. Błędy i odmowy nie zużywają kredytu. Okno kontekstu to 100 000 tokenów łącznie, w tym zarówno prompt, jak i uzupełnienie. Zarządzaj swoim użyciem tokenów ostrożnie, aby uniknąć nieoczekiwanych kosztów. Kredyt nigdy nie wygasa, a doładować możesz w dowolnym momencie używając kryptowalut.

cURL

Copycurl https://api.groknsfw.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.groknsfw.cc/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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.groknsfw.cc/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

Copystream = 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)