Documentation API Compatible OpenAI

Authentification et configuration de l'URL de base

Votre clé API authentifie chaque requête adressée à nos serveurs. Inscrivez-vous simplement avec Google ou une adresse e-mail et copiez la clé depuis votre tableau de bord. Collez-la dans votre variable d'environnement comme DEEPSEEK_API_KEY et pointez votre client vers https://api.keyapideepseek.com/v1. Cette URL de base fonctionne avec n'importe quelle bibliothèque standard compatible OpenAI.

Copycurl https://api.keyapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
  }'

Vous pouvez vérifier votre configuration en listant les modèles disponibles. La réponse confirme que votre clé est valide et active. Cette étape garantit que votre intégration pointe vers le bon endpoint uncensored avant d'envoyer des prompts.

Point de terminaison Chat Completions

Le POST /v1/chat/completions le point de terminaison accepte votre invite et renvoie la réponse du modèle. Vous envoyez un corps JSON contenant des messages, vos instructions système et des paramètres comme la température. L'ID du modèle est toujours uncensored. Ce modèle unique gère tous vos besoins de génération de texte sans complexité de routage.

Copyfrom openai import OpenAI

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

Le SDK Python gère automatiquement les requêtes HTTP. Vous transmettez votre clé et l'URL de base au constructeur du client. Le reste du code reflète les modèles OpenAI standards. Cela garantit que vous pouvez changer de fournisseur plus tard sans réécrire toute la logique de votre application.

Réponses en streaming et consommation de jetons

Activez le streaming en définissant stream: true dans votre requête. L'API renvoie un flux de fragments d'événements envoyés par le serveur (SSE). Chaque fragment contient du texte partiel et des statistiques d'utilisation. Le dernier fragment inclut les comptes totaux de jetons pour la requête.

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 streaming réduit la latence perçue pour les utilisateurs. Vous pouvez afficher les tokens à mesure qu'ils arrivent. C'est crucial pour la génération de contenu long ou les interfaces de chat interactives. Surveillez l'utilisation des tokens dans le dernier fragment pour suivre précisément la consommation de votre crédit prépayé.

Mode JSON et appel de fonctions

Imposer une sortie structurée en définissant response_format à {"type": "json_object"}. Le modèle renverra du JSON au lieu de texte libre. C'est idéal pour les intégrations API ou les tâches d'extraction de données. Vous pouvez également définir des définitions de fonctions dans votre demande pour l'utilisation d'outils.

Le modèle prend en charge tool_choice paramètres. Vous pouvez forcer des fonctions spécifiques ou laisser le modèle décider. Cette flexibilité vous permet de construire des agents complexes. Assurez-vous que vos schémas de fonctions sont strictement typés pour éviter les erreurs d’analyse dans votre code client.

Limites de débit et concurrence

Chaque clé API est limitée à 300 requêtes par minute. Vous pouvez activer jusqu'à 8 requêtes simultanées. La taille maximale du corps de la requête est de 8 Mo. Ces limites empêchent les abus et garantissent des performances stables pour tous les utilisateurs. Le dépassement de ces limites renvoie une erreur 429.

Implémentez une régression exponentielle dans votre code client. Réessayez les requêtes échouées après un court délai. Cela gère les problèmes réseau transitoires avec élégance. Votre crédit prépayé n'est facturé que pour les complétions réussies, et non pour les nouvelles tentatives limitées par le débit.

Gestion des erreurs et refus

Une erreur 401 signifie que votre clé est invalide ou expirée. Une erreur 402 indique un solde prépayé insuffisant. Une erreur 429 signale que vous avez atteint la limite de taux. Le modèle refuse les requêtes contenant du contenu sexuel impliquant des mineurs. Tout autre contenu adulte légal est autorisé.

Vérifiez le corps de la réponse d'erreur pour des messages détaillés. Journalisez ces erreurs pour déboguer les problèmes d'intégration. Votre crédit n'est pas consommé pour les requêtes échouées. Ce modèle de facturation transparent vous aide à prédire les coûts avec précision sans frais cachés.

Node.js

Copyimport OpenAI from "openai";

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