اتصال Vercel AI SDK به پیکو هوش

Vercel AI SDK کتابخانه‌ی TypeScript برای ساخت رابط چت و جریان متن در Next.js و سایر فریمورک‌هاست. برای APIهای سازگار با OpenAI بسته‌ی @ai-sdk/openai-compatible وجود دارد که با createOpenAICompatible یک ارائه‌دهنده‌ی سفارشی با baseURL و apiKey می‌سازید.

استفاده از بسته‌ی openai-compatible به‌جای @ai-sdk/openai دلیل مشخصی دارد: ارائه‌دهنده‌ی OpenAI در نسخه‌های جدید پیش‌فرض از Responses API استفاده می‌کند که در همه‌ی دروازه‌ها وجود ندارد، ولی بسته‌ی compatible از /chat/completions استفاده می‌کند.

پیش‌نیازها

• یک حساب پیکو هوش و یک کلید API از داشبورد (کلید فقط یک‌بار کامل نمایش داده می‌شود).
• شناسه‌ی دقیق مدل از کاتالوگ؛ در مثال‌ها از gpt-6-sol و claude-sonnet-5-5 استفاده شده است.
• کمی موجودی در کیف پول تومانی یا اعتبار؛ تعرفه را در صفحه‌ی قیمت‌ها ببینید.

راه‌اندازی گام‌به‌گام

1. ۱نصب

   AI SDK و بسته‌ی compatible.

   کپی

   npm install ai @ai-sdk/openai-compatible

2. ۲ساخت ارائه‌دهنده

   یک بار در فایل مشترک بسازید.

   کپی

   import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
   
   export const pico = createOpenAICompatible({
     name: "picoai",
     baseURL: "https://api.picoai.ir/v1",
     apiKey: process.env.PICOAI_API_KEY,
   });

3. ۳تولید متن

   نام مدل را با chatModel بدهید.

   کپی

   import { generateText } from "ai";
   import { pico } from "./lib/pico";
   
   const { text } = await generateText({
     model: pico.chatModel("gpt-6-sol"),
     prompt: "سه ایده برای نام یک کافه بده.",
   });
   console.log(text);

4. ۴استریم در Route Handler

   برای رابط چت، streamText را در مسیر API استفاده کنید. نام تابع تبدیل به پاسخ در نسخه‌های مختلف AI SDK فرق می‌کند؛ مستندات نسخه‌ی خودتان را ببینید.

   کپی

   import { streamText } from "ai";
   import { pico } from "@/lib/pico";
   
   export async function POST(req: Request) {
     const { messages } = await req.json();
     const result = streamText({ model: pico.chatModel("claude-sonnet-5-5"), messages });
     return result.toTextStreamResponse();
   }

تست سریع اتصال

پیش از نوشتن منطق برنامه، یک بار فهرست مدل‌ها را بگیرید. اگر پاسخ ۲۰۰ و فهرستی از شناسه‌ها برگشت، کلید، شبکه و آدرس درست است و هر مشکل بعدی مربوط به تنظیمات Vercel AI SDK خواهد بود.

curl https://api.picoai.ir/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

نکته‌های کاربردی برای Vercel AI SDK

• کلید فقط در سرور استفاده شود؛ مسیر API را بین مرورگر و پیکو هوش قرار دهید.
• نسخه‌ی major کتابخانه ai را ثابت نگه دارید؛ APIهای آن بین نسخه‌ها تغییر کرده است.
• برای خروجی ساخت‌یافته (generateObject) روی مدل انتخابی تست کنید.

عیب‌یابی

هزینه و صورتحساب

هر درخواست قبل از اجرا مقداری از موجودی را رزرو می‌کند و پس از پاسخ موفق بر پایه‌ی توکن‌های واقعی تسویه می‌شود؛ مابه‌التفاوت برمی‌گردد و درخواست ناموفق چیزی کم نمی‌کند. جدول قیمت هر مدل در صفحه‌ی قیمت‌ها منتشر شده و مصرف هر درخواست در داشبورد قابل مشاهده است. اگر قبلاً از سرویس دیگری استفاده می‌کردید، راهنمای مهاجرت و صفحه‌ی مقایسه را ببینید.