Dokumentacja API

Szybki start: Połącz pierwsze żądanie

Zacznij od wygenerowania swojego klucza na panelu. Podstawowy adres URL dla wszystkich żądań to HTTPS://api.filterno.cc/v1. Przekaż swój klucz w nagłówku Authorization jako token bearer. Ta konfiguracja działa z dowolnym standardowym klientem kompatybilnym z OpenAI.

Przetestuj łączność natychmiast za pomocą prostego żądania uzupełnienia. Punkt końcowy akceptuje standardowe formaty czatu i zwraca surowy tekst bez filtrów treści.

Zamień YOUR_API_KEY na ciąg wydany Twojemu kontu. Ciało żądania definiuje model i treść wiadomości. Otrzymujesz odpowiedź zawierającą wygenerowany tekst.

Punkt końcowy: POST /v1/chat/completions

Wyślij swoje prompty do POST /v1/chat/completions. To jest jedyny endpoint czatu, który obsługujemy. Podajesz instrukcję systemową i wiadomości użytkownika w formacie tablicy.

Identyfikator modelu to "uncensored". Przetwarza wejście tekstowe i zwraca wyjście tekstowe. Nie oczekuj generowania obrazów ani audio tutaj.

Ustaw temperaturę, aby kontrolować losowość. Wyższe wartości dają bardziej kreatywne wyniki. Niższe wartości dają wyniki deterministyczne. API ściśle przestrzega schematu OpenAI dla tego punktu końcowego.

Punkt końcowy: GET /v1/models

Zweryfikuj dostępne modele żądaniem GET do /v1/models. Punkt końcowy zwraca listę obsługiwanych identyfikatorów modeli. Powinieneś zobaczyć "uncensored" w odpowiedzi.

Ten punkt końcowy potwierdza ważność Twojego klucza API. Pokazuje również szczegóły modelu. Użyj go do debugowania problemów z łącznością.

Odpowiedź zawiera identyfikator modelu i typ obiektu. Nie wymienia cen ani limitów. Sprawdź dokumentację w celu uzyskania stawków za tokeny.

Parametry: Temperatura, Top-P, Narzędzia

Kontroluj różnorodność generowania za pomocą temperature i top_p. Temperature dostosowuje rozkład prawdopodobieństwa. Top_p filtruje tokeny o niskim prawdopodobieństwie. Razem balansują kreatywność i skupienie.

Używaj wywoływania funkcji do interakcji ustrukturyzowanych. Zdefiniuj narzędzia w ciele żądania. Model może wywoływać te funkcje. Przekaż tool_choice, aby wymusić konkretne zachowanie.

Ustaw sekwencje stop, aby zakończyć generowanie wcześniej. Użyj seed dla odtwarzalnych wyników. Penalties obecności i częstotliwości zmniejszają powtarzalność. Te parametry遵循 standardowych konwencji OpenAI.

Odpowiedzi strumieniowe (SSE) i zużycie tokenów

Włącz strumieniowanie, ustawiając stream na true. API zwraca zdarzenia wysyłane serwerowo (SSE). Każdy fragment zawiera częściowe dane tokena.

Zużycie tokenów pojawia się w ostatnim fragmencie. Przeczytaj go, aby śledzić koszty. Strumieniowanie zmniejsza postrzeganą latencję dla długich odpowiedzi. Jest idealne dla aplikacji w czasie rzeczywistym.

Przetwarzaj strukturę danych SSE ostrożnie. Obsłuż przerwania sieciowe z gracją. API zapewnia integralność danych poprzez granice fragmentów.

Limity, Błędy i Arytmetyka Tokenów

Otrzymujesz 300 żądań na minutę na klucz. Równoległość jest ograniczona do 8 jednoczesnych żądań. Maksymalny rozmiar treści żądania to 8 MB.

Okno kontekstowe wynosi 100 000 tokenów. Obejmuje ono prompt i uzupełnienie. Maksymalna długość odpowiedzi to 16 000 tokenów. Ustaw max_tokens, aby ograniczyć zużycie.

Obsłuż błędy, sprawdzając kody statusu. 401 oznacza nieprawidłowy klucz. 402 wskazuje na brak środków. 429 sygnalizuje limit szybkości. Ponów próbę z wykładniczym opóźnieniem dla błędu 429.

cURL

Copycurl https://api.filterno.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five risks in a standard React application."}]
  }'

Python

Copyfrom openai import OpenAI

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