Chuyển đến nội dung chính

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.

​
Tổng quan

Loại: Framework hoặc nền tảngĐường chính: đường tương thích OpenAI mặc địnhMức hỗ trợ: Mẫu tích hợp được khuyến nghị
Đối với TokenLab, lựa chọn mặc định ổn định nhất trong Vercel AI SDK là nhà cung cấp tương thích OpenAI. Nếu bạn cần cụ thể hành vi Responses native, bạn có thể chuyển sang nhà cung cấp OpenAI và giữ nguyên URL cơ sở của TokenLab. Trang này nên được hiểu là một mẫu tích hợp được khuyến nghị, chứ không phải tuyên bố rằng mọi helper trong Vercel AI SDK đều có kiểm thử đầu-cuối chuyên biệt trong repo này.

​
Mặc định được khuyến nghị: Nhà cung cấp tương thích OpenAI

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',
});

​
Tạo văn bản

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);

​
Stream văn bản

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);
}

​
Gọi công cụ

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);

​
Đầu ra có cấu trúc

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);

​
Nếu bạn thực sự cần hành vi Responses-native

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.',
});
Sử dụng @ai-sdk/openai-compatible làm lựa chọn mặc định an toàn cho các tích hợp kiểu proxy. Chỉ chuyển sang @ai-sdk/openai khi bạn thực sự muốn đường dẫn nhà cung cấp được xây dựng trên /v1/responses.

​
Biến môi trường

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

​
Thực tiễn tốt nhất

Đối với các cổng bên thứ ba và backend proxy, @ai-sdk/openai-compatible thường là điểm khởi đầu ít gây nhầm lẫn nhất.
Nếu bạn cần hành vi nhà cung cấp gắn với /v1/responses, hãy chủ động chuyển package nhà cung cấp thay vì trộn cả hai mẫu trong cùng một client.
Không bao giờ để lộ API key TokenLab trong code phía client. Hãy đặt phần thiết lập nhà cung cấp trong các file server hoặc API routes.