FR ▾
Base URL https://api.uncensoredaiapis.com/v1Modèle uncensored
Obtenir une clé API
Uncensored AIGuide de migration

Comment utiliser une API compatible OpenAI en 5 étapes

L'utilisation d'une API de style OpenAI nécessite cinq étapes : obtenir une clé, installer un SDK, le pointer vers la bonne URL de base, sélectionner un modèle et envoyer des messages. Voici chacune avec du code prêt à être copié.

Mis à jour le

Cinq pierres d'étape lumineuses menant à un cube de serveur, illustrant les étapes pour commencer avec une API de style OpenAI

Points clés

  • Tout SDK OpenAI fonctionne ici une fois que vous avez changé l'URL de base vers https://api.uncensoredaiapis.com/v1 et utilisé votre propre clé.
  • L'ID du modèle est uncensored ; les routes principales sont POST /v1/chat/completions et GET /v1/models.
  • Le streaming, le mode JSON et l'appel de fonctions utilisent les mêmes paramètres que l'API officielle.
  • La tarification est de 0,15 $ par million de tokens d'entrée et de 0,50 $ par million de tokens de sortie, et vous pouvez commencer avec 0,50 $ de crédit d'essai.

Le résumé

Si vous souhaitez savoir comment utiliser des appels API de style OpenAI avec un service qui n'est pas OpenAI, la réponse est que le format de requête est une convention partagée. Un client qui le prend en charge a besoin de trois valeurs : où envoyer les requêtes (l'URL de base), qui vous êtes (la clé) et quel modèle exécuter. Modifiez ces trois valeurs et le même code fonctionnera. Ce site suit cette convention, donc les packages Python et Node.js OpenAI standards, ainsi que curl brut, fonctionnent tous contre lui.

Soyez clair sur ce que cela signifie et ce que cela ne signifie pas. Compatible signifie que l'interface correspond. Cela ne signifie pas qu'il s'agit du service officiel OpenAI ou qu'il exécute des modèles OpenAI. Le backend est un modèle à poids ouverts, géré par un fournisseur indépendant et ajusté pour répondre sans refus de contenu pour un usage adulte légal, et vous le sélectionnez avec l'ID de modèle uncensored. Il gère uniquement le texte : pas d'images, d'audio, d'embeddings ou de fine-tuning.

Les cinq étapes ci-dessous prennent environ dix minutes. Si vous préférez lire des extraits finis dans plusieurs langues, consultez la page des exemples de code.

Étape 1 : obtenir une clé

Inscrivez-vous avec Google, ou avec un e-mail et un mot de passe, et ouvrez la page clé API. Les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d'essai en un clic. Il est valable 7 jours, limité à un par personne, et ne nécessite pas de carte. Copiez la clé et stockez-la en tant que variable d'environnement au lieu de la coller dans le code :

# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"

La clé d'essai est limitée à 2 requêtes simultanées et 60 requêtes par minute. Une clé financée permet 8 requêtes simultanées et 300 par minute. Les détails de ce que comprend l'essai figurent dans la FAQ sur l'essai gratuit.

Étape 2 : installer un SDK et envoyer la première requête

Installez le package officiel pour votre langage. Ces deux bibliothèques sont les mêmes que vous utiliseriez pour tout service de style OpenAI :

# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openai

Maintenant, un premier appel en Python. La seule différence par rapport à la configuration par défaut est l'argument base_url :

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise writing assistant."},
        {"role": "user", "content": "Give me three titles for a noir short story."},
    ],
)
print(resp.choices[0].message.content)

Et le même appel en Node :

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredaiapis.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);

Étape 3 : comprendre le tableau de messages

Les modèles de chat ne se souviennent de rien entre les appels. Chaque requête contient toute la conversation sous forme de liste de messages, et chaque message a un rôle.

  • system définit le comportement et le style. Placez ici la personnalité, les règles de format et les contraintes.
  • user contient ce que la personne a demandé.
  • assistant contient les réponses précédentes du modèle. Vous les ajoutez vous-même lorsque vous poursuivez une conversation.
  • tool contient le résultat d'un appel de fonction, couvert ci-dessous.

Pour continuer un chat, ajoutez la réponse de l'assistant et le prochain message utilisateur à la même liste et envoyez-le tout à nouveau. C'est pourquoi les conversations longues coûtent plus cher : chaque appel paie pour l'historique complet en tokens d'entrée. La fenêtre de contexte contient 100 000 tokens au total, prompt et complétion confondus, donc réduire les anciennes tours est une partie normale de la construction d'une application de chat.

Les champs d'échantillonnage utiles sont transmis : temperature, top_p, stop, seed et les pénalités de fréquence et de présence. max_tokens est optionnel. Définissez-le lorsque vous souhaitez limiter la longueur de la réponse et les dépenses.

Étape 4 : streaming, mode JSON et outils

Diffusion en continu

Ajoutez stream: true pour recevoir des tokens en tant qu'événements envoyés par le serveur. Cela donne aux interfaces une sensation de rapidité, car le texte apparaît pendant que le modèle écrit encore, et l'utilisation est signalée à la fin du flux.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Mode JSON

Utilisez response_format: {"type": "json_object"} lorsque votre code analyse la réponse. Décrivez également les clés souhaitées dans le prompt.

curl https://api.uncensoredaiapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
      {"role": "user", "content": "Rate this line: the rain finally stopped."}
    ]
  }'

Appel de fonctions

Passez une liste tools avec des schémas de fonction, et optionnellement tool_choice. Lorsque le modèle souhaite exécuter une fonction, la réponse contient tool_calls. Vous exécutez la fonction dans votre propre code et renvoyez la sortie en tant que message avec le rôle tool. Les appels d'outils sont également en streaming. C'est le bloc de construction pour les agents ; la page des cas d'utilisation montre où cela paie.

Étape 5 : connaître les limites, les coûts et les erreurs

Au-delà d'une limite, l'API retourne HTTP 429. Le code d'erreur est rate_limited pour trop de requêtes par minute et concurrency pour trop de requêtes simultanées. Une surcharge temporaire donne également un 429, avec un en-tête Retry-After: 5. Une requête en flux continu conserve sa place de concurrence jusqu'à la fin du flux, alors fermez les flux que vous ne lisez plus. La limite du corps est de 8 Mo. Chaque réponse porte les en-têtes X-Request-Id et X-Balance-USD, et le premier est ce que vous indiquez au support.

Les coûts sont simples. Un appel de chat avec 3 000 tokens d'entrée et 700 tokens de sortie coûte 3 000 fois 0,15 $ par million, soit 0,00045 $, plus 700 fois 0,50 $ par million, soit 0,00035 $, soit 0,0008 $ au total. Un millier de ces appels coûtent 0,80 $. Les requêtes échouées ou refusées ne sont pas facturées, et le crédit n'expire jamais. La page tarification liste les recharges de 20 $ à 500 $ avec +5 % à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $. Vous pouvez payer uniquement avec de la crypto (USDT sur TRC20, USDC sur Base).

En quoi cela diffère de l'API officielle

Trois différences méritent d'être planifiées. Premièrement, le nom du modèle : utilisez uncensored, pas un nom de modèle OpenAI. Deuxièmement, la portée : vous obtenez uniquement les complétions de chat et la liste des modèles, donc des fonctionnalités comme la génération d'images, la parole, les embeddings et le fine-tuning ne sont pas ici. Troisièmement, le comportement : le modèle est ajusté pour ne pas refuser les requêtes adultes légales, donc la sortie peut différer d'un assistant fortement filtré. Une règle ne change jamais : pas de contenu sexuel impliquant des mineurs.

Quelques habitudes aident dès le premier jour. Gardez la clé dans une variable d'environnement, journalisez le X-Request-Id de chaque appel, et définissez max_tokens pendant que vous expérimentez afin qu'une réponse incontrôlée ne puisse pas dépenser plus que prévu. Lorsque vous construisez une interface de chat, diffusez la réponse et réduisez les anciens tours une fois que l'historique grandit. Lorsque vous construisez un pipeline qui analyse la sortie, utilisez le mode JSON et protégez toujours l'analyse, car une réponse coupée à la limite de tokens n'est pas un JSON valide. Et lorsque deux parties de votre programme appellent l'API en même temps, comptez-les contre les 8 requêtes simultanées qu'une clé complète permet.

N'oubliez pas le coût des tests. Quelques dizaines d'expériences avec des prompts courts coûtent bien moins d'un centime au total, donc le crédit d'essai de 0,50 $ est largement suffisant pendant que vous apprenez le format de requête.

Si vous déplacez une application existante, le guide de migration parcourt les modifications dans l'ordre. Les prompts envoyés ici ne sont pas utilisés pour l'entraînement. Pour la plupart des applications, la migration consiste en les trois valeurs du début de cette page et un nom de modèle.

Questions et réponses

Dois-je utiliser le SDK officiel OpenAI ?

Vous pouvez l'utiliser, c'est la méthode la plus simple. Tout client compatible OpenAI ou HTTP brut fonctionne aussi, tant qu'il prend en charge une URL de base personnalisée.

Quel nom de modèle envoie-t-on ?

Envoyez uncensored. L'URL de base est https://api.uncensoredaiapis.com/v1.

S'agit-il de l'API officielle OpenAI ?

Non. Il suit le même format de requête, mais le modèle est un modèle à poids ouverts exécuté par un fournisseur indépendant, et le service est distinct d'OpenAI.

Combien coûte une requête ?

Les tokens d'entrée coûtent 0,15 $ par 1M et les tokens de sortie 0,50 $ par 1M. Une requête avec 3 000 tokens d'entrée et 700 tokens de sortie coûte environ 0,0008 $.

Puis-je l'essayer avant de payer ?

Oui. Après l'inscription, vous pouvez réclamer 0,50 $ de crédit d'essai en un clic. Il est valable 7 jours et ne nécessite aucune carte.

Votre clé est à un formulaire de distance

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.