Documentation API Ollama pour les développeurs

Authentification et URL de base

Utiliser https://api.ollamaendpointurl.com/v1 comme votre URL de base et incluez votre clé API dans le Authorization header.

• URL de base: https://api.ollamaendpointurl.com/v1
• En-tête: Authorization: Bearer YOUR_API_KEY

Générez votre clé instantanément via Google ou e-mail sur le tableau de bord. Aucun numéro de téléphone n'est requis. Cette URL fonctionne avec n'importe quel SDK OpenAI standard en remplaçant l'URL de base.

Première demande

Envoyez une requête POST à /v1/chat/completions avec l'ID du modèle uncensored et vos messages.

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

Cela renvoie une réponse JSON contenant le texte généré. Si vous recevez une erreur 401, votre clé API est invalide. Une erreur 402 indique un crédit prépayé insuffisant.

Intégration du SDK Python

Initialisez le client avec votre clé et l'URL de base personnalisée pour envoyer des requêtes de manière programmatique.

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)

Définir max_tokens pour contrôler la longueur de la sortie. Sans cela, la valeur par défaut est de 2 048 tokens. Le modèle accepte des paramètres standards comme temperature et top_p pour ajuster le comportement de génération.

Intégration du SDK Node

Configurez le client Node.js pour pointer vers notre point de terminaison pour une intégration transparente dans vos scripts.

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

Le SDK gère automatiquement la sérialisation. Assurez-vous d'utiliser une version récente du SDK OpenAI qui prend en charge les URL de base personnalisées. Les erreurs sont levées sous forme d'exceptions API standard.

Réponses en streaming

Activez le streaming en définissant stream: true pour recevoir des tokens via les 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)

Les détails d'utilisation des tokens apparaissent dans le dernier chunk du flux. Cela réduit la latence perçue pour les sorties longues. Le point de terminaison prend en charge le formatage SSE standard compatible avec la plupart des bibliothèques clientes.

Limites de débit et fenêtre de contexte

Chaque clé API est limitée à 300 requêtes par minute et 8 requêtes simultanées. La fenêtre de contexte est de 100 000 tokens au total. Le maximum de sortie par requête est de 16 000 tokens. Les requêtes dépassant 8 Mo dans le corps sont rejetées. Une erreur 429 indique que vous avez atteint la limite de taux. Attendez brièvement avant de réessayer. Les erreurs et les refus ne consomment pas de crédit. Le crédit n'expire jamais. Utilisez la crypto pour recharger. Commencez avec un crédit d'essai de 0,50 $. Obtenez votre clé maintenant.