Proyecta AI Gateway

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

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

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

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

شروع سریع

در اپی که با Proyecta ساخته‌ای، می‌توانی مستقیماً از صفحات خود با hook مربوطه یعنی useAI() با gateway ارتباط برقرار کنی — بدون مدیریت کلید، بدون 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() استفاده کن که تاریخچه پیام‌ها را برایت نگه می‌دارد.

دو نکته مهم که باید بدانی، چون یک بازدیدکننده ناشناس از کردیت‌های تو استفاده می‌کند: promptها را محدود نگه دار (کل یک مجموعه را در system استریم نکن)، و با هر ضربه کلید یک completion اجرا نکن.

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

استریمینگ

استریمینگ مانند هر client سازگار با 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 در دسترس هستند:

Provider	مدل‌های پشتیبانی‌شده
Anthropic	claude-sonnet-5 (flagship), 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. درخواست‌هایی برای هر مدلی خارج از این فهرست رد می‌شوند. providerهای بیشتر در نقشه راه قرار دارند.

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

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

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

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

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

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

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

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

آیا می‌توانم کلیدهای provider خودم را بیاورم؟

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

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

هنوز نه. امروز gateway فقط متن دریافت و متن ارسال می‌کند. modalityهای تصویر، صدا و ویدیو در نقشه راه قرار دارند. برای تولید تصویر، به تولید تصویر مراجعه کن.

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

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

به‌زودی

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