Program İçi Yapay Zekâ Asistanı (API Anahtarı ile)

Şekil 1 – AI Konsolu: 1 sohbet, 2 mesaj kutusu ve gönder, 3 servis + API Key Ayarları (anahtar) + Modelleri Getir (yeşil ok) + Modeli Kullan (onay), 4 dosya ve ses, 5 model listesi, 6 aktif model, 7 detay paneli

1. Bu makale hakkında

StatiCAD Ultimate ve Hybrid'in içinde bir Yapay Zekâ Asistanı (AI Konsolu) bulunur. Ona Türkçe yazarsınız, o da isteğinizi program komutlarına çevirir: duvar, kolon, kiriş, döşeme ve temel çizer; kat ekler; yönetmelik ve deprem parametrelerini girer; analizi başlatır; sonuçları okur; rapor üretir. Ayrıca aks, kapı, pencere ve hatıl çizer, 3B görünümü açar, IFC içe ve dışa aktarımı yapar (IFC dışa aktarımı demo kurulumlarda kapalıdır) ve projeyi kaydeder.

Asistanın dili: Program arayüzü Türkçe ise asistan Türkçe başlar; arayüz başka bir dildeyse İngilizce başlar. Ardından her zaman sizin yazdığınız dilde yanıt verir.

Asistan, isteğinizi seçtiğiniz yapay zekâ şirketinin sunucusuna API üzerinden gönderir. Bunun için o şirketten bir API anahtarı almanız ve hesabınıza kredi yüklemeniz gerekir. Bu makale Claude, OpenAI (ChatGPT'nin şirketi) ve Google Gemini için anahtar almayı, anahtarı programa girmeyi ve ilk istekleri adım adım anlatır.

tehlike

Abonelik API değildir: ChatGPT Plus ya da Claude Pro aboneliğiniz varsa bile program içi asistan için ayrıca geliştirici sitesinden API kredisi almanız gerekir. Abonelikle çalışan yol Claude Code ve Codex'tir (Claude Code makalesi).

bilgi

Sürüm ve gereksinimler: Ultimate ve Hybrid sürümlerinde bulunur. İnternet bağlantısı gerekir. Demo kurulumlarda asistan çalışır ama rapor, DXF ve IFC dışa aktarma kapalıdır ve proje .sdm olarak kaydedilir.

2. Nasıl çalışır?

1. İsteğinizi AI Konsolu'na yazarsınız: “Zemin kata 5×4 m bir oda çiz, duvarlar 30 cm”.
2. StatiCAD bu isteği, programın komut rehberiyle (YARDIM_AI_KOMUTLAR.md) ve son birkaç mesajınızla birlikte seçtiğiniz servise gönderir.
3. Yapay zekâ hangi program komutlarının, hangi sırayla çalışacağına karar verir.
4. StatiCAD komutları çalıştırır; sonuç sohbette yazar, değişiklikler planda görünür.

bilgi

Asistan neyi göremez? Asistan ekranınızı göremez ve bilgisayarınızdaki dosyaları okuyamaz; yalnız yazdıklarınızı, gönderdiğiniz dosyaları ve komutların döndürdüğü sonuçları bilir. Yalnız son birkaç soru-cevabı hatırlar: uzun işlerde isteği tek mesajda, ölçüleriyle birlikte yazın.

3. Hangi servisi seçmeliyim?

Servis	Neden	Anahtar nereden	Ödeme
Claude (Anthropic)	Önerilen. Türkçe anlatımı ve program komutlarını doğru sırayla kullanması güçlüdür.	platform.claude.com	Ön ödemeli kredi, en az yaklaşık 5 USD
OpenAI (ChatGPT'nin şirketi)	Yaygın. Sesli komut (Bas-Konuş) için de gereklidir.	platform.openai.com	Ön ödemeli kredi, en az 5 USD
Gemini (Google)	Ücretsiz deneme katmanı var (dakika ve gün başına sınırlı).	aistudio.google.com	Ücretsiz katman; fazlası için faturalandırma açılır
Grok, Mistral, DeepSeek	Listede bulunur; kendi sitelerinden anahtar alınır.	Sağlayıcının sitesi	Sağlayıcıya göre
Ollama, llama.cpp	Bilgisayarınızda çalışan yerel modeller (ileri düzey). Güçlü bir bilgisayar ister; komut kullanımı büyük servisler kadar iyi olmayabilir.	Anahtar gerekmez	Ücretsiz

Bir servisle başlamanız yeterlidir. Aşağıda en çok kullanılan üçü için adımlar var; birini izleyip 7. bölüme geçin.

4. Claude API anahtarı almak

1. Tarayıcıda platform.claude.com adresini açın (eski adres console.anthropic.com da aynı yere gider).
2. Sign up ile hesap açın: e-posta adresinizle ya da Continue with Google ile. E-postanıza gelen bağlantıyla hesabı doğrulayın; telefon doğrulaması da istenebilir. Hesap türü sorulursa bireysel kullanım (Individual) seçin.
3. Ayarlar bölümünde Billing (faturalandırma) sayfasını açın, kredi kartınızı ekleyin ve Buy credits ile kredi alın. Başlangıç için 5–10 USD yeterlidir. Otomatik yeniden yükleme (auto-reload) seçeneğini kapalı bırakabilirsiniz.
4. API Keys sayfasında Create Key'e tıklayın, anahtara bir ad verin (ör. StatiCAD) ve oluşturun.
5. sk-ant- ile başlayan anahtarı hemen kopyalayın: bir daha gösterilmez. Kaybederseniz yenisini oluşturursunuz.
6. İsteğe bağlı: Limits sayfasından aylık harcama sınırı koyun.

ipucu

Kredi bitince: Kredi bitince asistan “kredi yetersiz” türünde bir hata verir. Billing sayfasından kredi ekleyin; anahtarı yeniden girmeniz gerekmez. Yüklenen kredinin bir yıl içinde kullanılması gerekir.

5. OpenAI API anahtarı almak

1. Tarayıcıda platform.openai.com adresini açın ve giriş yapın (ChatGPT hesabınızla girebilirsiniz; geliştirici hesabı ayrıca açılır).
2. Ayarlar (dişli simgesi) › Billing sayfasında kartınızı ekleyin ve Add to credit balance ile kredi yükleyin (en az 5 USD).
3. API keys sayfasında Create new secret key'e tıklayın, ad verin (ör. StatiCAD) ve oluşturun.
4. sk- ile başlayan anahtarı hemen kopyalayın; bir daha gösterilmez.
5. İsteğe bağlı: Limits bölümünden aylık bütçe sınırı koyun.

bilgi

Sesli komut: AI Konsolu'ndaki Bas-Konuş (konuşmayı yazıya çevirme) özelliği her zaman OpenAI anahtarını kullanır. Sohbet için Claude seçseniz bile sesli komut istiyorsanız bir OpenAI anahtarı da girin.

6. Gemini API anahtarı almak (ücretsiz deneme)

1. Tarayıcıda aistudio.google.com/apikey adresini açın ve Google hesabınızla giriş yapın; kullanım koşullarını onaylayın.
2. Create API key'e tıklayın. Bir Google Cloud projesi sorulursa önerilen (ya da yeni) projeyi seçin.
3. AIza ile başlayan anahtarı kopyalayın.

tehlike

Ücretsiz katmanın sınırları: Ücretsiz katmanda dakika ve gün başına istek sınırı vardır; uzun işlerde “çok fazla istek” hatası alabilirsiniz. Ücretsiz katmanda gönderdiğiniz içerik Google tarafından hizmet geliştirmede kullanılabilir; gizli projelerde AI Studio'da faturalandırmayı açarak ücretli katmana geçin.

7. Anahtarı StatiCAD'e girmek

1. StatiCAD'i açın ve ana ekrana geçin (başlangıç ekranında alt sıradaki Ana Ekran simgesi).
2. Alt araç çubuğunun sağ ucundaki Yapay Zeka düğmesine tıklayın (Genel bakış, Şekil 1). AI Konsolu ekranın sağ alt köşesinde açılır (Şekil 1).
3. Turuncu anahtar simgesine (API Key Ayarları) tıklayın.
4. Açılan pencerede anahtarınızı sağlayıcının kutusuna yapıştırın (Ctrl+V): Claude anahtarı Claude kutusuna, OpenAI anahtarı OpenAI kutusuna, Gemini anahtarı Gemini kutusuna. Anahtar yıldızlarla gizli görünür.
5. Kaydet'e basın.

bilgi

Anahtar nerede saklanır? Program anahtarı bu bilgisayar ve Windows kullanıcınız için şifreleyerek program klasöründe (AI\Keys) saklar; başka bilgisayara kopyalanan dosya çalışmaz. Program güncellemesi bu dosyayı siler: güncellemeden sonra anahtarınızı yeniden girin. Bu nedenle anahtarı güvenli bir parola yöneticisinde saklayın ya da gerektiğinde yenisini oluşturun.

8. Servisi ve modeli seçmek

1. Servis listesinden anahtarını girdiğiniz servisi seçin (ör. Claude).
2. Yeşil oklu Modelleri Getir düğmesine tıklayın. Alttaki kutuda (Şekil 1, 5) modeller listelenir.
3. Listeden bir model seçin ve yeşil onay simgesine (Modeli Kullan) tıklayın. Aktif satırında servis ve model görünür (ör. Aktif: Claude / claude-sonnet-…).

Servis	Dengeli (önerilen)	Ekonomik, hızlı	En güçlü, pahalı
Claude	Adında sonnet geçen en yeni model	Adında haiku geçen	Adında opus geçen
OpenAI	En yeni gpt modeli	Adında mini geçen	Adında pro geçen
Gemini	Adında flash geçen en yeni model	Adında flash-lite geçen	Adında pro geçen

tehlike

Program her açılışta OpenAI'yi seçer: Bu sürümde servis ve model seçimi kalıcı değildir: StatiCAD yeniden açıldığında AI Konsolu OpenAI servisiyle başlar. Claude ya da Gemini kullanıyorsanız her oturumda önce Servis listesinden kendi servisinizi seçin ve Modeli Kullan ile onaylayın. Aksi hâlde “Seçili servis için API key bulunamadı” uyarısı alırsınız.

9. İlk sohbet

1. Mesaj kutusuna yazın ve sağdaki mavi oka tıklayın (Enter mesajı göndermez):

Merhaba. Kendini kısaca tanıt ve StatiCAD'de neler yapabildiğini üç maddede anlat.

Yanıt geldiyse bağlantı çalışıyordur. Şimdi küçük bir iş verin:

Zemin kata 5×4 m bir oda çiz: sol alt köşe (0,0), duvar kalınlığı 30 cm. Ardından aynı köşelere döşeme çiz.

Asistan duvarları ve döşemeyi çizer, ne yaptığını yazar. Plan ekranında sonucu kontrol edin. Hangi komutların çalıştığını görmek için Detaylar düğmesiyle sağ paneli açın (Şekil 2): Komutlar listesinde asistanın çağırdığı komutlar, Sonuçlar listesinde programın yanıtları görünür.

Şekil 2 – Detay paneli: Komutlar, Sonuçlar ve Dosyalar

ipucu

İstenmeyen değişiklik: Asistan yanlış bir şey çizdiyse Geri Al (Ctrl+Z) ile geri alın ya da asistana “son çizdiğin duvarı sil” deyin. Önemli işlerden önce projeyi kaydedin.

10. Örnek istekler

Ne için	Örnek istek
Proje ayarları	“Yönetmeliği TBDY 2018 yap; zemin sınıfı ZC, SS=1.2, S1=0.35.”
Kat	“Binanın üstüne 3 m yüksekliğinde bir kat ekle ve kat sayısını söyle.”
Modelleme	“1. katta (0,0)–(500,0) arasına 25 cm duvar çiz.” · “(0,0) noktasına 30×30 kolon koy.”
Temel	“Dış duvarların altına 80×40 sürekli temel çiz.”
Analiz	“Analizi çalıştır; bitince proje kontrol listesindeki uyarıları özetle.”
Sonuç	“Deprem özetini ver: periyotlar, taban kesme kuvveti, göreli kat ötelemeleri.”
Rapor	“Tüm raporları seçip oluştur; C:\Projeler\bina1.pdf olarak dışa aktar.”
Kayıt	“Projeyi C:\Projeler\bina1.sy4 olarak kaydet; dosya varsa üzerine yazmadan önce bana sor.”

Daha fazlası: Hazır istem örnekleri.

11. Dosya, resim ve ses

• Plan resmi: Dosya simgesiyle (Dosya Ekle) resmi seçin, ardından Dosyayı AI'a Gönder'e tıklayın. Resim incelenir; okunan ölçüler sohbete yazılır. Sonra “bu ölçülerle duvarları çiz” deyin. Asistan çizmeden önce ölçüleri size doğrulatmalıdır; okunamayan ölçüleri siz verin.
• En iyi sonuç için planı net bir PNG ya da JPG resim olarak gönderin. Elinizde PDF varsa sayfanın ekran görüntüsünü alıp resim olarak gönderin.
• Metin dosyası (.txt, .csv, .json, .md) içeriği doğrudan sohbete gönderilir (en çok 200 KB).
• DXF dosyası program içi asistana gönderilemez: içerik okunmaz ve mimari DXF dosyaları çoğunlukla bu sınırdan büyüktür. Mimari DXF plandan model kurdurmak için Claude Code ile DXF mimari plandan statik proje yolunu kullanın.
• Ses: Mikrofon simgesini (Bas-Konuş) basılı tutarak konuşun, bırakınca yazıya çevrilip gönderilir. Bu özellik OpenAI anahtarı ister.

12. Ne kadar tutar?

Program her mesajda asistana yaklaşık 30 KB'lık komut rehberini de gönderir. Bu yüzden ücret, yazdığınız mesajın uzunluğundan çok mesaj sayısına ve seçilen modele bağlıdır. Kabaca fikir vermesi için (Kasım 2026 fiyatlarıyla):

• Dengeli bir modelde (Claude Sonnet, GPT) basit bir istek genellikle birkaç sent tutar.
• Analiz başlatıp sonuçları okuyan çok adımlı bir istek, araya giren komut çağrıları nedeniyle 10–30 sent civarına çıkabilir.
• Ekonomik modeller (Claude Haiku, GPT mini, Gemini Flash) çok daha ucuzdur; deneme ve basit çizimler için yeterlidir.

ipucu

Harcamayı kontrol altında tutmak: Sağlayıcının sitesinde aylık harcama sınırı koyun; kullanım sayfasından günlük harcamanızı izleyin. İsteği tek mesajda, eksiksiz yazmak mesaj sayısını ve ücreti azaltır.

13. Asistanın sınırları

• Yalnız son birkaç soru-cevabı hatırlar. Konu değiştiğinde ya da uzun bir aradan sonra projenin durumunu yeniden sordurun.
• Seçme, taşıma, döndürme, geri alma ve diyalog pencerelerindeki ayarlar gibi bazı işlemler asistanla yapılamaz; bunları kendiniz yapın ya da Claude Code ile computer use kullanın.
• Analiz gibi uzun işler sürerken programı kullanmayın ve konsolu kapatmayın; yanıt işlem bitince gelir.
• Ekranda açık kalan bir uyarı penceresi (ör. “Proje değişti, kaydedilsin mi?”) komutları bekletir; pencereyi siz kapatın.
• Kesit, malzeme, yönetmelik ve deprem değerlerini asistan sizin onayınız olmadan değiştirmemelidir; sonuçları her zaman kendiniz kontrol edin.

14. Sorun giderme

Belirti	Neden ve çözüm
“API key yok” ya da “Seçili servis için API key bulunamadı”	Seçili servisin anahtarı girilmemiş. Servis listesinde anahtarını girdiğiniz servisi seçin (program açılışta OpenAI'yi seçer) ya da anahtarı API Key Ayarları'ndan girin. Güncellemeden sonra anahtarı yeniden girin.
“Model listesi alınamadı: 401”	Anahtar yanlış, eksik kopyalanmış ya da iptal edilmiş. Yeni anahtar oluşturup yeniden girin.
Kredi ya da bakiye hatası (ör. 402, “credit balance”)	Kredi bitmiş. Sağlayıcının Billing sayfasından kredi yükleyin.
“429” ya da “çok fazla istek”	Hız sınırı (özellikle Gemini ücretsiz katman). Bir dakika bekleyip yeniden deneyin.
“404” ya da model bulunamadı	Seçili model artık sunulmuyor. Modelleri Getir ile listeyi yenileyip başka bir model seçin.
“LLM yanıt süresi doldu”	Servis yanıt vermedi ya da internet kesildi. İsteği yeniden gönderin; sorun sürerse başka bir model seçin.
“licence not validated”	Program lisansı (kilit) doğrulanamadı. Kilidi takıp programı yeniden başlatın.
“Demo version can not export or print reports”	Demo kurulumda dışa aktarma kapalıdır; tam sürüm gerekir.
Asistan “yapamıyorum” diyor	İşin karşılığı olan bir program komutu olmayabilir. İşi kendiniz yapın ya da Claude Code + computer use kullanın.

15. Güvenlik

• API anahtarı kredi kartı bilgisi gibidir: kimseyle paylaşmayın, ekran görüntüsünde göstermeyin.
• Sızdığından şüphelenirseniz sağlayıcının API Keys sayfasından anahtarı silin (iptal edin) ve yenisini oluşturun.
• Asistanın gönderdiği komutlar projenizi değiştirir. Önemli işlerden önce projeyi farklı adla kaydedin.

Anthropic, OpenAI ve Google hizmetlerinin plan, fiyat ve menü adları zamanla değişebilir; güncel bilgi için bağlantı verilen resmi sayfalara bakın. Yapay zekânın kurduğu model ve ürettiği sonuçlar sorumlu mühendis tarafından kontrol edilmelidir.