API-Dokumentation

Authentifizierung und Basis-URL

Erstellen Sie zunächst Ihren Schlüssel im Dashboard. Unsere Base-URL ist HTTPS://api.aivenice.cc/v1. Übergeben Sie Ihren Schlüssel im Authorization-Header. Ein aktiver Schlüssel pro Konto ersetzt den alten automatisch.

Erstes Anfragebeispiel

Sende eine einfache Chat-Vervollständigung, um die Konnektivität zu testen. Die Modell-ID ist "uncensored". Sie verarbeitet Text effizient ein und aus. Du kannst Parameter wie die Temperatur für Kreativität anpassen.

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)

Fehler sind kostenlos. Ablehnungen verbrauchen kein Guthaben. Dies gewährleistet eine vorhersehbare Abrechnung ab Ihrem ersten Aufruf.

Node.js-Integration

Verwenden Sie das offizielle Node-SDK für eine einfache Integration. Legen Sie die Basis-URL auf unseren Endpunkt fest. Übergeben Sie Ihren API-Schlüssel im Konfigurationsobjekt. Dieser Ansatz funktioniert mit den meisten Standard-OpenAI-kompatiblen Bibliotheken.

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);

Verwalten Sie Antworten direkt in Ihrer JavaScript-Umgebung. Die Struktur entspricht den Standardformaten von OpenAI für Vertrautheit.

Streaming-Antworten

Aktivieren Sie das Streaming, indem Sie stream auf true setzen. Sie erhalten Tokens, während sie generiert werden. Dies reduziert die wahrgenommene Latenz für Benutzer. Der letzte Chunk enthält Details zur gesamten Token-Nutzung.

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)

Die SSE-Ereignisse parsen, um Ihre Benutzeroberfläche in Echtzeit zu aktualisieren. Dies ist ideal für Chat-Schnittstellen, die sofortiges Feedback erfordern.

Parameter und Limits

Passen Sie Temperatur, top_p und Seed zur Steuerung an. Maximaler Output sind 16,000 Tokens. Kontextfenster sind 100,000 Tokens. Rate-Limit sind 300 Anfragen pro Minute. Maximale Körpergröße beträgt 8 MB.

Diese Limits gewährleisten eine stabile Leistung. Das Überschreiten der Rate-Limits gibt einen 429-Fehler zurück. Erhöhen Sie die Parallelität bei Bedarf.

Fehler und Kontextfenster

Behandeln Sie 401 für ungültige Schlüssel. Verwenden Sie 402, wenn das Guthaben niedrig ist. 429 zeigt eine überschrittene Ratenbegrenzung an. Fehler und Ablehnungen sind kostenlos. Ihr vorausbezahltes Guthaben verfällt nie. Das Kontextfenster zählt Prompt- und Completion-Tokens zusammen.

Nutzung über den letzten Chunk im Streaming überwachen. Dies hilft Ihnen, innerhalb des Budgets zu bleiben. Keine versteckten Gebühren gelten.

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"}]
  }'