الأطر والمنصات
Vercel AI SDK
استخدام نماذج TokenLab مع Vercel AI SDK
نظرة عامة
استخدم مزود OpenAI-compatible لـ Chat Completions. إذا كان النموذج المحدد وتطبيقك بحاجة إلى Responses، فاستخدم مزود OpenAI مع نفس TokenLab Base URL.
حزمة مزود TokenLab
توفر TokenLab أيضًا غلافًا (wrapper) صغيرًا لـ Vercel AI SDK:
npm install ai @tokenlabai/ai-sdk-providerimport { generateText } from 'ai';
import { tokenlab } from '@tokenlabai/ai-sdk-provider';
const { text } = await generateText({
model: tokenlab.chatModel('gpt-5.6-terra'),
prompt: 'Explain TokenLab in one sentence.',
});
console.log(text);الخيار الافتراضي الموصى به: مزود OpenAI-Compatible
npm install ai @ai-sdk/openai-compatible zodimport { createOpenAICompatible } from '@ai-sdk/openai-compatible';
export const tokenlab = createOpenAICompatible({
name: 'tokenlab',
apiKey: process.env.TOKENLAB_API_KEY,
baseURL: 'https://api.tokenlab.sh/v1',
});توليد النص
import { generateText } from 'ai';
import { tokenlab } from './tokenlab';
const { text } = await generateText({
model: tokenlab.chatModel('gpt-5.6-terra'),
prompt: 'Explain TokenLab in one sentence.',
});
console.log(text);بث النص
import { streamText } from 'ai';
import { tokenlab } from './tokenlab';
const result = await streamText({
model: tokenlab.chatModel('gpt-5.6-terra'),
prompt: 'Write a short poem about coding.',
});
for await (const textPart of result.textStream) {
process.stdout.write(textPart);
}استدعاء الأدوات
import { generateText, stepCountIs, tool } from 'ai';
import { z } from 'zod';
import { tokenlab } from './tokenlab';
const result = await generateText({
model: tokenlab.chatModel('gpt-5.6-terra'),
prompt: 'What is the weather in San Francisco?',
stopWhen: stepCountIs(2),
tools: {
weather: tool({
description: 'Get weather in a location',
inputSchema: z.object({
location: z.string(),
}),
execute: async ({ location }) => ({
location,
temperature: 72,
condition: 'sunny',
}),
}),
},
});
console.log(result.text);المخرجات المهيكلة
import { generateText, Output } from 'ai';
import { z } from 'zod';
import { tokenlab } from './tokenlab';
const { output } = await generateText({
model: tokenlab.chatModel('gpt-5.6-terra'),
output: Output.object({
schema: z.object({
name: z.string(),
role: z.string(),
}),
}),
prompt: 'Generate a fake developer profile.',
});
console.log(output);إذا كنت بحاجة صريحة إلى سلوك Responses الأصلي
npm install ai @ai-sdk/openaiimport { 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.6-terra'),
prompt: 'Explain TokenLab in one sentence.',
});استخدم @ai-sdk/openai-compatible كخيار افتراضي آمن لعمليات التكامل بنمط الوكيل (proxy-style). انتقل إلى @ai-sdk/openai فقط عندما تريد صراحةً مسار مزود مبنيًا على /v1/responses.
متغيرات البيئة
# .env.local
TOKENLAB_API_KEY=sk-your-tokenlab-key