Dokumentacja API

Bazowy URL i autoryzacja

Podłącz swoją aplikację, wskazując na nasz dedykowany endpoint i przekazując swój unikalny klucz API. Adres bazowy dla wszystkich żądań to https://api.apertusapp.com/v1. Uzyskujesz swój klucz natychmiast po rejestracji przez Google lub e-mail na Pobierz klucz API strony. Dołącz ten klucz do Authorization nagłówek dla każdego żądania.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

Każde konto generuje jeden aktywny klucz. Jeśli wygenerujesz nowy klucz, poprzedni staje się nieprawidłowy natychmiast. Zapewnia to ścisłą kontrolę nad dostępem bez subskrypcji ani opłat za bezczynność.

Pierwsze żądanie

Wyślij pierwszy prompt do endpointu chat completions, aby otrzymać surowy, niefiltrowany tekst. Użyj identyfikatora modelu uncensored do dostępu do naszego konkretnego modelu open-weight dostosowanego do legalnych treści dla dorosłych i tematów kontrowersyjnych.

Copyfrom openai import OpenAI

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

API akceptuje standardowe parametry takie jak temperature i top_p. Błędy i odrzucenia nie zużywają tokenów, więc płacisz tylko za to, co faktycznie dotrze do modelu. To podejście utrzymuje koszty przewidywalne w porównaniu do agregatorów, które pobierają opłaty za nakład routingu.

Integracja SDK Node

Użyj oficjalnego SDK Node.js do efektywnego obsługi trybu JSON i wywoływania funkcji. Ustaw response_format do {"type": "json_object"} do wyjść strukturalnych lub zdefiniuj narzędzia dla zachowania typu agent.

Copyimport OpenAI from "openai";

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

Model obsługuje wywołania narzędzi z tool_choice opcje. Możesz również ustawić seed do deterministycznych wyników. Ta elastyczność pozwala budować złożone aplikacje bez wychodzenia z ekosystemu zgodnego z OpenAI.

Odpowiedzi strumieniowe

Strumuj tokeny w czasie rzeczywistym za pomocą Serwerowych Wydarzeń Przesyłanych Strumieniowo (SSE) dla niskiego opóźnienia w doświadczeniach użytkownika. Każdy fragment zawiera wygenerowany tekst, a ostatni fragment zawiera całkowite statystyki zużycia tokenów.

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)

Strumieniowanie zmniejsza postrzeganą opóźnienie dla użytkowników końcowych. Możesz przerwać strumień, jeśli użytkownik zmieni zdanie. API automatycznie obsługuje protokół SSE, wymagając minimalnej ilości kodu po Twojej stronie.

Okno kontekstowe i pojemność

Model obsługuje okno kontekstowe o rozmiarze 100 000 tokenów dla sumy danych wejściowych i wyjściowych. Możesz określić maksymalnie 16 000 tokenów na żądanie lub wrócić do 2048 tokenów, jeśli pominię max_tokens.

Duże okno pozwala na szczegółową analizę dokumentów lub długie historie rozmów. Jednak pamiętaj, aby rozmiary ciał żądań były mniejsze niż 8 MB. Model nie jest GPT ani Llama; jest to odrębny model AI bez cenzury zoptymalizowany pod Twój konkretny przypadek użycia.

Obsługa błędów i limity

Obsłuż standardowe błędy HTTP z gracją, aby utrzymać niezawodny przepływ aplikacji. A 401 błąd wskazuje na nieprawidłowy lub brakujący klucz API. A 402 błąd oznacza, że Twój kredyt zaliczkowy jest wyczerpany. A 429 błąd sygnalizuje, że przekroczyłeś limit 300 żądań na minutę lub 8 żądań równoległych.

Kredyt nie wygasa, więc możesz wstrzymać użycie i wznowić je później. Błędy, takie jak podwójne obciążenia, są naprawiane przez stronę Wsparcie. Kredyt z góry opłacony jest naliczany tylko za faktyczne zużycie tokenów, zapewniając przejrzyste ceny za każdy bajt.