Dokumentacja API dla programistów

Bazowy URL i autoryzacja

Podstawowy adres URL to HTTPS://api.ollamaapiurl.com/v1. Uwierzytelniasz się, przekazując swój unikalny klucz API w nagłówku Authorization. Klucz ten pełni funkcję Twoich danych uwierzytelniających dla wszystkich żądań. Pobierz go z panelu natychmiast po rejestracji.

• Chroń swój klucz. Zapewnia pełny dostęp do Twojego kredytu z góry.
• Wygeneruj nowy klucz w dowolnym momencie na stronie ustawień.

System naszego klucza API jest prosty. Jeden aktywny klucz na konto zapewnia jasne śledzenie. Jeśli stracisz dostęp, wygeneruj go natychmiast ponownie. Brak weryfikacji numerem telefonu nie blokuje Twojego dostępu.

Pierwsze żądanie

Wyślij pierwszy prompt używając standardowego HTTP. Endpoint akceptuje wejście tekstowe i zwraca wyjście tekstowe. Ta metoda działa z dowolną biblioteką klienta HTTP, którą wolisz.

Copycurl https://api.ollamaapiurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the local library"}]
  }'

W odpowiedzi zawarte są informacje o zużyciu tokenów. Płacisz tylko za przetworzone tokeny. Błędy nie obciążają Twojego salda zaliczkowego. Ta przejrzystość pozwala dokładnie kontrolować wydatki.

Integracja Python SDK

Użyj oficjalnej biblioteki Pythona OpenAI. Wskaż ją na nasz bazowy URL. Ustaw identyfikator modelu na uncensored. Zapewnia to zachowanie bez cenzury bez problemów z lokalną konfiguracją.

Copyfrom openai import OpenAI

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

Biblioteka automatycznie obsługuje ponowne próby i formatowanie. Otrzymujesz strukturalny JSON lub surowy tekst. Strumieniowanie również jest obsługiwane. To podejście utrzymuje czystość i łatwość utrzymania kodu.

Konfiguracja SDK Node

Zainstaluj pakiet openai. Skonfiguruj adres URL bazowy tak, aby wskazywał na naszą usługę. Ustaw klucz API ze swojego środowiska. Ta konfiguracja jest bliska konfiguracji Python.

Copyimport OpenAI from "openai";

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

Deweloperzy Node otrzymują spójne zachowanie. Model reaguje na prompty natychmiastowo. Możesz zintegrować go z dowolnym serwerem WWW lub pracownikiem w tle. Nie jest potrzebna skomplikowana logika routingu.

Odpowiedzi strumieniowe

Włącz strumieniowanie, ustawiając stream na true. API zwraca fragmenty w miarę ich generowania. Poprawia to postrzeganą opóźnienie dla użytkowników. Możesz wyświetlać tokeny w miarę ich pojawiania się.

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)

Ostatni kawałek zawiera całkowitą liczbę tokenów. Użyj tego do weryfikacji rozliczeń. Strumieniowanie działa ze wszystkimi parametrami. Obsługuje również wywoływanie funkcji. Twoi użytkownicy widzą postęp w czasie rzeczywistym.

Limity, błędy i kontekst

Twój kontekst obejmuje 100 000 tokenów łącznie. Obejmuje to zarówno prompt, jak i uzupełnienie. Możesz wygenerować do 16 000 tokenów na żądanie. Limit szybkości pozwala na 300 żądań na minutę. Równoległe żądania są ograniczone do ośmiu na klucz.

Typowe błędy obejmują 401 dla nieprawidłowych kluczy. Błąd 402 oznacza, że kredyt z góry opłacony został wyczerpany. Odpowiedź 429 sygnalizuje przekroczenie limitu szybkości. Sprawdź panel, aby doładować kryptowalutą. Kredyty nigdy nie wygasają. Błędy, takie jak podwójne obciążenia, są naprawiane przez wsparcie.