Documentazione API Ollama per Sviluppatori

Autenticazione e Base URL

Usa https://api.ollamaendpointurl.com/v1 come tuo URL di base e includi la tua chiave API in Authorization header.

• URL Base: https://api.ollamaendpointurl.com/v1
• Intestazione: Authorization: Bearer YOUR_API_KEY

Genera la tua chiave istantaneamente tramite Google o email dalla dashboard. Non è richiesto il numero di telefono. Questo URL funziona con qualsiasi SDK OpenAI standard sovrascrivendo l'URL di base.

Prima richiesta

Invia una richiesta POST a /v1/chat/completions con l'ID del modello uncensored e i tuoi messaggi.

Copycurl https://api.ollamaendpointurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the default port for Ollama?"}]
  }'

Questa restituisce una risposta JSON contenente il testo generato. Se ricevi un errore 401, la tua chiave API non è valida. Un errore 402 indica credito prepagato insufficiente.

Integrazione SDK Python

Inizializza il client con la tua chiave e l'URL base personalizzato per inviare richieste in modo programmatico.

Copyfrom openai import OpenAI

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

Imposta max_tokens per controllare la lunghezza dell'output. Senza di esso, il valore predefinito è 2.048 token. Il modello accetta parametri standard come temperature e top_p per la regolazione del comportamento di generazione.

Integrazione SDK Node

Configura il client Node.js per puntare al nostro endpoint per un'integrazione trasparente nei tuoi script.

Copyimport OpenAI from "openai";

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

L'SDK gestisce automaticamente la serializzazione. Assicurati di utilizzare una versione recente dell'SDK OpenAI che supporti gli URL di base personalizzati. Gli errori vengono sollevati come eccezioni API standard.

Risposte in streaming

Abilita lo streaming impostando stream: true per ricevere token tramite Server-Sent Events (SSE).

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)

I dettagli sull'utilizzo dei token appaiono nell'ultimo chunk dello stream. Questo riduce la latenza percepita per gli output lunghi. L'endpoint supporta la formattazione SSE standard compatibile con la maggior parte delle librerie client.

Limiti di frequenza e finestra di contesto

Ogni chiave API è limitata a 300 richieste al minuto e 8 richieste concorrenti. La finestra di contesto è di 100.000 token in totale. L'output massimo per richiesta è di 16.000 token. Le richieste con un corpo di dimensioni superiori a 8 MB vengono rifiutate. Un errore 429 indica che hai raggiunto il limite di frequenza. Attendi brevemente prima di riprovare. Gli errori e i rifiuti non consumano credito. Il credito non scade mai. Usa le criptovalute per ricaricare. Inizia con un credito di prova da $0.50. Ottieni la tua chiave ora.