✨ TokenLab API-Integrations-Skill

Diese Seite dokumentiert den gepflegten gemeinsamen tokenlab-api-integration Skill. Die kanonische Distribution liegt in hedging8563/tokenlab-skills; das öffentliche Repository enthält bewusst nur diesen Skill.

Diese Seite ist für Skill-Installation und Agent-Workflow gedacht. Für endpoint-spezifische Einrichtung nutzen Sie die dedizierte SDK-, Client- oder API-Referenzseite.

Was der Skill leistet

Erstellt minimal lauffähige Beispiele für TokenLab Chat, Bilder, Audio, Video, Übersetzung und weitere API-Familien.
Nutzt https://api.tokenlab.sh/v1 für OpenAI-kompatible Clients und erklärt den Wechsel zu nativen Anthropic- oder Gemini-Routen.
Entdeckt Modelle über /v1/models, /llms.txt und recommended_for-Auswahllisten statt über veraltete Listen.
Liest vor dem erneuten Versuch von Nicht-Chat-Anfragen den öffentlichen Modelldetails, damit nicht unterstützte Felder nicht still entfernt werden.
Verarbeitet Agent-First-Hinweise wie did_you_mean, suggestions, retry_after und recommended_request.

Installation

Verwenden Sie den kanonischen nicht interaktiven Installationsbefehl:

npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

Damit wird der gemeinsame tokenlab-api-integration Skill aus dem TokenLab skills Repository installiert.Wenn Ihr Tool den Installer nicht unterstützt, kopieren Sie skills/tokenlab-api-integration/ aus dem Repository in das gemeinsame skills- oder rules-Verzeichnis des Tools.

Bestehende Installationen aktualisieren

Wenn Sie den Skill vor der Bereinigung des TokenLab Repository installiert haben, führen Sie denselben Befehl erneut aus. Das aktuelle öffentliche Paket ist kleiner und hängt nicht mehr von generierten lokalen Suchskripten ab.

Installation prüfen

Fragen Sie Ihren coding agent:

Welche skills sind verfügbar?

Wenn tokenlab-api-integration erscheint, war die Installation erfolgreich.

API Key abrufen

TokenLab besuchen

Öffnen Sie tokenlab.sh

Anmelden

Erstellen Sie ein Konto oder melden Sie sich an

API Key abrufen

Öffnen Sie Dashboard → API Keys und erstellen Sie einen neuen key

key kopieren

Ihr key beginnt mit sk-.... Bewahren Sie ihn sicher auf.

Fügen Sie API keys nicht in Prompts oder Quelldateien ein. Der Skill sollte nach der zu verwendenden Umgebungsvariable fragen und Code erzeugen, der den key daraus liest.

Empfohlener Agent-Workflow

Beginnen Sie mit dem kleinsten lauffähigen Beispiel passend zur gewünschten Sprache und API-Familie.
Wenn die Modellwahl offen ist, rufen Sie vor dem Hardcoding /v1/models oder https://api.tokenlab.sh/llms.txt auf.
Für Nicht-Chat-Aufgaben rufen Sie /v1/models?recommended_for=<scene> auf; <scene> ist image, video, music, 3d, tts, stt, embedding, rerank oder translation.
Vor Änderungen an einer fehlgeschlagenen Nicht-Chat-Anfrage lesen Sie /v1/models/:model und gleichen supported_operations, supported_parameters, request_endpoint, request_endpoint_by_operation, request_shape_mode und recommended_request ab.
Bei Agent-First-Fehlern nutzen Sie strukturierte Felder zur Korrektur und wiederholen nur, wenn der Fehler retryable ist.

Minimales Chat-Beispiel

Dieses Beispiel verwendet das OpenAI Python SDK mit der TokenLab base URL:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

Ausführen mit:

pip install openai
export TOKENLAB_API_KEY="sk-your-api-key"
python app.py

Modellerkennung und öffentliche Verträge

Bevorzugen Sie Live-Erkennung statt veralteter gebündelter Listen:

# Maschinenlesbare API-Übersicht
curl https://api.tokenlab.sh/llms.txt

# Modelle auflisten
curl "https://api.tokenlab.sh/v1/models" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?category=image" -H "Authorization: Bearer sk-KEY"

# Sortierte Nicht-Chat-Auswahllisten
curl "https://api.tokenlab.sh/v1/models?recommended_for=image" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" -H "Authorization: Bearer sk-KEY"

# Vor dem erneuten Versuch einer Nicht-Chat-Anfrage den Modelldetails eines Modells lesen
curl "https://api.tokenlab.sh/v1/models/gpt-image-2" -H "Authorization: Bearer sk-KEY"

# Nur Preisdetails
curl "https://api.tokenlab.sh/v1/models/gpt-image-2/pricing" -H "Authorization: Bearer sk-KEY"

Auswahl des nativen Protokolls

Der OpenAI-kompatible Pfad /v1 ist der Standard für gängige Chat-, Bild-, Embedding-, Audio- und Rerank-Beispiele. Leiten Sie die Verfügbarkeit eines nativen Protokolls weder aus dem Modell- oder Anbieternamen noch aus Chat-Antwort-Headern ab. Lesen Sie GET /v1/models/{model} und verwenden Sie nur ein in den Modelldetails ausgewiesenes Anfrageformat. Das maßgebliche Feld ist tokenlab.accepted_request_formats. Die Protokoll-Endpoints sind /v1/chat/completions für Chat Completions, /v1/responses für Responses, /v1/messages für Messages und /v1beta/models/{model}:generateContent für Gemini.

Agent-First Fehlerbehebung

Fehler enthalten Felder, die coding agents ohne Auslesen der Dokumentation parsen können:

Fehler	Nützliche Felder	Agent-Aktion
Falscher Modellname	`did_you_mean`, `suggestions`, `hint`	Mit korrigiertem Modell oder einer vorgeschlagenen Alternative erneut versuchen
Unzureichendes Guthaben	`balance_usd`, `estimated_cost_usd`, `suggestions`	Bestätigung einholen oder auf ein günstigeres Modell wechseln
Rate Limit oder vorübergehende Nichtverfügbarkeit	`retryable`, `retry_after`, `alternatives`	Warten, erneut versuchen oder eine gelistete Alternative wählen
Inkompatible Nicht-Chat-Anfrage	`supported_operations`, `supported_parameters`, `request_endpoint`, `request_endpoint_by_operation`, `request_shape_mode`, `recommended_request`	Anfrage anhand der Modelldetails neu aufbauen und bei Feldern, die die Absicht ändern, einen klaren Fehler zurückgeben

Unterstützte API-Familien

Familie	Primärer Pfad
Chat und Responses	`/v1/chat/completions`, `/v1/responses`
Claude-native Nachrichten	`/v1/messages`
Gemini-native Anfragen	`/v1beta/models/{model}:generateContent`
Bilder	`/v1/images/generations`, `/v1/images/edits`
Video	`/v1/videos/generations`
Musik	`/v1/music/generations`
Worlds	`/v1/worlds/generations` plus world-Status und Medien-Asset-Endpunkte
3D	`/v1/3d/generations`
Audio	`/v1/audio/speech`, `/v1/audio/transcriptions`, `/v1/audio/translations`
Realtime	`/v1/realtime?model={model}`
Embeddings und Rerank	`/v1/embeddings`, `/v1/rerank`
Textübersetzung	`/v1/translations`

Bewährte Vorgehensweisen

API-Key-Sicherheit

Nutzen Sie Umgebungsvariablen und serverseitige Aufrufe. Geben Sie keys nie im Frontend-Code preis.

Vertrag zuerst für Nicht-Chat

Lesen Sie /v1/models?recommended_for=... und /v1/models/:model, bevor Sie Bild-, Video-, Musik-, 3D-, Übersetzungs-, Audio-, Embedding- oder Rerank-Anfragen erneut versuchen.

Kleinstes lauffähiges Beispiel

Erzeugen Sie zuerst einen funktionierenden Aufruf, bevor Sie Abstraktionen, Queues oder UI-Flows hinzufügen.

Strukturierte Hinweise nutzen

Parsen Sie did_you_mean, retry_after, alternatives und recommended_request, bevor Sie Code ändern.

FAQ

Skill wird nicht automatisch ausgelöst?

Erwähnen Sie “TokenLab” oder “TokenLab API” in der Anfrage, zum Beispiel: Nutze TokenLab, um Bildgenerierung in meine Node.js-App einzubauen.

Welche coding agents werden unterstützt?

Jeder coding agent mit gemeinsamem skill- oder rules-Verzeichnis kann den Ordner verwenden. Der skills Installer behandelt unterstützte agents automatisch.

Wie aktualisiere ich den Skill?

Führen Sie den Installationsbefehl erneut aus. Dadurch wird die lokale Kopie aus dem kanonischen öffentlichen Repository aktualisiert.

npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

Ressourcen

Agent-First API

Strukturierte Fehlerhinweise und Wiederherstellungsverhalten

API-Dokumentation

Endpoint-spezifische Einrichtung und API Reference

Modelle

Verfügbare Modelle durchsuchen

llms.txt

Maschinenlesbare API-Übersicht für agents

Fragen? Nutzen Sie GitHub Issues oder kontaktieren Sie support@tokenlab.sh.

Erste Schritte

Kernleitfäden

Medienleitfäden

✨ TokenLab API-Integrations-Skill

Was der Skill leistet

Installation

Bestehende Installationen aktualisieren

Installation prüfen

API Key abrufen

Empfohlener Agent-Workflow

Minimales Chat-Beispiel

Modellerkennung und öffentliche Verträge

Auswahl des nativen Protokolls

Agent-First Fehlerbehebung

Unterstützte API-Familien

Bewährte Vorgehensweisen

API-Key-Sicherheit

Vertrag zuerst für Nicht-Chat

Kleinstes lauffähiges Beispiel

Strukturierte Hinweise nutzen

FAQ

Ressourcen

Agent-First API

API-Dokumentation

Modelle

llms.txt

​Was der Skill leistet

​Installation

​Bestehende Installationen aktualisieren

​Installation prüfen

​API Key abrufen

​Empfohlener Agent-Workflow

​Minimales Chat-Beispiel

​Modellerkennung und öffentliche Verträge

​Auswahl des nativen Protokolls

​Agent-First Fehlerbehebung

​Unterstützte API-Familien

​Bewährte Vorgehensweisen

API-Key-Sicherheit

Vertrag zuerst für Nicht-Chat

Kleinstes lauffähiges Beispiel

Strukturierte Hinweise nutzen

​FAQ

​Ressourcen

Agent-First API

API-Dokumentation

Modelle

llms.txt

Was der Skill leistet

Installation

Bestehende Installationen aktualisieren

Installation prüfen

API Key abrufen

Empfohlener Agent-Workflow

Minimales Chat-Beispiel

Modellerkennung und öffentliche Verträge

Auswahl des nativen Protokolls

Agent-First Fehlerbehebung

Unterstützte API-Familien

Bewährte Vorgehensweisen

FAQ

Ressourcen