Documentazione API per gli sviluppatori

URL Base e autenticazione

L'URL base è HTTPS://api.ollamaapiurl.com/v1. Ti autentichi passando la tua chiave API univaca nell'intestazione Authorization. Questa chiave funge da credenziale per tutte le richieste. Recuperarla dal tuo dashboard immediatamente dopo la registrazione.

• Tieni la tua chiave al sicuro. Essa garantisce l'accesso completo al tuo credito prepagato.
• Genera una nuova chiave in qualsiasi momento dalla pagina delle impostazioni.

Il sistema della nostra chiave API è semplice. Una chiave attiva per account garantisce una tracciabilità chiara. Se perdi l'accesso, rigenerala istantaneamente. Nessuna verifica del numero di telefono blocca il tuo accesso.

Prima richiesta

Invia il tuo primo prompt utilizzando HTTP standard. L'endpoint accetta input testuali e restituisce output testuali. Questo metodo funziona con qualsiasi libreria client HTTP tu preferisca.

Copycurl https://api.ollamaapiurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the local library"}]
  }'

La risposta include l'utilizzo dei token. Paghi solo per i token elaborati. Gli errori non consumano il tuo saldo prepagato. Questa trasparenza ti permette di controllare la tua spesa con precisione.

Integrazione SDK Python

Usa la libreria Python ufficiale di OpenAI. Puntala al nostro URL di base. Imposta l'ID del modello su uncensored. Questo garantisce il comportamento uncensored senza le complicazioni dell'installazione locale.

Copyfrom openai import OpenAI

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

La libreria gestisce i retry e la formattazione. Ricevi JSON strutturato o testo grezzo. È supportato anche lo streaming. Questo approccio mantiene il codice pulito e manutenibile.

Setup SDK Node

Installa il pacchetto openai. Configura l'URL base per puntare al nostro servizio. Imposta la chiave API dal tuo ambiente. Questa configurazione rispecchia da vicino la configurazione Python.

Copyimport OpenAI from "openai";

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

Gli sviluppatori Node ottengono un comportamento coerente. Il modello risponde ai prompt istantaneamente. Puoi integrarlo in qualsiasi server web o worker in background. Non è necessaria una logica di instradamento complessa.

Risposte in streaming

Abilita lo streaming impostando stream su true. L'API restituisce i chunk man mano che vengono generati. Questo migliora la latenza percepita per gli utenti. Puoi visualizzare i token man mano che appaiono.

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)

L'ultimo chunk contiene il conteggio totale dei token. Usalo per la verifica della fatturazione. Lo streaming funziona con tutti i parametri. Supporta anche le chiamate di funzione. I tuoi utenti vedono i progressi in tempo reale.

Limiti, errori e contesto

La tua finestra di contesto copre 100.000 token in totale. Questo include sia prompt che completamento. Puoi generare fino a 16.000 token per richiesta. Il limite di frequenza permette 300 richieste al minuto. Le richieste concorrenti sono limitate a otto per chiave.

Gli errori comuni includono 401 per chiavi non valide. Un errore 402 significa che il tuo credito prepagato è esaurito. Una risposta 429 segnala che hai raggiunto il limite di frequenza. Controlla la tua dashboard per ricaricare tramite criptovalute. I crediti non scadono mai. Errori come le addebiti doppi vengono risolti tramite il supporto.