API Character AI : Changez de client en trois lignes

Prérequis

Avant d'écrire du code, vous avez besoin d'un compte actif sur characteraiapi.com. Rendez-vous sur la page Obtenir la clé API et inscrivez-vous avec simplement une adresse e-mail et un mot de passe. Aucune carte bancaire n'est requise pour commencer, et les nouveaux comptes reçoivent 0,50 $ de crédit d'essai gratuit valable 7 jours. Une fois inscrit, votre clé API s'affiche immédiatement. Conservez cette clé en sécurité, car elle authentifie toutes les requêtes vers l'endpoint. Vous aurez également besoin d'un SDK de langage pris en charge installé dans votre environnement de développement. L'endpoint character ai api accepte les paramètres OpenAI standard, donc tout client compatible OpenAI existant peut fonctionner avec des modifications minimales.

Installer le SDK

Pour les projets Python, installez le package officiel OpenAI à l'aide de pip. Cette bibliothèque gère automatiquement la sérialisation JSON et les requêtes HTTP. Pour les applications Node.js, utilisez npm pour ajouter le package openai. Les deux bibliothèques prennent en charge les fonctionnalités de streaming et d'appel de fonctions décrites plus loin dans ce guide. Assurez-vous que votre version du SDK est suffisamment récente pour prendre en charge les Server-Sent Events (SSE) pour le streaming de tokens en temps réel. Si vous utilisez un client HTTP personnalisé au lieu d'un SDK, vous devez gérer manuellement le chargement JSON et l'analyse du flux SSE conformément à la spécification de l'API OpenAI.

Authentification

Toute requête à l'API doit inclure votre clé API dans l'en-tête Authorization. Utilisez le format Bearer YOUR_API_KEY. L'URL de base pour toutes les requêtes est https://api.characteraiapi.com/v1. Lors de l'utilisation d'un SDK, définissez la configuration base_url sur cette valeur et fournissez votre clé via le paramètre api_key. Si vous perdez votre clé ou soupçonnez une fuite, vous pouvez la régénérer depuis le tableau de bord ; l'ancienne clé sera immédiatement révoquée. Une seule clé active est autorisée par compte. Assurez-vous d'utiliser la bonne URL de base, car les requêtes vers l'endpoint OpenAI standard échoueront avec une erreur 404 ou 401.

Complétion de chat basique

La fonctionnalité principale est servie via l'endpoint /v1/chat/completions. Envoyez une requête POST avec un nom de modèle uncensored et votre historique de messages. Le modèle répond par une sortie textuelle sans appliquer les filtres de contenu habituels pour le contenu adulte licite. Voici un exemple curl illustrant une requête simple de complétion de texte.

Copycurl https://api.characteraiapi.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."}]
  }'

Cette requête renvoie un objet de complétion contenant le texte généré. Vous pouvez ajuster des paramètres comme temperature pour contrôler l'aléatoire ou max_tokens pour limiter la longueur de la sortie. Le modèle prend en charge une fenêtre de contexte de 100 000 tokens, permettant de traiter un historique de conversation substantiel ou de longs documents en une seule requête.

Réponses en streaming

Pour une meilleure expérience utilisateur, activez le streaming en définissant stream: true dans votre requête. L'API renvoie des événements envoyés par le serveur (SSE) contenant des fragments de tokens au fur et à mesure de leur génération. Cela réduit la latence perçue pour les applications de chatbot. Utilisez le paramètre stream_options si vous souhaitez recevoir les statistiques d'utilisation finales dans le dernier événement. Le streaming est particulièrement utile pour le jeu de rôle en temps réel, où l'affichage du texte mot par mot améliore l'immersion. Assurez-vous que votre code client gère correctement le format SSE pour analyser chaque fragment séquentiellement.

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)

Limites de débit et erreurs

L'API impose une limite de 300 requêtes par minute par clé. Si vous dépassez cette limite, vous recevrez une erreur 429 Too Many Requests. Les corps de requête sont limités à 8 Mo. Les erreurs courantes incluent le 401 pour une clé invalide ou manquante, et le 402 si votre crédit prépayé est épuisé. Vous pouvez recharger à partir de 10 $ en utilisant des cryptomonnaies (USDT ou USDC), avec des crédits bonus disponibles pour les dépôts plus importants. Contrairement à certains fournisseurs, il n'y a pas de frais cachés ni de verrouillage d'abonnement ; vous ne payez que pour les tokens que vous consommez. La tarification est transparente : 0,25 $ par 1 M de tokens d'entrée et 1,00 $ par 1 M de tokens de sortie. Assurez-vous que votre logique de gestion des erreurs réessaie en cas d'erreur 429 avec une reprise exponentielle.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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