Démarrage Rapide d'Intégration API Character

Installez le SDK

Commencez par installer la bibliothèque cliente officielle pour votre langage. Cela garantit la compatibilité avec le point de terminaison compatible OpenAI que nous fournissons. La bibliothèque gère la sérialisation et la logique de nouvelle tentative pour vous.

Pour Python, utilisez pip. Pour Node.js, utilisez npm. Cette étape prend quelques secondes et configure l'environnement pour les exemples de code qui suivent.

Configurer votre URL de base

Pointez votre client SDK vers notre point de terminaison pour accéder au modèle sans censure. L'URL de base est HTTPS://api.apicharacter.com/v1. Cela remplace l'URL OpenAI par défaut dans votre configuration.

Sans ce changement, les requêtes échoueront ou toucheront le mauvais service. Vous n'avez besoin de définir cela qu'une seule fois lors de l'initialisation de votre instance client.

Définir votre clé API

Injectez votre clé dans la variable d'environnement ou la configuration du client. L'authentification est requise pour chaque requête afin de suivre l'utilisation de votre crédit prépayé. Votre clé donne accès au point de terminaison LLM non censuré.

Conservez cette valeur en sécurité. Elle agit comme votre unique identifiant pour le compte. Aucun numéro de téléphone ni vérification supplémentaire n'est nécessaire pour un accès de base.

Effectuer votre première requête

Envoyez une simple complétion de chat pour vérifier la connectivité. L'ID du modèle est "uncensored". Cela confirme que votre authentification et l'URL de base sont correctes avant de construire votre application.

Voir l'exemple ci-dessous pour une requête cURL standard.

Copycurl https://api.apicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "set my name to Alex"}]
  }'

Gérer les réponses en streaming

Activez le streaming pour une latence plus faible dans vos interfaces de chat. Définissez le paramètre stream sur true dans votre demande. Le SDK restituera les tokens à mesure de leur génération.

C'est critique pour les expériences utilisateur réactives. Vous gérez les fragments partiels à mesure qu'ils arrivent via les Server-Sent Events.

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, Erreurs et Contexte

Comprendre vos contraintes pour éviter les interruptions de service. Vous bénéficiez d'une fenêtre de contexte de 100 000 tokens. La sortie maximale est de 16 000 tokens sauf indication contraire.

La limite de taux est de 300 requêtes par minute. Une erreur 401 signifie une clé invalide. Une erreur 402 signifie un solde nul. Une erreur 429 signifie que vous avez atteint la limite de taux. Gardez cela à l’esprit pour la mise à l’échelle en production.

Python

Copyfrom openai import OpenAI

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