Documentazione API

Autenticazione e URL di base

Inizia generando la tua chiave sulla dashboard. Il nostro URL base è HTTPS://api.aivenice.cc/v1. Passa la tua chiave nell'intestazione Authorization. Una chiave attiva per account sostituisce automaticamente quella vecchia.

Primo esempio di richiesta

Invia un semplice completamento chat per testare la connettività. L'ID del modello è "uncensored". Gestisce input e output testuali in modo efficiente. Puoi regolare parametri come la temperatura per la creatività.

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)

Gli errori sono gratuiti. I rifiuti non consumano credito. Questo garantisce una fatturazione prevedibile dalla prima chiamata.

Integrazione Node.js

Utilizza l'SDK ufficiale Node per un'integrazione semplice. Imposta l'URL di base sul nostro endpoint. Passa la tua chiave API nell'oggetto di configurazione. Questo approccio funziona con la maggior parte delle librerie standard OpenAI-compatible.

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

Gestisci le risposte direttamente nel tuo ambiente JavaScript. La struttura corrisponde ai formati standard OpenAI per familiarità.

Risposte in streaming

Abilita lo streaming impostando stream su true. Ricevi i token man mano che vengono generati. Questo riduce la latenza percepita per gli utenti. L'ultimo chunk include i dettagli sull'utilizzo totale dei token.

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)

Analizza gli eventi SSE per aggiornare la tua UI in tempo reale. Questo è ideale per le interfacce chat che richiedono feedback istantanei.

Parametri e limiti

Regola temperatura, top_p e seed per il controllo. Output massimo è di 16.000 token. Finestra di contesto è di 100.000 token. Limite di frequenza è di 300 richieste al minuto. Dimensione massima del corpo è 8 MB.

Questi limiti garantiscono prestazioni stabili. Il superamento dei limiti di frequenza restituisce un errore 429. Aumenta la concorrenza se necessario.

Errori e finestra di contesto

Gestisci gli errori 401 per chiavi non valide. Usa 402 quando il credito è basso. Il 429 indica il superamento del limite di frequenza. Errori e rifiuti sono gratuiti. Il tuo credito prepagato non scade mai. La finestra di contesto conta i token del prompt e del completamento insieme.

Monitora l'utilizzo tramite l'ultimo chunk nello streaming. Questo ti aiuta a rimanere entro il budget. Non si applicano commissioni nascoste.

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