Documentation API pour les développeurs

URL de base et authentification

L'URL de base est HTTPS://api.ollamaapiurl.com/v1. Vous vous authentifiez en transmettant votre clé API unique dans l'en-tête Authorization. Cette clé sert d'identifiant pour toutes les requêtes. Récupérez-la immédiatement après votre inscription depuis votre tableau de bord.

• Conservez votre clé en sécurité. Elle donne un accès complet à votre crédit prépayé.
• Générez une nouvelle clé à tout moment depuis la page des paramètres.

Notre système de clé API est simple. Une clé active par compte assure un suivi clair. Si vous perdez l'accès, régénérez-la instantanément. Aucune vérification par numéro de téléphone ne bloque votre accès.

Première demande

Envoyez votre première invite en utilisant HTTP standard. Le point de terminaison accepte l'entrée textuelle et retourne une sortie textuelle. Cette méthode fonctionne avec n'importe quelle bibliothèque cliente HTTP que vous préférez.

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 réponse inclut l'utilisation des jetons. Vous ne payez que pour les jetons traités. Les erreurs ne consomment pas votre solde prépayé. Cette transparence vous permet de contrôler vos dépenses avec précision.

Intégration SDK Python

Utilisez la bibliothèque Python officielle d'OpenAI. Pointez-la vers notre URL de base. Définissez l'ID du modèle sur uncensored. Cela garantit que vous obtenez le comportement uncensored sans les tracas de configuration 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 bibliothèque gère les réessais et le formatage. Vous obtenez du JSON structuré ou du texte brut. Le streaming est également pris en charge. Cette approche garde votre code propre et maintenable.

Installation du SDK Node

Installez le package openai. Configurez l'URL de base pour pointer vers notre service. Définissez la clé API depuis votre environnement. Cette configuration reflète étroitement la configuration 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);

Les développeurs Node obtiennent un comportement cohérent. Le modèle répond instantanément aux invites. Vous pouvez l'intégrer dans n'importe quel serveur web ou worker en arrière-plan. Aucune logique de routage complexe n'est nécessaire.

Réponses en streaming

Activez le streaming en définissant stream à true. L'API renvoie des fragments au fur et à mesure de leur génération. Cela améliore la latence perçue pour les utilisateurs. Vous pouvez afficher les jetons à mesure qu'ils apparaissent.

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)

Le dernier chunk contient le nombre total de tokens. Utilisez ceci pour la vérification de la facturation. Le streaming fonctionne avec tous les paramètres. Il prend également en charge les appels de fonctions. Vos utilisateurs voient les progrès en temps réel.

Limites, erreurs et contexte

Votre fenêtre de contexte s'étend sur 100 000 tokens au total. Cela inclut à la fois le prompt et la complétion. Vous pouvez générer jusqu'à 16 000 tokens par requête. La limite de débit permet 300 requêtes par minute. Les requêtes simultanées sont limitées à huit par clé.

Les erreurs courantes incluent 401 pour les clés invalides. Une erreur 402 signifie que votre crédit prépayé est épuisé. Une réponse 429 signale que vous avez atteint la limite de débit. Vérifiez votre tableau de bord pour recharger via crypto. Les crédits n'expirent jamais. Les erreurs comme les doubles facturations sont corrigées via le support.