Proyecta AI Gateway

ویژگی‌های هوش مصنوعی را به اپ منتشرشده‌ات اضافه کن — چت‌بات، تولید محتوا، خلاصه‌سازی. سازگار با OpenAI. بدون نیاز به API key شخص ثالث.

Proyecta AI Gateway به اپ‌هایی که می‌سازی اجازه می‌دهد بدون اینکه لازم باشد در هر سرویس‌دهنده‌ای حساب بسازی، API keyهایشان را مدیریت کنی یا هزینه‌شان را جداگانه پرداخت کنی، با مدل‌های پیشرفته LLM ارتباط برقرار کنند. این سرویس با OpenAI سازگار است — کافی است OpenAI SDK را به gateway اشاره بدهی و کارت تمام است. در حال حاضر، فقط مدل‌های Anthropic Claude از طریق gateway در دسترس هستند. پشتیبانی از OpenAI، Google و Groq در roadmap قرار دارد.

با آن چه می‌توانم بسازم؟

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

شروع سریع

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: …' }],
});

از AI builder بخواه این را برایت راه‌اندازی کند: "Add a chatbot to my app using the Proyecta AI Gateway. The user types a question and gets a streaming response."

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-4-6`، `claude-haiku-4-5-20251001`، `claude-opus-4-8`، `claude-opus-4-7`

شناسه مدل را مستقیماً وارد کن، مثلاً claude-haiku-4-5-20251001، claude-sonnet-4-6. سرویس‌دهندگان بیشتر در roadmap قرار دارند.

API keyها، محدودیت نرخ و بودجه

Proyecta به‌طور خودکار یک PROYECTA_API_KEY برای runtime تو فراهم می‌کند. در حالت معمول نیازی نیست آن را دستی بسازی.

مالکان سازمان می‌توانند مصرف اعتبارهای هوش مصنوعی را ببینند — هزینه دوره جاری و سقف بودجه پلن. این همان چیزی است که نشانگر اعتبارها در builder را تغذیه می‌کند.

نحوه صورت‌حساب

مصرف AI Gateway جداگانه از اعتبارهایی که AI builder هنگام ویرایش اپت مصرف می‌کند ردیابی می‌شود. هزینه هر درخواست برابر نرخ سرویس‌دهنده زیرین است که از موجودی اعتبارهای هوش مصنوعی سازمانت کسر می‌شود.

پرسش‌های متداول

تفاوت AI Gateway با AI builder چیست؟

AI builder همان عاملی است که در پنل چت کد می‌نویسد. AI Gateway چیزی است که اپ منتشرشده‌ات وقتی کاربرانش به یک ویژگی هوش مصنوعی نیاز دارند فراخوانی می‌کند.

آیا می‌توانم از API keyهای سرویس‌دهنده خودم استفاده کنم؟

بله — از AI بخواه فراخوانی‌های gateway را حذف کند و یک integration مستقیم با کلید خودت در Environment Variables پیکربندی کند. در این صورت صورت‌حساب یکپارچه و pool مشترک محدودیت نرخ را از دست خواهی داد.

آیا می‌توانم از آن برای تولید تصویر یا صدا استفاده کنم؟

هنوز نه. در حال حاضر gateway فقط متن‌به‌متن است. موdalیت‌های تصویر، صدا و ویدیو در roadmap هستند. برای تولید تصویر، به Image Generation مراجعه کن.

کجا می‌توانم مصرف را ببینم؟

مصرف اعتبارها در سطح سازمان در صفحه Settings قابل مشاهده است (هزینه دوره جاری و سقف بودجه). یک پنل اختصاصی AI Gateway درون builder — با keyهای هر اپ و نمودارهای مصرف زنده — در roadmap قرار دارد.

به‌زودی

پنل Builder برای AI Gateway — ساخت keyهای هر اپ، تنظیم لیست مجاز مدل‌ها، مشاهده هزینه زنده و مدیریت keyها بدون خروج از builder
موالیت‌های تصویر و صدا — متن‌به‌تصویر، متن‌به‌گفتار، گفتار‌به‌متن
تخصیص مصرف به هر runtime — ببین کدام اپ‌های سازمانت چقدر هزینه دارند