Apertus ia API Documentation

1. Quickstart: Connect Your First Request

Podstawowy adres URL to https://api.apertusia.com/v1. Przekaż swój klucz API w nagłówku Authorization. Identyfikator modelu to uncensored. To ustawienie działa z dowolnym klientem kompatybilnym z OpenAI.

Użyj tej komendy cURL, aby natychmiast przetestować łączność. Zastąp YOUR_API_KEY swoim właściwym kluczem.

Copycurl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

Błędy uwierzytelniania zwracają 401. Niewystarczające środki zwracają 402. Limity częstości zwracają 429.

2. Obsługiwane parametry: Temperatura, Top P i Seed

Kontroluj losowość za pomocą temperature, różnorodność za pomocą top_p oraz powtarzalność za pomocą seed. Parametry te są zgodne ze standardowymi konwencjami OpenAI. Ustaw temperature na 0.7 dla zrównoważonego wyniku lub 1.0 dla większej kreatywności. Użyj top_p, aby ograniczyć próbkowanie do najwyższej masy prawdopodobieństwa. Parametr seed zapewnia identyczne wyniki przy debugowaniu.

Przykładowy fragment kodu Pythona do testów lokalnych:

Copyfrom openai import OpenAI

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

3. Strumieniowanie odpowiedzi za pomocą zdarzeń wysłanych przez serwer (SSE)

Włącz strumieniowanie, ustawiając stream: true. API zwraca fragmenty za pomocą Server-Sent Events. Każdy fragment zawiera częściowy tekst oraz dane dotyczące zużycia tokenów. Zmniejsza to postrzeganą opóźnienie dla długich odpowiedzi. Obsługuj zdarzenia SSE, aby aktualizować interfejs użytkownika w czasie rzeczywistym.

Przykład w Node.js z oficjalnym SDK:

Copyimport OpenAI from "openai";

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

4. Konfiguracja wywoływania funkcji i trybu JSON

Użyj response_format z wartością {"type": "json_object"}, aby uzyskać ścisły format JSON. Zapewnia to dane strukturalne dla potoków programistycznych. Włącz wywoływanie funkcji, dostarczając tablicę tools w ciele żądania. Model zwróci wywołania narzędzi w oczekiwanym formacie. Użyj tool_choice, aby wymusić określone zachowanie.

5. Limity szybkości i ograniczenia rozmiaru żądań

Każdy klucz API obsługuje 300 żądań na minutę. Żądania współbieżne są ograniczone do 8 na klucz. Maksymalny rozmiar ciała żądania to 8 MB. Okno kontekstowe mieści łącznie 100,000 tokenów. Maksymalna ilość outputu na żądanie wynosi do pełnego 100,000-tokenowego okna. Nie ustawiaj max_tokens lub ustaw go na wysoką wartość, aby uniknąć obcinania. Błędy nie zużywają kredytu. Zwrotów nie wystawia się, ale błędy rozliczeniowe są korygowane przez Support.

6. Autoryzacja i obsługa błędów

Wygeneruj klucz w panelu. Zaloguj się przez Google lub podaj adres e-mail. Klucz pojawi się natychmiast. Dodaj go do nagłówka Authorization: Bearer. Nieprawidłowe klucze zwracają błąd 401. Błędy 429 oznaczają wyczerpanie limitu zapytań. Błędy 402 oznaczają wyczerpanie środków z konta z góry opłaconego. Doładuj konto za pomocą USDT lub USDC. Środki nigdy nie wygasają.

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)