انتقل إلى المحتوى

أدلة الانتقالمن Vercel AI Gateway

من Vercel AI Gateway، بمعرّفات النماذج نفسها

Vercel AI Gateway هو المزوّد الافتراضي في AI SDK: سلسلة نموذج مثل openai/gpt-6-astra تصل إليه بمفتاح Vercel أو رمز OIDC، وتُخدَم على بيانات اعتماد النظام لدى Vercel أو على مفاتيحك الخاصة. وتستخدم INFRO معرّفات vendor/model نفسها، فالتعديل يطال المزوّد والخيارات، لا أسماء النماذج.

متاح للجميع في كل باقات Vercel؛ والتوثيق محدّثة حتى 2026-10-07

التسجيل في INFRO ذاتي، دون وسيط. الكتالوج والتوثيق وعقد API متاحة للعموم، والبوابة قيد التشغيل، وكل ما يتجاوز v1 موسوم بـ «لاحقًا». الباقات والفترة التجريبية

أين وصلت الأمور

أين وصل الأمر

منتج Vercel نشط في كل باقة. وصدرت قواعد توجيه الفرق التي تحدد النماذج المسموح باستخدامها في 2026-07-02.

على حساب مَن يُخدَم الطلب

افتراضيًا تُستخدم بيانات اعتماد النظام لدى Vercel، وتُدفع من وحدات AI Gateway المشتراة سلفًا. ومع BYOK تقول وثائق Vercel إن الطلب الذي يفشل على بيانات اعتمادك يُعاد على بيانات اعتماد نظامها ويُحتسب من تلك الوحدات، وإن إنفاق BYOK لا يُحتسب في الميزانيات.

ما لا تنسخه INFRO

لا تطبّق INFRO بروتوكول AI Gateway: لا يمكن توجيه مزوّد gateway في AI SDK إلى INFRO. تنتقل إلى مزوّد متوافق مع OpenAI، يأتي ضمن AI SDK.

إذا كان تطبيقك يعمل على Vercel والبوابة تؤدي عملها، فمن الصعب التفوق على هذا التكامل. ابقَ إذا صح أحد ما يلي.

  • تصادق برموز Vercel OIDC من عمليات النشر لديك ولا تريد مفتاح بوابة على الإطلاق. لا تأخذ INFRO إلا مفاتيحها هي.
  • تستخدم Realtime، أو تضمينات من مزوّدين آخرين، أو ميزات AI SDK الخاصة بالبوابة فقط. تخدم INFRO التضمينات على اتصالات OpenAI وAzure OpenAI وMistral والمتوافقة مع OpenAI، ولا تخدم Realtime.
  • تريد اختيار المزوّد بحسب التكلفة أو زمن أول رمز أو الإنتاجية (sort). ليس لدى INFRO ترتيب لكل طلب.
  • تريد الوصول إلى النماذج دون حساب لدى كل مزوّد. تعمل INFRO على حسابات تملكها فقط.
  • تحتاج إلى توجيه بلا احتفاظ بالبيانات أو inferenceRegion لكل طلب. ليس لدى INFRO أيٌّ منهما؛ وإقامة البيانات في خارطة الطريق.

التعديلات، صف لكل منها. كل ما لم يُذكر هنا يبقى كما هو.

 Vercel AI GatewayINFRO
عنوان URL الأساسيhttps://ai-gateway.vercel.sh/v1، أو مزوّد gateway الافتراضي في AI SDK.https://api.infro.io/v1، عبر createOpenAI({ baseURL }) في AI SDK.
المفتاحAI_GATEWAY_API_KEY أو رمز Vercel OIDC.INFRO_API_KEY، مفتاح بوابة INFRO. تنتقل بيانات اعتماد مزوّديك إلى INFRO كاتصالات.
معرّف النموذجanthropic/claude-opus-5anthropic/claude-opus-5، دون تغيير. في AI SDK، استدعِ infro.chat(id): الدالة المجرّدة للمزوّد تستهدف Responses API.
الخياراتproviderOptions.gateway { order, only, models, user, tags }، وترويسات ai-reporting-*.مسار للترتيب، وrouting.providers لتقييد المزوّدين، وfallbacks للنماذج، وmetadata { user_id, tags } للمستخدم والوسوم.

قبل · Vercel AI Gateway

import { generateText } from "ai";

const { text } = await generateText({
  model: "anthropic/claude-opus-5",
  prompt: "Hello",
  providerOptions: {
    gateway: {
      order: ["vertex", "anthropic"],
      user: "user_123",
      tags: ["feature:chat"],
    },
  },
});

بعد · INFRO

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

const infro = createOpenAI({
  baseURL: "https://api.infro.io/v1",
  apiKey: process.env.INFRO_API_KEY,
});

const { text } = await generateText({
  // A route named "chat" holds the order: Vertex, then Anthropic.
  model: infro.chat("chat"),
  prompt: "Hello",
  headers: { "X-INFRO-User-Id": "user_123", "X-INFRO-Feature": "chat" },
});

`.chat()`، لا الدالة المجرّدة

createOpenAI(...)(id) يستهدف Responses API لدى OpenAI. استخدم infro.chat(id) لـ Chat Completions التي يخدمها كل اتصال في INFRO؛ و/v1/responses مخدوم أيضًا، لكنه يحتاج إلى المحادثة كاملة في كل دور.

معرّفات المزوّدين تختلف

vertex وbedrock لدى Vercel هما google-vertex وaws-bedrock لدى INFRO في routing.providers. يُضبط الترتيب على مسار في لوحة التحكم، لا لكل طلب.

الميزانيات ترى كل طلب

كل طلب عبر INFRO يعمل على حسابك الخاص، لذا يُحتسب كل طلب ضمن ميزانياتك. وعند بلوغ السقف ترفض الميزانية الطلب بالرمز 402 budget_exceeded.

كائنات Vercel AI Gateway مقابل كائنات INFRO، استنادًا إلى توثيق Vercel AI Gateway العام كما اطّلعنا عليه في 19 أكتوبر 2026، ومطابقةً مع ما تدعمه البوابة فعلًا. صفّان يقولان إن INFRO لا يملك شيئًا.

Vercel AI Gatewayما تفعله هناكفي INFRO
مفاتيح AI Gateway API وOIDCمختلفمفاتيح الفريق أو رموز Vercel OIDC؛ ولكل مفتاح ميزانية وتاريخ انتهاء.مفاتيح بوابة بحد إنفاق، وقائمة سماح نماذج، وقائمة مزوّدين، ونطاقات IP، وبيئة، مع التدوير أو الإيقاف. لا تبادل لرموز OIDC.
بيانات اعتماد النظام وBYOKمختلفحسابات مزوّدي Vercel افتراضيًا؛ وبيانات اعتمادك اختيارية، مع بديل احتياطي إلى بيانات اعتماد النظام.اتصالاتك فقط، ولا مجموعة حسابات مشتركة أبدًا. كل مزوّد يحاسبك مباشرة.
`order`, `only`مختلفجرّب المزوّدين بالترتيب، أو اقصر الطلب على بعضهم، لكل طلب.يحمل المسار الترتيب وقواعد الفشل؛ ويقيّد routing.providers لكل طلب.
`sort` بحسب التكلفة وTTFT وTPSلا شيءاختيار المزوّد لكل طلب حسب التكلفة أو السرعة.لا شيء. ترتيب المسار أو أوزانه هي التي تقرر.
البدائل الاحتياطية للنماذجالصيغة نفسهاmodels، تُجرَّب بالترتيب.fallbacks، حتى 5.
قواعد التوجيهالصيغة نفسهاقواعد الفريق بشأن النماذج التي يجوز استخدامها.قوائم سماح وحظر لكل مؤسسة ومشروع ومفتاح، بما في ذلك مورّدون بالكامل.
الميزانياتالصيغة نفسهاحدود لكل فريق ومشروع ومفتاح ومستخدم، و402 عند التجاوز؛ مع استبعاد إنفاق BYOK.ميزانيات لكل مؤسسة ومشروع وعضو ومفتاح وعميل نهائي، 402 قبل استدعاء المزوّد؛ وكل طلب يُحتسب.
التقارير المخصّصةالصيغة نفسهاالمستخدم والوسوم لكل طلب؛ وواجهة تقارير API مجمّعة حسب المستخدم والنموذج والوسم والمزوّد.metadata.user_id وtags في كل طلب، واستخدام مجمّع حسب المشروع والمفتاح والنموذج والمستخدم والوسم، وعمليات تصدير.
التخزين المؤقت التلقائي للمطالباتمختلفcaching: 'auto' يضيف علامات الذاكرة المؤقتة لدى المزوّد؛ وترويسة ثبات الجلسة.يعمل التخزين المؤقت للمطالبات لدى المزوّد كما يحدده المزوّد، ويصل cache_control إلى Anthropic كما كُتب على /v1/messages. لا تضيف INFRO أي علامات. وتتوفر بشكل منفصل ميزة اختيارية لتخزين الاستجابات مؤقتًا بالتطابق التام.
Trace Drainsالصيغة نفسهاتتبّعات OpenTelemetry إلى الأداة التي تستخدمها.Spans إلى مجمّع OpenTelemetry الخاص بك من مسار الطلب.
التضمينات و Realtimeمختلفتقدّمها البوابة.التضمينات على اتصالك لدى OpenAI أو Azure OpenAI أو Mistral أو أي اتصال متوافق مع OpenAI، مع تحويل تلقائي عند الأعطال إلى النموذج نفسه فقط. لا ندعم Realtime.
ZDR ومنطقة الاستدلاللا شيءتوجيه بلا احتفاظ بالبيانات على مستوى كل طلب، وinferenceRegion.غير متاح. الاحتفاظ بالبيانات لدى المزوّد يتبع عقدك معه؛ وموقع البيانات على خارطة الطريق.

هذه قراءتنا للوثائق التي نشرتها Vercel AI Gateway، لا نتيجة تجربة أو اختبار أداء. إن أخطأنا في فهم شيء، أخبرنا وسنصحّح الصف.

ما لا يفعله INFRO

  • تطبيق بروتوكول AI Gateway أو مزوّد gateway في AI SDK.
  • قبول رموز Vercel OIDC.
  • خدمة Realtime، أو التضمينات لدى مزوّدين غير OpenAI وAzure OpenAI وMistral أو نقطة نهاية متوافقة مع OpenAI.
  • ترتيب المزوّدين لكل طلب حسب التكلفة أو السرعة.
  • إتاحة الوصول إلى النماذج من دون حسابات مزوّدين خاصة بك.

ما الذي لا ينتقل

  • سجلات الطلبات والتقارير المخصّصة. لا توجد أداة لاستيرادها.
  • AI Gateway credits، وتبقى لدى Vercel.
  • الميزانيات وقواعد التوجيه. أعِد إنشاءها كميزانيات وقوائم سماح في INFRO.

الأسئلة

هل عليّ تغيير معرّفات النماذج؟
لا. كلاهما يستخدم vendor/model، مثل anthropic/claude-opus-5. راجع GET /v1/models لمعرفة ما تخدمه اتصالاتك في INFRO.
هل يعمل AI SDK مع INFRO؟
نعم، عبر createOpenAI من @ai-sdk/openai مع baseURL: https://api.infro.io/v1، باستدعاء infro.chat(modelId).
من يحاسبني على استخدام النماذج؟
مزوّدوك، مباشرة، على حساباتك الخاصة. INFRO اشتراك بهامش 0% على إنفاق النماذج.

انتقل معنا، أو بمفردك

يطابق برنامج الترحيل إعداداتك في Vercel AI Gateway مع اتصالات INFRO ومساراته وميزانياته خلال مكالمة، وينقل معك الخدمة الأولى. ويستمر مزوّدوك في محاسبتك مباشرة؛ وINFRO اشتراك يضيف 0% على الإنفاق على النماذج.

المصادر

كل معلومة عن Vercel AI Gateway في هذه الصفحة مصدرها أحد هذه المراجع، كما اطلعنا عليها في 19 أكتوبر 2026. لم نستنتج شيئًا من تجربة أو اختبار أداء أو محادثة.