Proyecta AI Gateway

Добавляй AI-функции в опубликованное приложение — чат-боты, генерацию контента, резюмирование. Совместим с OpenAI. Сторонние API-ключи не нужны.

Proyecta AI Gateway позволяет приложениям, которые ты создаёшь, обращаться к передовым LLM без необходимости регистрировать аккаунты у каждого провайдера, управлять их API-ключами или самостоятельно оплачивать расходы. Gateway совместим с OpenAI — достаточно направить OpenAI SDK на него, и всё готово. На данный момент через gateway доступны только модели Anthropic Claude. Поддержка OpenAI, Google и Groq запланирована в roadmap.

Что можно создать?

• Чат-боты — поддержка клиентов, AI-коучинг, FAQ-боты
• Генерация контента — описания, письма, сводки, черновики
• Анализ — извлечение инсайтов из текста, категоризация данных, классификация
• Резюмирование — сжатие документов, статей, транскрибаций
• Персонализация — рекомендации, адаптивный UI

Быстрый старт

В приложении, созданном с помощью Proyecta, ты вызываешь gateway прямо из страниц с помощью хука 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) и не отправляй 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: …' }],
});

Стриминг

Стриминг работает как в любом 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 (flagship), claude-sonnet-4-6, claude-haiku-4-5-20251001, claude-opus-5, claude-opus-4-8, claude-opus-4-7

Передавай ID модели напрямую, например claude-sonnet-5 или claude-haiku-4-5-20251001. Запросы к моделям вне этого списка отклоняются. Дополнительные провайдеры запланированы в roadmap.

API-ключи, лимиты запросов и бюджеты

Proyecta автоматически выдаёт PROYECTA_API_KEY для твоего runtime. В стандартном случае создавать его вручную не нужно.

Владельцы организации могут просматривать расход AI-кредитов — траты за текущий период и лимит бюджета по их тарифу. Именно это отображается в индикаторе кредитов в builder.

Как выставляется счёт?

Использование AI Gateway учитывается отдельно от кредитов, которые потребляет AI builder при редактировании приложения. Стоимость каждого запроса определяется тарифом стороннего провайдера и списывается с баланса AI-кредитов организации.

Часто задаваемые вопросы

В чём разница между AI Gateway и AI builder?

AI builder — это агент, который пишет код в панели чата. AI Gateway — это то, к чему обращается твоё опубликованное приложение, когда его пользователи хотят воспользоваться AI-функцией.

Можно ли использовать собственные ключи провайдера?

Да — попроси AI убрать вызовы gateway и настроить прямую интеграцию с твоим ключом через Переменные окружения. При этом ты потеряешь единую систему биллинга и общий пул лимитов запросов.

Можно ли использовать gateway для генерации изображений или голоса?

Пока нет. На данный момент gateway работает только с текстом: текст на входе и текст на выходе. Поддержка изображений, голоса и видео запланирована в roadmap. Для генерации изображений см. Image Generation.

Где посмотреть статистику использования?

Расход кредитов отображается на уровне организации на странице Settings (траты за текущий период и лимит бюджета). Отдельная панель AI Gateway внутри builder — с ключами для каждого приложения и графиками использования в реальном времени — запланирована в roadmap.

Скоро

• Панель builder для AI Gateway — создание ключей для каждого приложения, настройка разрешённых моделей, отслеживание расходов в реальном времени и управление ключами, не выходя из builder
• Поддержка изображений и голоса — текст в изображение, текст в речь, речь в текст
• Атрибуция использования по runtime — отслеживание расходов каждого приложения в организации