أدلة الانتقالمن 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 Gateway | INFRO | |
|---|---|---|
| عنوان 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-5 | anthropic/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. لم نستنتج شيئًا من تجربة أو اختبار أداء أو محادثة.
- Vercel docs — AI Gatewayاطّلعنا عليه في 19 أكتوبر 2026
- Vercel docs — OpenAI Chat Completions APIاطّلعنا عليه في 19 أكتوبر 2026
- Vercel docs — Chat Completions advancedاطّلعنا عليه في 19 أكتوبر 2026
- Vercel docs — BYOKاطّلعنا عليه في 19 أكتوبر 2026
- Vercel docs — Provider filtering and orderingاطّلعنا عليه في 19 أكتوبر 2026
- Vercel docs — Budgetsاطّلعنا عليه في 19 أكتوبر 2026
- Vercel docs — Custom reportingاطّلعنا عليه في 19 أكتوبر 2026
- Vercel docs — Automatic cachingاطّلعنا عليه في 19 أكتوبر 2026
- Vercel docs — Pricingاطّلعنا عليه في 19 أكتوبر 2026
- Vercel changelog — AI Gateway routing rulesاطّلعنا عليه في 19 أكتوبر 2026