Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Überblick

Typ: Framework oder PlattformPrimärer Pfad: OpenAI-kompatibler StandardSupport-Niveau: Empfohlenes Integrationsmuster
Für TokenLab ist der stabilste Standard im Vercel AI SDK der OpenAI-kompatible Anbieter. Wenn Sie ausdrücklich Responses-natives Verhalten benötigen, können Sie zum OpenAI-Anbieter wechseln und dieselbe TokenLab-Base-URL beibehalten. Diese Seite sollte als empfohlene Integrationsform gelesen werden, nicht als Aussage darüber, dass jede Hilfsfunktion im Vercel AI SDK in diesem Repository durch dedizierte End-to-End-Regressionen abgedeckt ist.

​
Empfohlener Standard: OpenAI-kompatibler Anbieter

npm install ai @ai-sdk/openai-compatible

import { createOpenAICompatible } from '@ai-sdk/openai-compatible';

export const tokenlab = createOpenAICompatible({
  name: 'tokenlab',
  apiKey: process.env.TOKENLAB_API_KEY,
  baseURL: 'https://api.tokenlab.sh/v1',
});

​
Text generieren

import { generateText } from 'ai';
import { tokenlab } from './tokenlab';

const { text } = await generateText({
  model: tokenlab.chatModel('gpt-5.4'),
  prompt: 'Explain TokenLab in one sentence.',
});

console.log(text);

​
Text streamen

import { streamText } from 'ai';
import { tokenlab } from './tokenlab';

const result = await streamText({
  model: tokenlab.chatModel('gpt-5.4'),
  prompt: 'Write a short poem about coding.',
});

for await (const textPart of result.textStream) {
  process.stdout.write(textPart);
}

​
Tool-Aufrufe

import { generateText, tool } from 'ai';
import { z } from 'zod';
import { tokenlab } from './tokenlab';

const result = await generateText({
  model: tokenlab.chatModel('gpt-5.4'),
  prompt: 'What is the weather in San Francisco?',
  tools: {
    weather: tool({
      description: 'Get weather in a location',
      parameters: z.object({
        location: z.string(),
      }),
      execute: async ({ location }) => ({
        location,
        temperature: 72,
        condition: 'sunny',
      }),
    }),
  },
});

console.log(result.text);

​
Strukturierte Ausgabe

import { generateObject } from 'ai';
import { z } from 'zod';
import { tokenlab } from './tokenlab';

const { object } = await generateObject({
  model: tokenlab.chatModel('gpt-5.4'),
  schema: z.object({
    name: z.string(),
    role: z.string(),
  }),
  prompt: 'Generate a fake developer profile.',
});

console.log(object);

​
Wenn Sie ausdrücklich Responses-natives Verhalten benötigen

npm install ai @ai-sdk/openai

import { createOpenAI } from '@ai-sdk/openai';

export const tokenlabResponses = createOpenAI({
  apiKey: process.env.TOKENLAB_API_KEY,
  baseURL: 'https://api.tokenlab.sh/v1',
});

import { generateText } from 'ai';
import { tokenlabResponses } from './tokenlab-responses';

const { text } = await generateText({
  model: tokenlabResponses('gpt-5.4'),
  prompt: 'Explain TokenLab in one sentence.',
});
Verwenden Sie @ai-sdk/openai-compatible als sicheren Standard für Integrationen im Proxy-Stil. Wechseln Sie nur dann zu @ai-sdk/openai, wenn Sie ausdrücklich einen Pfad wünschen, der auf /v1/responses basiert.

​
Umgebungsvariablen

# .env.local
TOKENLAB_API_KEY=sk-your-tokenlab-key

​
Bewährte Praktiken

Für Gateways von Drittanbietern und Proxy-Backends ist @ai-sdk/openai-compatible in der Regel der am wenigsten überraschende Ausgangspunkt.
Wenn Sie Verhalten benötigen, das an /v1/responses gebunden ist, wechseln Sie das Paket bewusst, anstatt beide Muster in einem Client zu vermischen.
Legen Sie Ihren TokenLab API key niemals in clientseitigem Code offen. Platzieren Sie das Anbieter-Setup in Server-Dateien oder API-Routen.