Documentation
Guides / Démarrage rapide
Guides · Démarrage rapide

Démarrage rapide

Commencez à utiliser AllToken.

Introduction

AllToken fournit une API unifiée vous permettant d'accéder à des centaines de modèles d'IA via une interface unique, tout en gérant automatiquement le basculement et en sélectionnant l'option la plus rentable.

En quelques lignes de code, vous pouvez commencer à effectuer des appels avec votre SDK ou votre framework préféré.

Base URL : https://api.alltoken.ai/v1

Authentification : Bearer API Key

Compatibilité : API compatible OpenAI

Obtenir une API Key

Avant de commencer, créez une API Key :

  1. Rendez-vous dans Paramètres → Clés API
  2. Cliquez sur Créer une nouvelle clé
  3. Copiez et conservez la clé en lieu sûr — elle ne sera affichée qu'une seule fois

Gardez votre API Key confidentielle. Ne l'exposez pas dans du code côté client ni dans des dépôts publics.

Installer comme skill d'agent

Si votre stack sait déjà parler à AllToken, vous pouvez éviter d’écrire du code d’intégration. AllToken fournit deux skills officiels pour les runtimes d’agent qui chargent des fichiers SKILL.md : installez-les en une commande et votre agent connaît toute la surface API AllToken.

SkillCe qu’il fait
alltokenCrée un projet AllToken complet en TypeScript ou Python : chat, image asynchrone, vidéo asynchrone, streaming, noyau d’agent avec tool calling et TUI Ink optionnelle.
alltoken-callSix commandes slash-style reconnues par l’agent dans le chat : /alltoken-chat, /alltoken-image, /alltoken-video, /alltoken-search, /alltoken-models, /alltoken-cost. Recettes Python stdlib, sans pip install.

Les deux sont publiés sous MIT. Source : github.com/alltoken-ai/alltoken-skills.

Installer dans votre runtime

OpenClaw (via le CLI ClawHub) :

OpenClaw
$clawhub skill install alltoken
clawhub skill install alltoken-call

Hermes Agent (installation par URL directe) :

Hermes Agent
$hermes skills install https://alltoken.ai/skills/alltoken/SKILL.md
hermes skills install https://alltoken.ai/skills/alltoken-call/SKILL.md

Claude Code / Codex CLI / OpenCode - placez le fichier SKILL.md dans le dossier skills/ de votre projet :

Claude Code / Codex CLI / OpenCode
$mkdir -p ./skills/alltoken-call
curl -fsSL https://alltoken.ai/skills/alltoken-call/SKILL.md -o ./skills/alltoken-call/SKILL.md

Votre agent chargera le skill à la prochaine session.

Essayer

Vérifiez que ALLTOKEN_API_KEY est défini dans l’environnement où tourne votre agent. Demandez ensuite en langage naturel :

  • "Utilise le skill alltoken-call pour générer une image 1024x1024 d’une théière."
  • "Utilise alltoken pour créer un projet de chat AllToken dans ./my-agent."
  • "Exécute /alltoken-models --type=video pour afficher les modèles vidéo disponibles."

Vous utilisez SillyTavern pour le roleplay ? Consultez le guide dédié : Use AllToken with SillyTavern.

Vous préférez écrire votre propre intégration ? Continuez avec Installer le SDK ci-dessous pour les chemins TypeScript / Python.

Installer le SDK

AllToken est entièrement compatible avec le SDK OpenAI. Installez-le avec votre gestionnaire de paquets préféré :

npm
$npm install openai

Puis définissez la variable d'environnement :

Shell
$export ALLTOKEN_API_KEY="your_alltoken_api_key"

Envoyer votre première requête

Créez un client, choisissez un modèle et envoyez une requête de chat :

TypeScript
1import OpenAI from 'openai';
2
3const client = new OpenAI({
4 apiKey: process.env.ALLTOKEN_API_KEY,
5 baseURL: 'https://api.alltoken.ai/v1',
6});
7
8const completion = await client.chat.completions.create({
9 model: 'minimax-m2.7',
10 messages: [
11 {
12 role: 'user',
13 content: 'Quel est le sens de la vie ?',
14 },
15 ],
16});
17
18console.log(completion.choices[0]?.message?.content);

Exemple Python

Python
1from openai import OpenAI
2import os
3
4client = OpenAI(
5 api_key=os.environ.get("ALLTOKEN_API_KEY"),
6 base_url="https://api.alltoken.ai/v1",
7)
8
9completion = client.chat.completions.create(
10 model="minimax-m2.7",
11 messages=[
12 {"role": "user", "content": "Quel est le sens de la vie ?"}
13 ],
14)
15
16print(completion.choices[0].message.content)

Appel direct à l'API

Vous pouvez également appeler l'API directement avec cURL ou tout autre client HTTP :

cURL
1curl https://api.alltoken.ai/v1/chat/completions \
2 -H "Authorization: Bearer $ALLTOKEN_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "model": "minimax-m2.7",
6 "messages": [
7 {"role": "user", "content": "Bonjour !"}
8 ]
9 }'

Réponses en streaming

Ajoutez stream: true pour recevoir les tokens au fur et à mesure via Server-Sent Events :

TypeScript
1const stream = await client.chat.completions.create({
2 model: 'minimax-m2.7',
3 messages: [{ role: 'user', content: 'Raconte-moi une histoire' }],
4 stream: true,
5});
6
7for await (const chunk of stream) {
8 const content = chunk.choices[0]?.delta?.content;
9 if (content) process.stdout.write(content);
10}

Consultez la documentation Streaming pour plus de détails.

Prochaines étapes