Proyecta AI Gateway

Yayımladığın uygulamaya yapay zeka özellikleri ekle — chatbot, içerik üretimi, özetleme. OpenAI uyumlu. Üçüncü taraf API anahtarı gerekmez.

Proyecta AI Gateway, oluşturduğun uygulamaların öncü LLM’leri çağırmasını sağlar; her sağlayıcıda hesap açmak, API anahtarlarını yönetmek veya maliyeti önceden karşılamak zorunda kalmazsın. OpenAI uyumludur — OpenAI SDK’yı gateway’e yönlendir, hepsi bu kadar. Şu anda gateway üzerinden yalnızca Anthropic Claude modelleri kullanılabilir. OpenAI, Google ve Groq desteği yol haritasında yer alıyor.

Bununla ne inşa edebilirim?

• Chatbot — müşteri desteği, yapay zeka koçluğu, SSS botları
• İçerik üretimi — açıklamalar, e-postalar, özetler, taslaklar
• Analiz — metinden içgörü çıkarma, veri kategorilendirme, sınıflandırma
• Özetleme — belge, makale ve transkriptleri yoğunlaştırma
• Kişiselleştirme — öneri sistemleri, uyarlanabilir arayüz

Hızlı başlangıç

Proyecta ile oluşturulan bir uygulamada gateway’i, useAI() hook’u aracılığıyla sayfalarından doğrudan çağırabilirsin — anahtar yönetimi yok, backend yok:

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

Gidip gelen bir konuşma için bunun yerine useChat() kullan; mesaj geçmişini senin adına yönetir.

Bilmen gereken iki şey var; anonim bir ziyaretçi senin kredilerini harcayacağı için: prompt’ları sınırlı tut (tüm bir koleksiyonu system içine aktarma) ve her tuş vuruşunda completion tetikleme.

Yapay zeka builder’ına kurmasını söyleyebilirsin: "Add a chatbot to my app. The user types a question and gets a streaming response."

Kendi backend’inden

Gateway, OpenAI Chat Completions protokolünü konuşur; bu nedenle kendi kontrol ettiğin bir sunucudan resmi OpenAI SDK’yı gateway’e yönlendirebilirsin — yalnızca iki değişiklik: baseURL ve anahtar:

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, herhangi bir OpenAI uyumlu istemcide olduğu gibi çalışır:

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

Modeller

Gateway üzerinden aşağıdaki modeller kullanılabilir:

Sağlayıcı	Desteklenen modeller
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

Model ID’sini doğrudan ilet; örneğin claude-sonnet-5, claude-haiku-4-5-20251001. Bu listenin dışındaki herhangi bir model için gelen istekler reddedilir. Ek sağlayıcılar yol haritasında yer alıyor.

API anahtarları, hız sınırları ve bütçeler

Proyecta, çalışma zamanın için otomatik olarak bir PROYECTA_API_KEY sağlar. Genel kullanım senaryosunda bunu elle oluşturmana gerek yoktur.

Organizasyon sahipleri yapay zeka kredisi kullanımını görebilir — mevcut dönem harcaması ve planlarının bütçe üst sınırı. Builder’daki kredi göstergesini besleyen de bu bilgidir.

Nasıl faturalandırılır?

AI Gateway kullanımı, builder’ın uygulamanı düzenlerken tükettiği kredilerden ayrı olarak takip edilir. İstek başına maliyet, temel sağlayıcının tarifesidir ve organizasyonunun yapay zeka kredisi bakiyesine uygulanır.

SSS

AI Gateway ile yapay zeka builder’ı arasındaki fark nedir?

Yapay zeka builder’ı, sohbet panelinde kod yazan ajandır. AI Gateway ise yayımlanmış uygulamanın kendi kullanıcıları bir yapay zeka özelliği istediğinde çağırdığı şeydir.

Kendi sağlayıcı anahtarlarımı getirebilir miyim?

Getirebilirsin — yapay zekadan gateway çağrılarını kaldırmasını isteyin ve Ortam Değişkenleri bölümünde kendi anahtarınla doğrudan bir entegrasyon yapılandır. Birleşik faturalandırma ve paylaşılan hız limiti havuzundan vazgeçmiş olursun.

Görüntü veya ses üretimi için kullanabilir miyim?

Henüz değil. Gateway şu anda yalnızca metin girişi / metin çıkışı desteklemektedir. Görüntü, ses ve video modaliteleri yol haritasında yer alıyor. Görüntü üretimi için bkz. Görüntü Üretimi.

Kullanımı nereden görebilirim?

Kredi kullanımı, organizasyon düzeyinde Settings sayfasında görülebilir (mevcut dönem harcaması ve bütçe üst sınırı). Builder içinde uygulama başına anahtarlar ve canlı kullanım grafikleriyle ayrılmış bir AI Gateway paneli yol haritasında yer alıyor.

Yakında

• AI Gateway için builder paneli — uygulama başına anahtar oluştur, model izin listelerini belirle, canlı harcamayı izle ve anahtarları builder’dan çıkmadan yönet
• Görüntü ve ses modaliteleri — metinden görüntü, metinden ses, sesten metin
• Çalışma zamanı başına kullanım atfı — organizasyonundaki hangi uygulamaların ne kadar harcadığını gör