Documentation
Guides / Schnellstart
Guides · Schnellstart

Schnellstart

Erste Schritte mit AllToken.

Einführung

AllToken bietet eine einheitliche API, mit der Sie über eine einzige Schnittstelle auf Hunderte von KI-Modellen zugreifen können – mit automatischem Failover und Auswahl der kostengünstigsten Option.

Mit wenigen Zeilen Code können Sie sofort mit Ihrem bevorzugten SDK oder Framework loslegen.

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

Authentifizierung: Bearer API Key

Kompatibilität: OpenAI-kompatible API

API Key erstellen

Erstellen Sie zunächst einen API Key:

  1. Öffnen Sie Einstellungen → API Key
  2. Klicken Sie auf Neuen Schlüssel erstellen
  3. Kopieren Sie den Schlüssel und bewahren Sie ihn sicher auf – er wird nur einmal angezeigt

Schützen Sie Ihren API Key sorgfältig. Geben Sie ihn niemals in Client-seitigem Code oder öffentlichen Repositories preis.

Als Agent-Skill installieren

Wenn dein Stack bereits AllToken spricht, kannst du Integrationscode überspringen. AllToken liefert zwei offizielle Skills für Agent-Runtimes, die SKILL.md-Dateien laden: einmal installieren, und dein Agent kennt die gesamte AllToken API-Oberfläche.

SkillWas er macht
alltokenErstellt ein vollständiges TypeScript- oder Python-AllToken-Projekt: Chat, asynchrone Bilder, asynchrone Videos, Streaming, Tool-calling Agent Core und optionales Ink TUI.
alltoken-callSechs slash-style Befehle, die der Agent im Chat erkennt: /alltoken-chat, /alltoken-image, /alltoken-video, /alltoken-search, /alltoken-models, /alltoken-cost. Stdlib Python recipes, kein pip install.

Beide werden unter MIT veröffentlicht. Quelle: github.com/alltoken-ai/alltoken-skills.

In deiner Runtime installieren

OpenClaw (über die ClawHub CLI):

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

Hermes Agent (direkte URL-Installation):

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 - lege die SKILL.md-Datei im skills/-Verzeichnis deines Projekts ab:

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

Dein Agent lädt den Skill in der nächsten session.

Ausprobieren

Stelle sicher, dass ALLTOKEN_API_KEY in der Umgebung gesetzt ist, in der dein Agent läuft. Frage dann in natürlicher Sprache:

  • "Verwende den alltoken-call skill, um ein 1024x1024-Bild einer Teekanne zu erzeugen."
  • "Verwende alltoken, um ein AllToken chat Projekt in ./my-agent zu erstellen."
  • "Führe /alltoken-models --type=video aus, um verfügbare Videomodelle anzuzeigen."

Verwendest du SillyTavern für roleplay? Sieh dir den speziellen Guide an: Use AllToken with SillyTavern.

Möchtest du lieber eine eigene Integration schreiben? Fahre unten mit SDK installieren fort, um die TypeScript / Python Wege zu nutzen.

SDK installieren

AllToken ist vollständig kompatibel mit dem OpenAI SDK. Installieren Sie es mit Ihrem bevorzugten Paketmanager:

npm
$npm install openai

Setzen Sie anschließend die Umgebungsvariable:

Shell
$export ALLTOKEN_API_KEY="your_alltoken_api_key"

Erste Anfrage senden

Erstellen Sie einen Client, wählen Sie ein Modell und senden Sie eine Chat-Anfrage:

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: 'Was ist der Sinn des Lebens?',
14 },
15 ],
16});
17
18console.log(completion.choices[0]?.message?.content);

Python-Beispiel

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": "Was ist der Sinn des Lebens?"}
13 ],
14)
15
16print(completion.choices[0].message.content)

API direkt aufrufen

Sie können die API auch direkt mit cURL oder einem beliebigen HTTP-Client aufrufen:

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": "Hallo!"}
8 ]
9 }'

Streaming

Fügen Sie stream: true hinzu, um Antworten token-weise über Server-Sent Events zu empfangen:

TypeScript
1const stream = await client.chat.completions.create({
2 model: 'minimax-m2.7',
3 messages: [{ role: 'user', content: 'Erzähl mir eine Geschichte' }],
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}

Ausführliche Dokumentation finden Sie unter Streaming.

Nächste Schritte