Proyecta AI Gateway

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

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

Що можна створити?

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

Quickstart

У застосунку, створеному в 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: …' }],
});

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` (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-кредитів організації.

FAQ

Яка різниця між AI Gateway і AI builder?

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

Чи можна використовувати власні ключі провайдера?

Так — попроси AI видалити виклики gateway і налаштуй пряму інтеграцію з власним ключем у розділі Environment Variables. При цьому ти втратиш уніфіковану тарифікацію та спільний пул лімітів запитів.

Чи можна використовувати gateway для генерації зображень або голосу?

Поки що ні. Сьогодні gateway працює в режимі текст-на-вхід / текст-на-виході. Модальності зображень, голосу та відео заплановані в roadmap. Для генерації зображень дивись Image Generation.

Де можна переглянути використання?

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

Незабаром

Панель builder для AI Gateway — створюй ключі для кожного застосунку, налаштовуй allowlist моделей, стеж за витратами в реальному часі та керуй ключами, не виходячи з builder
Модальності зображень і голосу — text-to-image, text-to-speech, speech-to-text
Атрибуція використання за runtime — дізнавайся, які застосунки в організації скільки витрачають