Dokumentacja API

Bazowy URL i autoryzacja

API żyje w https://api.ollamauncensoredmodels.com/v1Autoryzacja Nagłówek z tokenem Bearer. Ta konfiguracja działa z dowolną biblioteką klienta zgodną z OpenAI, ponieważ przestrzegamy tych samych wzorców uwierzytelniania. Możesz natychmiast wygenerować swój klucz za pomocą Google lub e-maila bez podawania numeru telefonu. System wydaje jeden aktywny klucz na konto, zastępując poprzedni klucz natychmiast po jego wygenerowaniu. Zapewnia to spójny dostęp bez konieczności zarządzania wieloma poświadczeniami jednocześnie.

Wykonywanie pierwszego żądania

Wyślij żądanie POST do /v1/chat/completions z identyfikatorem modelu ustawionym na "uncensored". Punkt końcowy akceptuje standardowe parametry takie jak messages, temperature, a także max_tokens. Zwraca odpowiedzi JSON zawierające wygenerowany tekst oraz statystyki użycia tokenów. Możesz szybko przetestować łączność, weryfikując listę modeli lub wysyłając prosty prompt. To bezpośrednie podejście eliminuje złożoność proxy lub logiki routingu, często spotykanej w innych usługach.

Copycurl https://api.ollamauncensoredmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the output for 2 plus 2"}]
  }'

Integracja SDK Python

Użyj oficjalnej biblioteki Pythona OpenAI do połączenia, nadpisując base URL. Ustaw atrybuty klucza API i base URL przed wykonaniem jakichkolwiek wywołań. Pozwala to na wykorzystanie istniejących baz kodu bez przepisywania logiki klienta. Biblioteka automatycznie obsługuje serializację i parsowanie błędów. Możesz strumieniować odpowiedzi lub żądać synchronicznych completionów w zależności od wymagań dotyczących opóźnień Twojej aplikacji. Ta metoda zapewnia kompatybilność ze standardowymi praktykami programistycznymi stosowanymi w branży.

Copyfrom openai import OpenAI

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

Korzystanie z SDK Node.js

Zainicjuj klienta OpenAI z podstawowym adresem URL i kluczem API w środowiskach Node.js. Przekaż identyfikator modelu "uncensored" do metody ukończenia czatu. SDK efektywnie obsługuje żądania HTTP i parsuje odpowiedzi JSON. Możesz zintegrować to bezpośrednio z trasami Express lub funkcjami serverless. Struktura kodu odzwierciedla standardowe implementacje OpenAI, co ułatwia migrację z innych dostawców. To podejście zachowuje bezpieczeństwo typów i obsługę błędów spójną z nowoczesnym rozwojem JavaScript.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamauncensoredmodels.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 i zużycie tokenów

Włącz strumieniowanie, ustawiając stream: true w Twoim żądaniu. Serwer zwraca Zdarzenia Wysyłane przez Serwer (SSE) w celu dostarczania tokenów w czasie rzeczywistym. Szczegóły dotyczące zużycia tokenów pojawiają się tylko w ostatnim chunku strumienia, aby zminimalizować narzut. Pozwala to na wyświetlanie odpowiedzi progresywnie użytkownikom bez oczekiwania na całe wygenerowanie. Możesz śledzić kumulacyjne liczniki tokenów dla przejrzystości rozliczeń. Strumieniowanie jest idealne dla interfejsów czatu, gdzie natychmiastowa informacja zwrotna znacząco poprawia doświadczenie użytkownika.

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)

Limity, Błędy i Kontekst

Każdy klucz API obsługuje 300 żądań na minutę i osiem jednoczesnych połączeń. Limit rozmiaru ciała żądania wynosi 8 MB, a okno kontekstowe obejmuje łącznie 100,000 tokenów. Błędy takie jak 401 oznaczają nieprawidłowy klucz, podczas gdy 402 sygnalizuje niewystarczające środki. Status 429 oznacza, że przekroczyłeś limit szybkości. Model odrzuca tylko treści seksualne z udziałem małoletnich, zapewniając szerokie zastosowanie w przypadkach dla dorosłych. Kredyt nie wygasa, więc możesz wstrzymać użytkowanie między projektami bez utraty środków. Ta przewidywalna struktura pomaga efektywnie planować pojemność dla aplikacji o dużym ruchu.