Dokumentacja API

Uwierzytelnianie i URL bazowy

Zacznij od wygenerowania swojego klucza na panelu. Nasz podstawowy adres URL to HTTPS://api.aivenice.cc/v1. Przekaż swój klucz w nagłówku Authorization. Jeden aktywny klucz na konto automatycznie zastępuje poprzedni.

Przykład pierwszego żądania

Wyślij proste ukończenie czatu, aby przetestować łączność. ID modelu to "uncensored". Skutecznie obsługuje tekst wejściowy i wyjściowy. Możesz dostosować parametry, takie jak temperatura, aby zwiększyć kreatywność.

Copyfrom openai import OpenAI

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

Błędy są darmowe. Odmowy nie zużywają kredytu. Gwarantuje to przewidywalne rozliczenia od pierwszego wywołania.

Integracja Node.js

Użyj oficjalnego SDK Node.js dla łatwej integracji. Ustaw adres bazowy na nasz punkt końcowy. Przekaż swój klucz API w obiekcie konfiguracji. To podejście działa z większością standardowych bibliotek kompatybilnych z OpenAI.

Copyimport OpenAI from "openai";

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

Obsłuż odpowiedzi bezpośrednio w środowisku JavaScript. Struktura odpowiada standardowym formatom OpenAI dla łatwości użycia.

Odpowiedzi strumieniowe

Włącz strumieniowanie, ustawiając stream na true. Otrzymujesz tokeny w miarę ich generowania. Zmniejsza to postrzeganą latencję dla użytkowników. Ostatni fragment zawiera szczegóły całkowitego 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)

Przetwarzaj zdarzenia SSE, aby aktualizować interfejs użytkownika w czasie rzeczywistym. Jest to idealne dla interfejsów czatu wymagających natychmiastowej informacji zwrotnej.

Parametry i limity

Dostosuj temperaturę, top_p i seed dla pełnej kontroli. Maksymalna liczba tokenów wyjściowych to 16 000. Okno kontekstowe wynosi 100 000 tokenów. Limit szybkości to 300 żądań na minutę. Maksymalny rozmiar ciała żądania to 8 MB.

Te limity zapewniają stabilną wydajność. Przekroczenie limitów szybkości zwraca błąd 429. Zwiększ współbieżność, jeśli jest to konieczne.

Błędy i okno kontekstowe

Obsłuż błędy 401 dla nieprawidłowych kluczy. Użyj 402, gdy środki są niskie. 429 oznacza przekroczenie limitu szybkości. Błędy i odrzucenia są darmowe. Twoje prepaydowane środki nigdy nie wygasają. Okno kontekstowe liczy tokeny promptu i odpowiedzi łącznie.

Monitoruj użycie poprzez ostatni kawałek w strumieniowaniu. Pomaga to pozostać w granicach budżetu. Nie ma ukrytych opłat.

cURL

Copycurl https://api.aivenice.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the latest error logs from server logs"}]
  }'