Documentazione API Ollama: Guida Rapida
Questa guida fornisce i dettagli concreti per la nostra API compatibile con OpenAI, consentendoti di sostituire il nostro modello senza filtri senza modificare il codice del tuo client esistente.
URL Base e Autenticazione
L'URL base è HTTPS://api.ollamaapidocs.com/v1. Passa la tua chiave nell'intestazione Authorization standard.
curl https://api.ollamaapidocs.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List installed models in the local directory"}]
}'Endpoint Chat Completions
Invia richieste POST a /v1/chat/completions con il modello impostato su uncensored.
from openai import OpenAI
client = OpenAI(base_url="https://api.ollamaapidocs.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)Supporto per streaming e strumenti
Abilita lo streaming impostando stream su true. L'API restituisce i token tramite Server-Sent Events e supporta il function calling.
stream = 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)Modalità JSON e parametri
Usa response_format json_object per output JSON rigorosi. Puoi anche regolare temperatura, top_p e sequenze di stop.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.ollamaapidocs.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);Limiti di frequenza e vincoli
Il limite è di 300 richieste al minuto per chiave. Ogni richiesta supporta una finestra di contesto di 100.000 token.
curl https://api.ollamaapidocs.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List installed models in the local directory"}]
}'Errori e finestra di contesto
Gestisci gli errori 401 per chiavi non valide, 402 per assenza di credito e 429 per i limiti di frequenza. Il modello supporta una finestra di contesto di 100,000 token.
from openai import OpenAI
client = OpenAI(base_url="https://api.ollamaapidocs.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)Domande comuni
Qual è la documentazione API ollama per questo servizio?
Questa guida copre l'URL di base, l'autenticazione e gli endpoint per la nostra API ospitata. Ti permette di utilizzare gli SDK standard di OpenAI con il nostro modello uncensored.
Come gestisco le risposte in streaming?
Imposta il parametro stream su true nella richiesta. L'API restituisce i token tramite Server-Sent Events, consentendo l'elaborazione in tempo reale.
Cosa succede se supero il limite di frequenza?
Riceverai un codice di stato 429. Il limite è di 300 richieste al minuto per chiave, con un massimo di 8 richieste concorrenti.
Genera la tua chiave API
Registrati, copia la tua chiave e aggiorna l'URL di base. È tutto ciò che serve per iniziare.
