Vercel AI SDK مع base URL مخصص: CheapTokens في TypeScript

لتشغيل Vercel AI SDK على CheapTokens، ثبّت @ai-sdk/openai-compatible، وأنشئ مزوّدًا باستخدام baseURL: 'https://api.cheaptokens.dev/v1' ومفتاحك، ومرّر provider('deepseek-ai/DeepSeek-V4-Flash-0731') كـ model. كل شيء آخر في تطبيقك، generateText، streamText، ومطالباتك، يبقى كما هو.

لذا إذا كان لديك بالفعل مسار Next.js أو سكربت Node يتحدث إلى نموذج مستضاف عبر AI SDK، فأنت تغيّر ثلاثة أشياء: عنوان URL الأساسي، والمفتاح، ومعرّف النموذج. تتحقق هذا الدليل من الإعداد مقابل صفحة المزوّدين المتوافقين مع OpenAI في AI SDK (29 أكتوبر 2026). ويستخدم واجهة Chat Completions من واجهة CheapTokens API، وهي ما يتحدثه ذلك المزوّد.

التثبيت وإنشاء المزوّد#

حزمتان: حزمة ai الأساسية والمزوّد المتوافق مع OpenAI.

npm install ai @ai-sdk/openai-compatible
export CHEAPTOKENS_API_KEY=ct_your_key_here

ترتيب العمل قصير:

المزوّد نفسه هو استدعاء واحد لـ createOpenAICompatible:

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

export const cheaptokens = createOpenAICompatible({
  name: 'cheaptokens',
  apiKey: process.env.CHEAPTOKENS_API_KEY,
  baseURL: 'https://api.cheaptokens.dev/v1',
  includeUsage: true,
});

name مجرد تسمية لسجلاتك الخاصة. يطلب includeUsage: true عدد الرموز في استجابات البث أيضًا؛ وبدونه يتصرف الافتراضي مثل false. استدعاء cheaptokens('model-id') يمنحك نموذج محادثة؛ وcheaptokens.chatModel('model-id') وcheaptokens.languageModel('model-id') يفعلان الشيء نفسه.

يجب أن يكون معرّف النموذج كاملًا: deepseek-ai/DeepSeek-V4-Flash-0731. الاسم القصير مثل deepseek-v4-flash-0731 هو ما تراه في جداول الأسعار، ولن تقبله الواجهة. إذا لم تكن متأكدًا مما تكتبه، اعرض النماذج باستخدام GET /v1/models وانسخ المعرّف من هناك.

generateText: إجابة واحدة وعدد رموزها#

إليك سكربتًا كاملًا. يطلب إجابة قصيرة ويطبع النص وكائن الاستخدام معًا.

import { generateText } from 'ai';
import { cheaptokens } from './provider';

const result = await generateText({
  model: cheaptokens('deepseek-ai/DeepSeek-V4-Flash-0731'),
  prompt: 'Explain in two sentences what a base URL is.',
});

console.log(result.text);
console.log(result.usage);

شغّله باستخدام npx tsx index.ts. تحصل على الإجابة كنص في result.text، ويحمل result.usage عدد رموز الإدخال والإخراج لذلك الاستدعاء. نطبع الكائن كاملًا لترى كل ما فيه. في مرجع AI SDK لـ streamText (تم التحقق في 29 أكتوبر 2026) يحتوي usage على inputTokens وoutputTokens وtotalTokens؛ تحقق من أنواع نسختك المثبتة قبل ربطها بلوحة تحكم.

لماذا تهتم بقراءة الاستخدام أصلًا؟ لأن هذا هو الرقم الذي تدفع مقابله. لنفترض أن تطبيقك يرسل مطالبة من 1,500 رمز ويحصل على إجابة من 600 رمز. يكلف ذلك الطلب $0.000083 بالأسعار الحالية، وألف منها تبدو هكذا:

عمود CheapTokens إجمالي، الإدخال والإخراج معًا، وأرخص من OpenRouter لكل نموذج في الجدول. إذا أردت تحويل usage إلى ميزانية جارية، فإن تتبع تكلفة رموز الوكيل يعرض الفكرة في Python؛ والحساب نفسه في TypeScript.

streamText: اطبع الكلمات أثناء وصولها#

لواجهة محادثة تريد ظهور النص بينما لا يزال النموذج يكتب. يمنحك streamText متكررًا غير متزامن من أجزاء النص.

import { streamText } from 'ai';
import { cheaptokens } from './provider';

const result = streamText({
  model: cheaptokens('deepseek-ai/DeepSeek-V4-Flash-0731'),
  prompt: 'Write a 100-word product description for a pocket notebook.',
});

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

console.log('\n', await result.usage);

لاحظ عدم وجود await قبل streamText(...): فهو يعود فورًا وتستهلك البث. usage وعد يُحسم عند انتهاء البث، لذا تنتظره بعد الحلقة. في معالج مسار Next.js ستعيد البث إلى المتصفح بدلًا من الكتابة إلى stdout؛ وجزء المزوّد متطابق. إذا أردت الشيء نفسه باستخدام OpenAI SDK العادي، راجع بث استجابات المحادثة في Node.js.

الإجابات الطويلة لا مشكلة هنا: يمكن لـ DeepSeek-V4-Flash على CheapTokens كتابة ما يصل إلى 32,768 رمزًا في إجابة واحدة، ولديه نافذة سياق 380K وسعر واحد في أي ساعة. صفحة النموذج على /en/cheap-deepseek/، والأسعار الحالية على صفحة الأسعار.

بدّل النموذج دون لمس الباقي#

لأن معرّف النموذج فقط هو ما يتغير، فإن تجربة نموذج آخر تعديل سطر واحد. يمتلك GLM-5.3-Flash نافذة سياق 390K ويجيب بما يصل إلى 8,192 رمزًا؛ وبالأسعار الحالية يكلف $0.02 لكل 1M رمز إدخال و$0.04 لكل 1M رمز إخراج.

نمط مفيد هو إبقاء المعرّف في متغير بيئة (process.env.MODEL_ID) حتى تقارن نموذجين على المطالبة نفسها دون إعادة بناء. تساعدك مقارنة DeepSeek مقابل GLM مقابل MiniMax على اختيار أيها يستحق التجربة.

إذا لم يعمل#

معظم الإخفاقات هي أحد ثلاثة أشياء: المفتاح أو عنوان URL أو معرّف النموذج.

• 401 يعني أن المفتاح مفقود أو خاطئ. تحقق من تعيين CHEAPTOKENS_API_KEY في الصدفة التي تشغّل السكربت (يحتاج خادم Next.js إليه في .env.local وإعادة تشغيل).
• 404 يعني عادة أن baseURL فقد /v1 أو أن معرّف النموذج هو الاسم القصير. استخدم https://api.cheaptokens.dev/v1 والمعرّف الكامل.
• تتوقف الإجابة في منتصف الجملة. وصل النموذج إلى حد الإخراج؛ يشرح إصلاح finish_reason "length" ذلك.

الشرح الأطول للأولين موجود في API 401 أو 404: مفتاح أو عنوان URL أساسي أو معرّف نموذج خاطئ.

لربط أدوات أخرى وإجراء الطلب الأول يدويًا، ابدأ من وثائق CheapTokens.