Proyecta AI Gateway

أضف ميزات الذكاء الاصطناعي إلى تطبيقك المنشور — شات بوت، توليد محتوى، تلخيص. متوافق مع OpenAI. لا حاجة لمفاتيح API من جهات خارجية.

يتيح لك Proyecta AI Gateway استدعاء نماذج اللغة الكبرى المتطورة من التطبيقات التي تبنيها، دون الحاجة إلى إنشاء حسابات لدى كل مزود، أو إدارة مفاتيح API الخاصة بهم، أو تحمّل التكاليف مسبقًا. وهو متوافق مع OpenAI — فقط وجّه OpenAI SDK نحو الـ gateway وستكون جاهزًا. في الوقت الحالي، تتوفر نماذج Anthropic Claude فقط عبر الـ gateway. دعم OpenAI وGoogle وGroq مدرج في خارطة الطريق.

ما الذي يمكنني بناؤه؟

• شات بوت — دعم العملاء، تدريب بالذكاء الاصطناعي، بوتات الأسئلة الشائعة
• توليد المحتوى — الأوصاف، رسائل البريد الإلكتروني، الملخصات، المسودات
• التحليل — استخراج الرؤى من النصوص، تصنيف البيانات، الفرز
• التلخيص — تكثيف المستندات والمقالات والنصوص المفرّغة
• التخصيص — التوصيات، واجهة المستخدم التكيفية

البداية السريعة

في التطبيقات المبنية بـ Proyecta، يمكنك استدعاء الـ gateway مباشرةً من صفحاتك باستخدام الـ hook‏ useAI() — دون التعامل مع المفاتيح، ودون backend:

import { useAI } from '@/hooks/useAI.ts';

function Summarizer({ article }) {
    const { ask, isPending, error } = useAI({ system: 'You summarize articles.' });
    const [summary, setSummary] = useState('');

    return (
        <button
            disabled={isPending}
            onClick={async () => setSummary(await ask(`Summarize in 3 bullets: ${article}`))}
        >
            Summarize
        </button>
    );
}

للمحادثات ذهابًا وإيابًا، استخدم useChat() بدلًا من ذلك، إذ تحتفظ بسجل الرسائل تلقائيًا.

هناك أمران يستحقان الانتباه، بما أن الزائر المجهول يستهلك رصيدك أنت: حافظ على حدود المطالبات (لا تضخ مجموعة بيانات كاملة في system)، ولا تُطلق اكتمال النص عند كل ضغطة مفتاح.

اطلب من AI builder أن يُعدّ ذلك لك: "Add a chatbot to my app. The user types a question and gets a streaming response."

من الـ backend الخاص بك

يتحدث الـ gateway بروتوكول OpenAI Chat Completions، لذا من أي خادم تتحكم فيه يمكنك توجيه OpenAI SDK الرسمي نحوه — تغييران فقط، baseURL والمفتاح:

import OpenAI from 'openai';

const openai = new OpenAI({
    baseURL: 'https://cloud.proyecta.dev/v1/ai',
    apiKey: process.env.PROYECTA_API_KEY,
});

const response = await openai.chat.completions.create({
    model: 'claude-haiku-4-5-20251001',
    messages: [{ role: 'user', content: 'Summarize this article in 3 bullet points: …' }],
});

Streaming

يعمل الـ streaming كما هو الحال مع أي عميل متوافق مع OpenAI:

const stream = await openai.chat.completions.create({
    model: 'claude-haiku-4-5-20251001',
    messages: [{ role: 'user', content: prompt }],
    stream: true,
});

for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

النماذج

النماذج التالية متاحة عبر الـ gateway:

المزود	النماذج المدعومة
Anthropic	claude-sonnet-5 (الرائد)، claude-sonnet-4-6، claude-haiku-4-5-20251001، claude-opus-5، claude-opus-4-8، claude-opus-4-7

مرّر معرّف النموذج مباشرةً، مثل claude-sonnet-5 أو claude-haiku-4-5-20251001. يتم رفض أي طلب لنموذج خارج هذه القائمة. مزودون إضافيون مدرجون في خارطة الطريق.

مفاتيح API وحدود المعدل والميزانيات

تُوفّر Proyecta تلقائيًا مفتاح PROYECTA_API_KEY لبيئة التشغيل الخاصة بك. لا تحتاج إلى إنشائه يدويًا في الحالة الاعتيادية.

يمكن لمالكي المؤسسات الاطلاع على استهلاك رصيد الذكاء الاصطناعي — الإنفاق الحالي للفترة وحد الميزانية المحدد في خطتهم. وهذا ما يُشغّل مؤشر الرصيد في الـ builder.

كيف تتم الفوترة؟

يُتتبَّع استخدام AI Gateway بشكل منفصل عن الرصيد الذي يستهلكه AI builder عند تعديل تطبيقك. تكلفة كل طلب هي سعر المزود الأساسي، ويُطبَّق على رصيد الذكاء الاصطناعي لمؤسستك.

الأسئلة الشائعة

ما الفرق بين AI Gateway وAI builder؟

AI builder هو الوكيل الذي يكتب الكود في لوحة المحادثة. أما AI Gateway فهو ما يستدعيه تطبيقك المنشور عندما يريد مستخدموه ميزة ذكاء اصطناعي.

هل يمكنني استخدام مفاتيح المزود الخاصة بي؟

نعم، يمكنك ذلك — اطلب من الذكاء الاصطناعي إزالة استدعاءات الـ gateway وتهيئة تكامل مباشر بمفتاحك الخاص عبر متغيرات البيئة. ستفقد الفوترة الموحّدة ومجموعة حدود المعدل المشتركة.

هل يمكنني استخدامه لتوليد الصور أو الصوت؟

ليس بعد. اليوم الـ gateway يعمل على مدخل نصي ومخرج نصي فقط. طرائق الصورة والصوت والفيديو مدرجة في خارطة الطريق. لتوليد الصور، راجع توليد الصور.

أين يمكنني الاطلاع على الاستخدام؟

استهلاك الرصيد مرئي على مستوى المؤسسة في صفحة Settings (الإنفاق الحالي للفترة وحد الميزانية). لوحة AI Gateway مخصصة داخل الـ builder — بمفاتيح خاصة بكل تطبيق ورسوم بيانية حية للاستخدام — مدرجة في خارطة الطريق.

قريبًا

• لوحة Builder لـ AI Gateway — أنشئ مفاتيح خاصة بكل تطبيق، وحدد قوائم النماذج المسموح بها، وراقب الإنفاق بشكل حي، وأدر المفاتيح دون مغادرة الـ builder
• طرائق الصورة والصوت — تحويل النص إلى صورة، النص إلى كلام، الكلام إلى نص
• نسب الاستخدام لكل بيئة تشغيل — اعرف أي تطبيقات في مؤسستك تُنفق ماذا