Démarrage rapide pour les utilisateurs d'Ollama NSFW

Prérequis et authentification

Vous avez besoin d'une clé API et de l'URL de base pour commencer. Inscrivez-vous sur la page Obtenir la clé API avec Google ou par e-mail. Votre clé apparaît immédiatement ; aucune carte n'est requise pour l'essai. L'URL de base est https://api.ollamansfw.com/v1. Définissez-la dans votre environnement ou la configuration du SDK. L'identifiant du modèle est uncensored. Il s'agit d'un modèle à poids ouverts exécuté sur nos serveurs, distinct de GPT ou d'autres modèles de fournisseurs.

Votre première requête

Envoyez une requête standard de complétion de chat. L'API attend un tableau messages avec un rôle et un contenu. Utilisez curl pour tester la connectivité. Remplacez YOUR_API_KEY par votre clé réelle. La réponse renvoie le texte généré dans choices[0].message.content. Si vous obtenez un 401, vérifiez votre clé. Un 402 signifie que vous avez besoin de crédit.

Intégration SDK Python

Utilisez le package Python officiel openai. Installez-le via pip. Configurez le client avec l'URL de base personnalisée et la clé API. Cela assure la compatibilité avec notre endpoint. Le code ci-dessous illustre une simple génération de texte. Il gère la requête et affiche le résultat. La gestion des erreurs doit capturer les exceptions HTTP. Cette approche fonctionne pour tout client compatible OpenAI.

Intégration SDK Node.js

Installez le package Node.js openai. Définissez l'URL de base et la clé API lors de l'initialisation du client. La structure est identique à l'exemple Python. Transmettez l'identifiant du modèle uncensored. La réponse contient les données de complétion. Utilisez async/await pour un code propre. Cette méthode est idéale pour les applications côté serveur ou les outils CLI nécessitant un accès direct à l'API.

Réponses en streaming

Activez le streaming en définissant stream: true. L'API renvoie un flux d'événements envoyés par le serveur (SSE). Chaque chunk contient du texte partiel. Le dernier chunk inclut les statistiques d'utilisation des tokens. Cela réduit la latence perçue pour les réponses longues. Gérez les erreurs de flux avec précaution. Les SDK fournissent des itérateurs de flux intégrés. Traitez chaque chunk pour mettre à jour l'interface utilisateur en temps réel.

Limites, erreurs et contexte

La fenêtre de contexte est de 100 000 tokens au total. La sortie peut aller jusqu'à la fin de la fenêtre. Les limites de débit sont de 300 requêtes par minute. Les requêtes simultanées sont limitées à 8 par clé. Les corps de requête doivent être inférieurs à 8 Mo. Erreurs courantes : 401 (clé invalide), 402 (crédit insuffisant), 429 (limite de débit). Les erreurs ne consomment pas de crédit. Les refus pour contenu illicite sont gratuits. Le crédit n'expire jamais.

cURL

Copiercurl https://api.ollamansfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copierfrom openai import OpenAI

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

Node.js

Copierimport OpenAI from "openai";

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

Diffusion en continu

Copierstream = 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)