Proyecta AI Gateway

Tambahkan fitur AI ke aplikasi yang kamu publikasikan — chatbot, pembuatan konten, ringkasan. Kompatibel dengan OpenAI. Tidak memerlukan API key dari pihak ketiga.

Proyecta AI Gateway memungkinkan aplikasi yang kamu bangun memanggil LLM terdepan tanpa perlu membuat akun di setiap provider, mengelola API key mereka, atau menanggung biayanya sendiri. Gateway ini kompatibel dengan OpenAI — cukup arahkan OpenAI SDK ke gateway dan selesai. Saat ini, hanya model Anthropic Claude yang tersedia melalui gateway. Dukungan untuk OpenAI, Google, dan Groq sedang dalam roadmap.

Apa yang bisa aku bangun dengannya?

• Chatbot — dukungan pelanggan, pelatihan berbasis AI, bot FAQ
• Pembuatan konten — deskripsi, email, ringkasan, draf
• Analisis — ekstrak wawasan dari teks, kategorisasi data, klasifikasi
• Ringkasan — mempersingkat dokumen, artikel, transkrip
• Personalisasi — rekomendasi, UI adaptif

Quickstart

Dalam aplikasi yang dibangun dengan Proyecta, kamu bisa memanggil gateway langsung dari halaman menggunakan hook useAI() — tanpa penanganan key, tanpa 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>
    );
}

Untuk percakapan bolak-balik, gunakan useChat() sebagai gantinya, yang akan menyimpan riwayat pesan untukmu.

Ada dua hal yang perlu diketahui, karena pengunjung anonim menghabiskan kredit milikmu: jaga agar prompt tetap terbatas (jangan stream seluruh koleksi ke dalam system), dan jangan memicu completion di setiap penekanan tombol.

Minta AI builder untuk menyiapkannya: "Add a chatbot to my app. The user types a question and gets a streaming response."

Dari backend milikmu sendiri

Gateway menggunakan protokol OpenAI Chat Completions, sehingga dari server yang kamu kelola, kamu bisa mengarahkan OpenAI SDK resmi ke gateway tersebut — hanya dua perubahan, baseURL dan key-nya:

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 bekerja seperti klien kompatibel OpenAI pada umumnya:

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 ?? '');
}

Model

Model-model berikut tersedia melalui gateway:

Provider	Model yang didukung
Anthropic	claude-sonnet-5 (unggulan), claude-sonnet-4-6, claude-haiku-4-5-20251001, claude-opus-5, claude-opus-4-8, claude-opus-4-7

Masukkan ID model secara langsung, misalnya claude-sonnet-5, claude-haiku-4-5-20251001. Permintaan untuk model di luar daftar ini akan ditolak. Provider tambahan sedang dalam roadmap.

API key, batas rate, dan anggaran

Proyecta secara otomatis menyediakan PROYECTA_API_KEY untuk runtime kamu. Kamu tidak perlu membuatnya secara manual untuk kasus penggunaan umum.

Pemilik organisasi dapat melihat penggunaan kredit AI — pengeluaran periode saat ini dan batas anggaran paket mereka. Ini yang menggerakkan indikator kredit di builder.

Bagaimana cara penagihannya?

Penggunaan AI Gateway dilacak secara terpisah dari kredit yang dikonsumsi AI builder saat mengedit aplikasimu. Biaya per permintaan mengikuti tarif provider yang mendasarinya, yang diterapkan pada saldo kredit AI organisasimu.

FAQ

Apa perbedaan antara AI Gateway dan AI builder?

AI builder adalah agen yang menulis kode di panel chat. AI Gateway adalah yang dipanggil oleh aplikasi yang sudah kamu publikasikan ketika pengguna aplikasi tersebut menginginkan fitur AI.

Bisakah aku menggunakan API key provider milik sendiri?

Bisa — minta AI untuk menghapus panggilan gateway dan konfigurasikan integrasi langsung dengan key milikmu sendiri di Environment Variables. Kamu akan kehilangan penagihan terpusat dan kumpulan batas rate bersama.

Bisakah aku menggunakannya untuk pembuatan gambar atau suara?

Belum bisa. Saat ini gateway hanya mendukung teks masuk / teks keluar. Modalitas gambar, suara, dan video sedang dalam roadmap. Untuk pembuatan gambar, lihat Image Generation.

Di mana aku bisa melihat penggunaan?

Penggunaan kredit dapat dilihat di tingkat organisasi pada halaman Settings (pengeluaran periode saat ini dan batas anggaran). Panel AI Gateway khusus di dalam builder — dengan key per aplikasi dan grafik penggunaan langsung — sedang dalam roadmap.

Segera hadir

• Panel Builder untuk AI Gateway — buat key per aplikasi, atur daftar model yang diizinkan, pantau pengeluaran secara langsung, dan kelola key tanpa perlu meninggalkan builder
• Modalitas gambar dan suara — teks ke gambar, teks ke ucapan, ucapan ke teks
• Atribusi penggunaan per runtime — lihat aplikasi mana di organisasimu yang menghabiskan berapa banyak