Erken kayıt fiyatı (25 Aralık'a kadar), aboneliğin devam ettiği sürece sabit: Go aylık $10 (normalde $20), Opus 5.5'li Plus aylık sadece $30 (normalde $50)Hemen abone ol →

Genie 4 API Kullanıma Açıldı: Fiyatlandırma, Kurulum ve Sınırlar (Kasım 2026)

Google, 19 Kasım 2026'da oynanabilir bir dünyayı API anahtarının arkasından çıkardı. Ancak iki dakikalık bir demo yaklaşık 12 dolara mal oluyor ve dünya bir dakika geçmeden kendi geçmişini unutmaya başlayabiliyor. Genie 4 API, Gemini Interactions API ve Google AI Studio üzerinden kullanıma açık. Kısa ve etkileşimli prototipler için denemeye değer; kalıcı oyunlar içinse henüz erken.

Genie 4 API ne zaman kullanıma açıldı?

Google, geliştirici erişimini 19 Kasım 2026'da Gemini API'nin Interactions API'si (v1beta) ve Google AI Studio üzerinden duyurdu. Bu tarih, Project Genie'nin AI Ultra abonelerine açılmasından bir gün sonraydı. Model tanımlayıcısı, AI Studio Genie dokümanlarında belirtildiği üzere models/genie-4.

Erişim için ücretli bir Gemini API anahtarı gerekiyor. Genie 4'ün ücretsiz katmanı yok. Google'ın bu arayüzü v1beta olarak etiketlemesi de istek biçimlerinin ve kota sınırlarının değişebileceği anlamına geliyor.

Resmî duyuruya göre Genie 4; 1280x720 çözünürlükte, 24 fps hızında, 48 kHz stereo sesle senkronize edilmiş sürekli bir 16:9 dünya üretiyor. Ortam sesleri, efektler ve karakter diyalogları da bu çıktıya dahil. Dünya bir metin isteminden, 16:9 referans görselden veya ikisinin birlikte kullanılmasından oluşturulabiliyor. Kullanıcılar WASD ya da ok tuşlarıyla hareket edebiliyor; oturum sırasında gönderilen metin istemleriyle hava durumunu, ışığı, nesneleri veya olayları değiştirebiliyor. Genie 4, çevrimdışı video üretiminden farklı olarak kareleri canlı girdilere yanıt verecek şekilde oluşturuyor.

Genie 4 oturumu gerçekte ne kadar tutuyor?

Genie 4 token bazlı fiyatlandırılıyor, ancak pratikte takip etmeniz gereken rakam süre. AI Studio Genie dokümanlarında giriş token'ları için milyon başına $1.50, metin çıktı token'ları için milyon başına $9.00 ve video çıktı token'ları için milyon başına $17.50 ücreti yer alıyor. Video, kare başına 240 token üzerinden hesaplanıyor. Dokümanlardaki birleşik akış tahmini ise saniyede yaklaşık ~$0.10.

KullanımÜcret
Giriş token'ları$1.50 / 1M token
Metin çıktı token'ları$9.00 / 1M token
Video çıktı token'ları$17.50 / 1M token
24 fps hızında video token tüketimi240 x 24 = saniyede 5,760 token
Etkin akış maliyetiDokümanlara göre birleşik tahmin: ~$0.10 / saniye

Sayacı asıl hızlandıran video: 5,760 / 1,000,000 x $17.50 = yalnızca video token'ları için saniyede $0.1008. Bu nedenle dokümanlar, video ve ses akışının toplamını yaklaşık ~$0.10/sn olarak yuvarlıyor. Bu da istem ve diyalog token'ları hariç, dakikada yaklaşık $6.05 ve 120 saniyelik tam bir oturum için yaklaşık $12.10 demek.

Bütçeyi şöyle düşünün: On farklı kullanıcının 30 saniyelik ziyaret ettiği bir açılış sayfası demosu toplamda ~300 saniye üretim yapar ve yaklaşık 30 dolarlık dünya üretim maliyeti çıkarır. Bir saatlik kesintisiz üretim ise yaklaşık $363 tutar. Paranın yanında ikinci bir sınır daha var: kota. AICoder'ın lansman analizine göre Tier 1'de 2 eşzamanlı oturum ve günde 50 istek, Tier 2'de 5 oturum ve 250 istek, Tier 3'te ise 10 oturum ve 1.000 istek bulunuyor. Beta kotaları değişebildiği için yük testi öncesinde hız sınırı dokümanlarından kendi katmanınızı kontrol edin.

Basit denemeler bile ücretlendiriliyor. Bu yüzden önce AI Studio Live oyun alanında test edin, ardından API anahtarı kullanan entegrasyona geçin.

WebRTC mi WebSocket mi? Seçimi görüntüyü nerede işlediğinize göre yapın

YetenekWebRTCWebSocket
En uygun kullanımKlavye kontrollü tarayıcı deneyimiSunucu tarafı işleme, kayıt ve özel medya akışları
SDKTarayıcı JS/TS içinde @google/genaiPython async için google-genai, Node için @google/genai
Medya<video> öğesine yerel RTP video + Opus sesBase64 JPEG + 48 kHz Int16 PCM içeren JSON step.delta
Gecikme davranışıEn düşük gecikme; UDP + jitter bufferDaha yüksek gecikme; kayıplarda TCP head-of-line blocking
Veri yükü sınırı64 KB SCTP sınırı; son encode edilmiş seed boyutunu kontrol edinDaha büyük JSON veri yükleri kullanılabilir

Yukarıdaki taşıma karşılaştırması AI Studio Genie dokümanlarına dayanıyor: WebRTC, duyarlı tarayıcı deneyimi için varsayılan seçenek; WebSocket ise kayıt ve özel işlem hatları için öneriliyor.

WebRTC ve WebSocket taşıma seçeneklerini gösteren Genie 4 etkileşimli dünya üretimi dokümantasyonu

Genie dokümanlarının kimlik doğrulama bölümüne göre güvenli mimari her iki seçenek için de aynı. Sunucu interactions.create çağrısını yapıyor, tek oturumluk geçici bir token oluşturuyor ve tarayıcıya yalnızca etkileşim kimliğiyle bu token'ı gönderiyor. Uzun ömürlü API anahtarını istemci koduna kesinlikle gömmeyin. Standart tarayıcı WebSocket bağlantısı x-goog-api-key başlığını ekleyemediği için tarayıcı bağlantılarında auth_tokens/... oturum token'ı kullanılıyor.

Oturum yaşam döngüsü dokümanlarındaki temel akış şöyle:

  1. Sunucu: models/genie-4 ile interactions.create çağrısı yapar.
  2. Sunucu: Tek oturumluk auth_token oluşturur, kimlik ve token'ı tarayıcıya gönderir.
  3. İstemci: WebRTC veya WebSocket üzerinden interactions.connect bağlantısını kurar.
  4. İstemci: world_prompt ve isteğe bağlı 16:9 reference_image içeren tam olarak bir adet world_setup gönderir.
  5. İstemci: user_action tuş olayları ve input metin olaylarıyla dünyayı yönlendirir.
  6. İstemci veya sunucu: Üretimi ve faturalandırmayı durdurmak için complete() çağrısını yapar.

Basılı tutulan tuşlar, key_up gönderilene kadar etkisini sürdürür. İstemcilerin işletim sisteminin tuş tekrarını bastırması gerekir. Dokümanlardaki örnekte E, Q veya Space için özel eylemlere yerleşik bir zıplama davranışı tanımlanmıyor; bu tuşlar açıklayıcı metin girdileri olarak işleniyor.

Buradaki faturalandırma tuzağı, kodun kendisinden daha önemli. Dokümanların yaşam döngüsü bölümüne göre complete() sunucu tarafındaki üretimi ve faturalandırmayı durduruyor, cancel() işlemi hemen iptal ediyor. Buna karşılık detach() yalnızca yerel soketi kapatıyor; faturalandırmayı durduracağı varsayılmamalı. Tarayıcı sekmesini kapatmak da taşıma bağlantısını ayırıyor, ancak üretimin duracağını garanti etmiyor. Her zaman açıkça complete() veya cancel() çağrısı yapın.

WebRTC kullanırken başlangıç görsellerine dikkat etmek gerekiyor. Dokümanlar 64 KB SCTP sınırına işaret ediyor ve yaklaşık %33'lük base64 genişlemesinden sonra bu bütçenin kabaca yarısı kadar küçük, son hâliyle base64'e dönüştürülmüş seed görselleri öneriyor. Yalnızca çözünürlüğe güvenmek yerine encode edilmiş veri yükünün boyutunu kod içinde kontrol edin; fazla büyük seed'leri WebSocket üzerinden gönderin.

Demonuzu bozabilecek 4 sınır

Sınırlamalar bölümüne göre model, kalıcı bir 3B sahne grafiği yerine kayan bir zamansal pencere tutuyor. Kullanıcılara bir şey vaat etmeden önce tasarımınızı şu dört kısıta göre şekillendirin.

1. Kesin 120 saniye sınırı. Dokümanlara göre her oturum 120 saniyede sona eriyor. Yeni oturumları arka arkaya başlatmak deneyimi uzatabilir, ancak oturumlar kaldığı yerden devam etmediği için sahnenin tam durumunu korumaz. İlk karenin gelmesinden önce dünya kurulumu birkaç saniye sürüyor; hızlı başlangıç dokümanında bu süre ~5–9 saniye olarak gösteriliyor.

2. 60–90 saniye sonra bozulma, görüş alanından çıkınca sıfırlanma. Dokümanlar, görsel kararlılığın 60–90 saniye sonra azalabileceği konusunda uyarıyor. Ayrıca 8 saniyeden uzun süre başka yöne bakmak veya 360 derece dönmek; önemli noktaların, kapıların ya da düğmelerin yer değiştirmesine neden olabiliyor. Kanal örneğinde 180 derece dönüp geri geldiğinizde arka plandaki binalar farklı bir düzene sahip olabilir. Tabelalar, göstergeler, saatler ve kesin sayılar ilk bozulan unsurlar. Dokümanlar, sert kamera kesmeleri yerine süreklilik taşıyan değişikliklerin tarif edilmesini; kısa istemlerin yaklaşık 1,5 saniyeye yayılarak tekrarlanmasını ve aralarında yaklaşık 2 saniyelik bekleme bırakılmasını öneriyor. Bunun nedeni, dünya planlamasının metni adım sınırlarında örneklemesi.

3. Gecikme ve bölge hassasiyeti. Dokümanlara göre Genie 4; ABD, Batı Avrupa ve Japonya'dan hizmet veriyor. Kuzey Amerika, Batı ve Orta Avrupa ile Doğu Asya'da gidiş-dönüş gecikmesi ~150 ms'nin altındaysa en iyi yanıt süresi elde ediliyor. Bu eşik aşıldığında yönlendirme ağırlaşıyor ve kare hızı düşebiliyor. Arka uç aktarıcılarını hizmet verilen bölgelere yakın konumlandırın ve hedef coğrafyadan WebRTC gecikmesini test edin. Düşük gidiş-dönüş gecikmesinde klavye tepkisi ~0,2–0,5 saniye, metin olayları ise ~1–2 saniye olarak dokümante edilmiş.

4. Sabit tuval ve engellenen içerikler. Çıktı 16:9, 720p ve 24 fps ile sınırlı. Portre modu, yapılandırılabilir kare hızı, canlı mikrofon veya kamera girdisi, function calling, Search grounding, yapılandırılmış çıktılar ve oturuma devam etme desteği yok. Tanımlanabilir kişiler, kamuya mal olmuş kişiler veya markalı fikrî mülkiyet içeren istemler ya da seed'ler engellenebilir veya akışın sona ermesine yol açabilir. Her çıktıda fark edilmesi mümkün olmayan bir SynthID filigranı bulunuyor.

"İyi görünüyor, tam bir içerik çöplüğü değil; ama Google'ın seçip hazırladığı belirli örneklerle ilgilenmiyorum... Steve adında sıradan birinin bunu YouTube'da canlı kullandığını, hatta sohbetinden gelen fikirleri uyguladığını görmek istiyorum. Seçilmiş örnekler olmadan ne kadar iyi çalıştığını asıl o zaman anlayabiliriz." — u/RobXSIQ, seçilmiş demolar yerine senaryosuz canlı test talep ediyor

Lansmandan önce bu senaryosuz yürüyüş testini yapın: dünyaya girin, 10 saniye boyunca başka yöne bakın, 360 derece dönün, art arda birbiriyle çelişen üç metin olayı gönderin ve hangi unsurların hareket ettiğini izleyin.

Bu hafta Genie 4 üzerine proje kurulmalı mı?

Genie 4; kısa süreli, yönlendirilebilir ve geçici dünyalar için uygun. Google'ın dokümanlardaki karşılaştırması, sınırı iki kardeş modelle çiziyor: çevrimdışı klipler için Gemini Omni 1.2 Flash ve sesli ajanlar için Gemini 3.8 Live.

İşBunu kullanınNedeni
Oynanabilir prototip, mekânsal gezinti, tarayıcı oyuncağı, ajan oyun alanıInteractions API üzerinden Genie 4Canlı 24 fps yönlendirme ve yerel ses; bu karşılaştırmada WASD ile birlikte çalışma sırasında metin girdisini destekleyen seçenek
İşlenmiş 3–15 saniyelik klip, 30 saniyeye düzenleme/uzatma, 1080p/4K yükseltmeInteractions API üzerinden Gemini Omni 1.2 Flash6 adede kadar referans görselle çevrimdışı düzenleme döngüsü; çevrimdışı düzenleme ve daha yüksek çıktı çözünürlüğü
Mikrofon/kamera, araçlar ve grounding kullanan sesli ajanLive API üzerinden Gemini 3.8 LiveÇift yönlü ses/video anlama ve tool calling; Genie 4'te bunların hiçbiri yok

İlk kullanım için etkileşimli moodboard'lar, seviye tasarımı denemeleri, gerçek bir dünya yerine güvenli bir sahte dünyanın tercih edildiği robotik veya ajan sandbox'ları ve iki dakikadan kısa etkinlik demoları iyi seçenekler. Kalıcı çok oyunculu durumlar, kesin envanter veya tabela bilgisi, uzun eğitim çalışmaları, portre modunda mobil tam ekran deneyimleri ve tekrarlanabilir seed gerektiren işler ise kötü adaylar.

Genie 4 API için ücretsiz katman var mı?

Hayır. Genie 4 için ücretli bir Gemini API anahtarı gerekiyor. Dokümanlar, sesli dünya akışı için etkin maliyeti saniyede yaklaşık $0.10 olarak veriyor.

Tarayıcılar API anahtarını açığa çıkarmadan Genie 4'ü çağırabilir mi?

Evet, geçici token'larla. Sunucu etkileşimi oluşturup tek oturumluk bir token üretiyor; tarayıcı da uzun ömürlü anahtar yerine bu kısa ömürlü token'la bağlanıyor.

Genie 4 oturumu 2 dakikadan uzun sürebilir mi?

Hayır. Oturumlar 120 saniyeyle sınırlı, kararlılık çoğu zaman 60–90 saniye sonra azalıyor ve oturumlara kaldığı yerden devam edilemiyor. Daha uzun akışlar için yeni oturumları arka arkaya başlatabilirsiniz, ancak sahne durumu tam olarak taşınmaz.

Sekmeyi kapatmak Genie 4 faturalandırmasını durdurur mu?

Güvenilir biçimde durdurmaz. Dokümanlara göre sekmeyi kapatmak taşıma bağlantısını ayırıyor, ancak sunucu tarafındaki üretim devam edebiliyor. Faturalandırmayı bitirmek için her zaman complete() veya cancel() çağrısı yapın.

Lansman öncesi operasyon listesi: etkileşimleri sunucu tarafında oluşturun, oturum başına token üretin, tek bir world_setup gönderin, işletim sisteminin tuş tekrarını bastırın, diyalog token'larına ek olarak yaklaşık ~$0.10/sn bütçe ayırın, aktarıcıları ABD/AB/Japonya hizmet bölgelerine yakın konumlandırın ve her oturumu complete() ile sonlandırın. Karşılığında, kısa hafıza ve saniye bazlı ücretlendirme pahasına "istemin içinde yürüme" hissi elde ediyorsunuz.