AFFiNE BYOK: kendi AI API anahtarını kullanmak ne kazandırıyor?

BYOK açılımı:

**Bring Your Own Key.**

Yani AI özelliğini kullanırken uygulamanın sağladığı ortak model kotası yerine kendi API anahtarını tanımlarsın.

Bu fikir özellikle teknik kullanıcılar için çekici.

Ama güvenlik ve gizlilik açısından yanlış sonuç çıkarmamak gerekiyor.

0.27'deki durum

15 Temmuz 2026 tarihli 0.27 release note:

**Added AI BYOK feature (Experimental).**

diyor.

İki bilgi var:

• özellik var,
• hâlâ deneysel.

Dolayısıyla production benzeri kritik iş akışında önce küçük veriyle test etmek daha doğru.

BYOK neyi değiştirebilir?

Sağlayıcı ve uygulama davranışına bağlı olarak BYOK şu alanlarda kontrol sağlar:

Hesap

AI çağrısı senin model sağlayıcı hesabınla ilişkilendirilebilir.

Faturalandırma

Kullanım maliyeti kendi API hesabına yansıyabilir.

Model erişimi

Sağlayıcının hesabına açtığı modelleri veya limitleri kullanabilirsin.

Anahtar yaşam döngüsü

Anahtarı oluşturma, döndürme ve iptal etme işlemleri sende olur.

Bunlar genel BYOK faydalarıdır.

AFFiNE'in hangi sağlayıcı ve hangi ayarları desteklediğini güncel UI'da doğrulamak gerekir; 0.27 sürüm notu ayrıntılı sağlayıcı matrisi vermiyor.

BYOK ne anlama gelmez?

Tamamen yerel AI

Kendi API anahtarını kullanmak modelin bilgisayarında çalıştığı anlamına gelmez.

Harici model API'si kullanıyorsan veri o hizmete istek olarak gider.

Sıfır veri paylaşımı

BYOK yalnız credential kaynağını değiştirir.

İstek gövdesinde hangi workspace içeriğinin gönderildiğini ayrıca anlamalısın.

Otomatik daha ucuz

Kendi anahtarın bazı kullanım biçimlerinde maliyet kontrolü sağlar; her zaman daha düşük fatura garantisi değildir.

Otomatik daha özel

Gizlilik, seçilen sağlayıcının ve AFFiNE'in veri akışına bağlıdır.

Local-first ile BYOK nasıl yan yana gelir?

[[Local-first]] veri saklama ve çalışma modelini anlatır.

BYOK AI isteğinin kimlik/faturalandırma tarafını etkiler.

Aynı sistemde şunlar birlikte doğru olabilir:

• çalışma alanın yerel veya self-host,
• AI çağrın harici model sağlayıcısına gidiyor,
• API anahtarı sana ait.

Bu bir çelişki değil; farklı sistem sınırlarıdır.

Anahtar güvenliği

Bir BYOK özelliğini kullanırken şu temel kuralları uygula:

• kişisel API anahtarını belge içine yazma,
• ekran görüntüsünde paylaşma,
• gereksiz geniş yetki verme,
• mümkünse harcama limiti tanımla,
• şüpheli durumda anahtarı iptal edip yenisini oluştur.

AFFiNE'in anahtarı nasıl sakladığı ve hangi sağlayıcıya nasıl ilettiği konusunda resmî doküman açıkça bilgi vermiyorsa tahmin üretme.

İlk test

BYOK'u açtığında:

1. düşük riskli deneme workspace'i kullan,
2. sağlayıcı hesabında kullanım logunu kontrol et,
3. küçük prompt gönder,
4. hangi modelin çağrıldığını doğrula,
5. maliyet kaydını kontrol et,
6. anahtarı kaldırınca özelliğin davranışını test et.

Amaç yalnız "çalışıyor" demek değil.

**veri akışını anlamak.**

Kim için değerli?

BYOK özellikle:

• zaten model API hesabı kullanan,
• kullanım maliyetini kendi hesabında görmek isteyen,
• model seçimini daha fazla kontrol etmek isteyen,
• agent/AI altyapısını kendisi yöneten

kullanıcılar için anlamlı.

Sadece ara sıra metin özetliyorsan yerleşik AI deneyimi daha basit olabilir.

Karar

AFFiNE BYOK, 0.27 ile önemli bir kontrol noktası açıyor.

Ama özelliği doğru okumak gerekir:

**Kendi anahtarın var. Bu, kendi yerel modelin olduğu anlamına gelmiyor.**

Gizlilik kararı verirken anahtarın kimde olduğuna değil, içeriğin hangi servislere gittiğine bak.