FR ▾
Obtenir une clé API

Clé API Character AI : Comment l’obtenir et l’utiliser

Si vous avez recherché une clé API Character AI, la première chose à savoir est que ce site n’est pas Character.ai et ne délivre pas ses clés. Il vous fournit une clé pour une API textuelle indépendante compatible OpenAI, prête à l’emploi comme backend pour les applications de chat de personnages.

Une clé brillante au-dessus des panneaux de chat connectés à un cube serveur, illustrant l’accès par clé API

Points clés

  1. Vous obtenez une clé après vous être inscrit avec Google ou par e-mail et mot de passe, puis en ouvrant la page de clé API.
  2. Les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d’essai en un clic, sans carte, valable 7 jours.
  3. Utilisez l’URL de base https://api.characteraiapi.com/v1 et l’ID de modèle uncensored avec n’importe quel SDK OpenAI.
  4. Conservez la clé sur un serveur ou dans une variable d’environnement, jamais dans le code front-end public.

Ce que vous obtenez réellement

Character.ai est un produit de chat grand public. Les personnes qui recherchent une clé API Character AI veulent généralement l’une des deux choses suivantes : un moyen d’appeler un chatbot de personnage depuis leur propre code, ou un backend pour une application de persona qui n’est pas limité par les règles d’un produit hébergé. Ce site couvre le second besoin. Vous vous inscrivez, recevez une clé et envoyez des requêtes à un endpoint compatible OpenAI. Rien ici ne se connecte à Character.ai ni ne réutilise ses personnages.

Le service est une API textuelle hébergée devant un seul modèle à poids ouverts, géré par un fournisseur indépendant et ajusté pour répondre sans refus de contenu pour une utilisation adulte légale. Ce n’est pas l’API officielle d’aucun fournisseur de modèle et ce n’est pas un routeur entre fournisseurs. L’ID de modèle est uncensored, et l’URL de base est https://api.characteraiapi.com/v1. Deux méthodes existent : POST /v1/chat/completions et GET /v1/models.

Comme l’interface correspond à celle d’OpenAI, le travail de création d’un personnage est de votre côté. Vous écrivez le persona comme un message système, conservez l’historique de la conversation et l’envoyez avec chaque requête. Cela vous donne le contrôle sur la voix, la mémoire et le rythme qu’un produit fermé expose rarement. La limite stricte est la même pour tous les utilisateurs : aucun contenu sexuel impliquant des mineurs, jamais.

Obtenez votre clé en cinq étapes

Le parcours entier prend quelques minutes. Vous n’avez pas besoin d’une carte pour commencer.

  1. Inscrivez-vous. Utilisez Google, ou enregistrez-vous avec un e-mail et un mot de passe.
  2. Ouvrez la page de clé. Allez sur la page de clé API, où la clé de votre compte est affichée.
  3. Réclamez l’essai. Un clic sur cette page ajoute 0,50 $ de crédit d’essai. Il est limité à un par personne et est valable 7 jours.
  4. Copiez la clé. Stockez-la dans un gestionnaire de mots de passe ou un fichier de secrets dès maintenant.
  5. Envoyez une requête de test. Utilisez la commande curl ci-dessous avant de toucher à tout code d’application.

Traitez la clé comme un mot de passe. Quiconque la possède peut dépenser votre solde. Si vous pensez qu’elle a fui, cessez de l’utiliser immédiatement, retirez-la de toutes les applications et vérifiez votre solde pour des dépenses inattendues.

Testez la clé avec curl

Définissez la clé comme variable d’environnement afin qu’elle n’apparaisse jamais en clair dans l’historique de votre shell ni dans un script. Puis listez les modèles. Cela confirme que la clé fonctionne et que vous atteignez le bon hôte.

export API_KEY="paste-your-key-here"

curl https://api.characteraiapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Vous devriez obtenir une liste JSON incluant uncensored. Envoyez ensuite une première requête de chat avec un petit persona. Le message système définit le personnage, le message utilisateur lance la scène.

curl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
      {"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
    ],
    "temperature": 0.9
  }'

La réponse suit la forme standard des complétions de chat. Le texte de la réponse se trouve dans choices[0].message.content. Les en-têtes de réponse contiennent également X-Request-Id, X-Balance-USD et les en-têtes de limite de débit, ce qui est pratique lorsque vous souhaitez afficher un solde restant dans votre propre interface utilisateur.

Utilisez la clé depuis Python ou Node

Tout SDK OpenAI fonctionne une fois que vous modifiez deux valeurs : l’URL de base et la clé. Voici la version Python avec le package officiel openai.

import os
from openai import OpenAI

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

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
        {"role": "user", "content": "Status report?"},
    ],
)
print(reply.choices[0].message.content)

Et la même requête en Node :

import OpenAI from "openai";

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

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are Mara, a ship engineer. Stay in character." },
    { role: "user", content: "Status report?" },
  ],
});
console.log(reply.choices[0].message.content);

De nombreuses interfaces de chat ont un champ pour un endpoint compatible OpenAI personnalisé. Dans ces outils, collez l’URL de base, collez la clé, et saisissez uncensored comme nom de modèle. Rien d’autre ne doit changer. La page docs liste les paramètres pris en charge, y compris le streaming, l’appel de fonctions et le mode JSON.

Problèmes courants de clé et solutions rapides

La plupart des échecs des débutants proviennent d’une poignée de petites erreurs. Vérifiez-les dans cet ordre avant de soupçonner quelque chose de plus grave.

  • Espaces blancs ou guillemets supplémentaires dans la clé. Une nouvelle ligne finale copiée depuis un fichier suffit à faire échouer l’authentification. Imprimez la longueur de la variable et comparez-la avec ce que vous avez copié.
  • Mauvaise URL de base. L’URL de base se termine par /v1, et le SDK ajoute lui-même /chat/completions. Si vous ajoutez également /chat/completions à l’URL de base, le chemin double et la requête échoue.
  • Mauvais nom de modèle. L’ID de modèle est uncensored. Les noms empruntés à d’autres services ne correspondront pas. Appelez GET /v1/models pour voir ce que le serveur rapporte.
  • En-tête manquant. Les appels HTTP bruts nécessitent Authorization: Bearer suivi d’un espace et de la clé, plus Content-Type: application/json sur les requêtes POST.
  • Solde vide. L’en-tête de réponse X-Balance-USD indique ce qu’il reste. Lorsque le crédit d’essai est épuisé ou que sa période de validité de 7 jours est écoulée, rechargez ou les requêtes cesseront de réussir.
  • Limites de débit. Une clé d'essai permet 2 requêtes simultanées et 60 par minute. Deux flux ouverts utilisent déjà les deux emplacements.

Une clé invalide produit généralement une erreur d’authentification plutôt qu’une réponse de modèle. Une limite produit un code HTTP 429 avec le code rate_limited ou concurrency. Lire le corps de l’erreur, et pas seulement le code de statut, fait gagner du temps car le code vous indique quelle limite vous avez atteinte. Chaque réponse contient un X-Request-Id ; conservez-le dans vos journaux afin de pouvoir associer un appel échoué à une requête spécifique plus tard.

Limites de l’essai et ce que l’essai permet

Une clé d’essai a des limites inférieures à une clé complète : 2 requêtes simultanées et 60 requêtes par minute. Une clé complète permet 8 requêtes simultanées et 300 requêtes par minute. Pour tester un seul persona, c’est largement suffisant. Si vous exécutez plusieurs chats à la fois depuis un script de test, vous verrez un code HTTP 429 avec le code d’erreur concurrency ou rate_limited. Une requête en streaming occupe son emplacement de concurrence jusqu’à la fin du flux, donc deux flux ouverts sur une clé d’essai le remplissent.

Jusqu’où vont 0,50 $ ? Les prix sont de 0,15 $ par 1M de tokens d’entrée et 0,50 $ par 1M de tokens de sortie. Prenez un tour de chat typique avec 1 500 tokens d’historique et de persona entrants et 300 tokens sortants :

  • Entrée : 1 500 tokens x 0,15 $ / 1 000 000 = 0,000225 $
  • Sortie : 300 tokens x 0,50 $ / 1 000 000 = 0,00015 $
  • Un tour : 0,000375 $
  • 0,50 $ / 0,000375 $ représente environ 1 333 tours

Cela suffit pour tester plusieurs personnages correctement. Les requêtes échouées ou refusées ne sont pas facturées, donc une requête qui génère une erreur ne consomme pas votre crédit. L’essai expire après 7 jours ; le crédit que vous achetez plus tard n’expire jamais.

Paramètres pour donner à un personnage une cohérence naturelle

Une clé vous donne la connexion ; la qualité d’un personnage vient du prompt et des paramètres d’échantillonnage. Quelques bonnes habitudes aident plus que des astuces ingénieuses.

Rédigez le message système sous forme de fiche courte en phrases simples : qui est le personnage, comment il parle, ce qu’il veut et la longueur de ses réponses. Donnez une ou deux lignes d’exemple si la voix est importante. Les modèles suivent mieux des exemples concrets que des adjectifs, donc une ligne comme « Mara répond par des phrases courtes et sèches, et plaisante quand elle est nerveuse » fonctionne mieux que « Mara est spirituelle et charmante ».

Utilisez temperature pour régler le niveau de vivacité. Des valeurs proches de 0,9 donnent des formulations plus variées, tandis que des valeurs proches de 0,5 stabilisent davantage le personnage. Ajoutez une séquence stop si votre application utilise une étiquette de locuteur comme « Utilisateur : » et que vous voulez empêcher le modèle de générer le côté opposé de la conversation. Les pénalités de fréquence et de présence peuvent réduire les répétitions dans les longues conversations, mais augmentez-les avec précaution, car des valeurs élevées peuvent rendre les dialogues étranges.

N’oubliez pas que le modèle ne connaît que ce qui est dans la requête. Si le personnage doit se souvenir du nom du joueur depuis 200 messages, conservez ce message dans la fenêtre de contexte ou stockez les faits clés dans le message système. C’est pourquoi une liste de mémoire que vous mettez à jour vous-même vaut souvent mieux que l’envoi d’un historique énorme.

Recharger lorsque le crédit d’essai est épuisé

Il n’y a pas d’abonnement. Vous prépayez et payez à l’usage. Les recharges prennent n’importe quel montant entier de 20 $ à 500 $, et les montants plus élevés bénéficient d’un bonus : +5 % à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $. Ainsi, 50 $ deviennent 52,50 $ de crédit, 100 $ deviennent 110 $, et 200 $ deviennent 230 $. Vous pouvez payer avec de la crypto (USDT sur TRC20, USDC sur Base).

La page tarifs contient le tableau complet. Pour planifier, un tour de 1 500 tokens en entrée et 300 tokens en sortie coûte 0,000375 $, donc 20 $ couvrent environ 53 000 tours de ce type. Le jeu de rôle long coûte plus cher par tour car l’historique s’allonge, donc limitez la quantité d’historique que vous renvoyez. La fenêtre de contexte est de 100 000 tokens, prompt plus complétion, mais vous aurez rarement besoin de la remplir.

Garder la clé en sécurité dans une application réelle

L’erreur la plus courante avec un projet de chat est d’appeler l’API directement depuis le code du navigateur. Tout ce qui est livré au navigateur peut être lu par chaque visiteur, y compris la clé. Placez un petit serveur entre votre interface et l’API. Le navigateur parle à votre route, votre route ajoute l’en-tête Authorization: Bearer et transmet la requête.

  • Stockez la clé dans une variable d’environnement ou un gestionnaire de secrets, pas dans le dépôt.
  • Ajoutez une entrée .env à .gitignore avant votre premier commit.
  • Utilisez une clé par environnement pour qu’une fuite en développement n’affecte pas la production.
  • Surveillez l’en-tête X-Balance-USD pour détecter tôt les boucles incontrôlées.
  • Réessayez sur HTTP 429 avec un court délai d’attente. Une réponse de surcharge temporaire inclut Retry-After: 5.

Les prompts envoyés à l’API ne sont pas utilisés pour l’entraînement. Même ainsi, évitez d’envoyer des données que vous ne voudriez pas voir stockées dans un journal de votre côté. Si vous souhaitez une analyse plus approfondie de ce qu’une telle API fait et ne fait pas, l’article mythes et faits couvre les idées reçues courantes.

Questions et réponses

Cela me donne-t-il une clé API Character.ai ?

Non. Il s’agit d’un service séparé et indépendant. Vous obtenez une clé pour un endpoint compatible OpenAI avec l’ID de modèle uncensored, que vous pouvez utiliser comme backend pour vos propres applications de personnages.

Ai-je besoin d’une carte pour obtenir une clé ?

Non. Vous vous inscrivez avec Google ou email et mot de passe, puis réclamez 0,50 $ de crédit d’essai en un clic sur la page clé API. L’essai est valable 7 jours.

Puis-je utiliser la clé dans SillyTavern ou d’autres interfaces de chat ?

Les outils qui acceptent un endpoint compatible OpenAI personnalisé peuvent l’utiliser. Entrez l’URL de base, votre clé et le nom du modèle uncensored.

Que se passe-t-il lorsque j’atteins une limite de débit ?

L’API retourne HTTP 429 avec le code rate_limited ou concurrency. Attendez un moment et réessayez. Une clé d’essai permet 2 requêtes simultanées et 60 par minute.

Le crédit expire-t-il ?

Le crédit acheté n’expire jamais. Seul le crédit d’essai de 0,50 $ a une période de validité de 7 jours.

Votre clé n'est qu'à un formulaire d'ici

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

Obtenir une clé API