API Anahtarlarıyla Kodlama

Bir Coderen API anahtarıyla OpenAI uyumlu bir API ile çalışan geliştirme araçlarını kullanabilirsiniz. Araç, istekleri AI-School’a gönderir. AI-School anahtarı, bütçeyi, geçerlilik süresini ve izin verilen modelleri kontrol eder.

Daha sonra AI-School, isteği ortamın teknik bağlantısı üzerinden işler.

Ne gerekiyor?

Üç bilgiye ihtiyacınız var:

Bilgi	Bunu Nereden Bulursun?
API anahtarı	Bir yönetici veya öğretmenden alırsınız
Uç Nokta (Endpoint)	https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Model adı	Örneğin gpt-5.4-mini, gpt-5.4 veya gpt-5.5

API anahtarı ais. ile başlar. Bu anahtarı bir şifre gibi ele alın.

Hangi modeli seçmelisiniz?

Çoğu öğrencinin başlamak için en iyi seçenek GPT-5.4 minidır. Bu model daha ucuzdur ve derste programlama yardımı için uygundur.

Öğretmenler veya deneyimli öğrenciler için GPT-5.4 veya GPT-5.5 daha uygun olabilir; özellikle daha büyük projeler veya daha karmaşık kodlar için.

Hangi aracı seçmelisiniz?

AI-School iki araç önerir:

Araç	İçin Tavsiye	Neden
Aider	Öğrenciler ve sınıf çapında kodlama	Açıkça çalışır, net görünür ve daha az ajantrik
OpenCode	Öğretmenler ve deneyimli kullanıcılar	Ajantrik CLI aracı ayrıca masaüstü uygulaması da mevcut

Öğrenciler için Aider

Aider, terminalde eşli-programlama aracı olarak çalışır. Kullanıcı yardım ister, değişiklikleri görür ve koda yakın kalır. Bu, programlama öğrenimine iyi uyar: öğrenci destek alır ama olan bitenlerle kendisi de ilgili kalır.

Resmi Aider belgelerine bakınız: officiële Aider-documentatie.

Deneyimli kullanım için OpenCode

OpenCode daha ajantriktir. Araç bağımsız adımlar gerçekleştirebilir, dosyaları düzenleyebilir ve görevleri daha da geliştirebilir. Bu güçlüdür, fakat kod, Git ve yerel geliştirme ortamları hakkında daha fazla anlayış gerektirir.

Resmi OpenCode belgelerine bakınız: officiële OpenCode-documentatie.

Anahtarlarla güvenli çalışma

API anahtarınızı kamuya açık paylaşmayın ve paylaştığınız kodda saklamayın.

Tercih edilen kullanımlar:

• ortam değişkenleri
• Git’e gönderilmeyen yerel bir .env
• aracın yerleşik konfigürasyonu

OpenCode için örnek olarak proje klasöründe bir .env kullanabilirsiniz:

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

Aletin bu .env dosyasını gerçekten yüklediğinden emin olun. PowerShell’de değişkeni geçici olarak mevcut terminal için de ayarlayabilirsiniz:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

Dikkat

API anahtarlarını hiçbir zaman halka açık bir depo, Teams sohbeti, paylaşılan belgeler veya ekran görüntülerine koymayın.

Anahtar çalışmıyorsa

Aşağıdakileri kontrol edin:

• Coderen ortam için etkinleştirilmiş mi?
• Anahtarınız hâlâ etkin mi?
• Bütçe doldu mu?
• Anahtar geçerlilik süresi içinde mi?
• İzin verilen bir model kullanıyor musunuz?
• Uç nokta doğru yapılandırılmış mı?
• Aracı API anahtarını Authorization: Bearer ... olarak iletiyor mu?
• Araç, AI-School Coderen tarafından desteklenmeyen sağlayıcıya özgü parametreler iletiyor mu?

Şüphe durumunda bir yöneticiye veya öğretmene anahtarı kontrol ettirmek için başvurun.