Qwen modellerini uygulamanızda kullanmak için Alibaba Cloud Model Studio üzerinden API anahtarı alabilirsiniz. Rehber normal, kullanıma göre ücretlenen erişimi anlatır. Token Plan veya Coding Plan kullanıyorsanız plana özel anahtar ve adres farklıdır; ikisini karıştırmayın. Başlangıçta üç bilgiyi birlikte kontrol edeceksiniz: seçtiğiniz bölge, çalışma alanı ve o alanın API adresi.
Anahtarın oluşması bütün model çağrılarının ücretsiz olduğu anlamına gelmez. Model fiyatını, hesabınızın kampanya/kota koşullarını ve ücretlendirme durumunu kontrol edin. Cost and Usage bölümündeki maliyet görünümü tüketimi incelemenize yardımcı olur; bilgiler gecikmeli oluşabilir. Bütçe uyarısını kesin harcama kesici gibi değerlendirmeyin. Bir planınız varsa kapsamını kontrol edin; kapsam dışı işlemler farklı ücretlenebilir.
Resmî Model Studio konsolunu açın. Alibaba Cloud hesabınızla giriş yapın; hesabınız yoksa kayıt ve doğrulamayı tamamlayın. İstenen hesap bilgilerinizi doğru girin. Qwen sohbet sayfasında mesaj yazabilmeniz, bu konsoldaki API ayarlarının tamamlandığını göstermez.
İlk girişte hizmet koşulları veya etkinleştirme ekranı görünürse metni okuyarak kendiniz karar verin. Bu ekran çıkmıyorsa hizmet daha önce etkinleştirilmiş olabilir. Amaç, anahtar oluşturma sayfasına ulaşabilmektir; ihtiyacınız olmayan ek bir planı otomatik olarak satın almak değildir.
Konsolun bölge seçimini kontrol edin. Anahtarlar, modeller ve bağlantı adresleri bölgeye göre ayrılır. Rehberdeki doğrudan anahtar bağlantısı Singapore bölgesine gider; kendi kullanımınız için başka bölge seçerseniz o bölgenin adreslerini kullanın. Anahtarı bir bölgede oluşturup başka bölgenin adresine göndermeyin.
3 Kasım 2026 tarihinde Model Studio’nun giriş öncesi anahtar sayfasından alınan gerçek ekran. Kaynak: resmî ekran veya belge. Görseli büyütmek için üzerine dokunabilirsiniz.
Workspace, yani çalışma alanı, kaynak ve erişimlerin ayrıldığı yerdir. Kişisel başlangıçta konsolda size sunulan varsayılan alanı kontrol edin. Bir şirkete veya ekibe bağlıysanız yöneticinizin belirlediği alanı kullanın. Anahtarın yetkileriyle deneyeceğiniz modelin aynı bağlama ait olmasına dikkat edin.
API Key bölümünde yeni anahtar oluşturma işlemini başlatın. Oluşturma düğmesi görünmüyorsa veya kullanılamıyorsa hesabınızın bu sayfaya ait yetkisi bulunmayabilir. Başka birinin anahtarını istemek yerine çalışma alanı yöneticisinden kendi hesabınıza uygun erişim verilmesini isteyin.
Çalışma alanını seçin; açıklama alanı varsa Kisisel Qwen Denemesi gibi tanıyacağınız kısa bir ad yazın. Özel izin seçiyorsanız kullanacağınız modelin erişim kapsamına alındığını kontrol edin. IP sınırı ekliyorsanız uygulamanızın dışarıya hangi IP ile bağlandığını bilmeniz gerekir; rastgele değer girmeyin.
Oluşturma sonucunda gösterilen tam anahtarı ve varsa API Host bilgisini güvenli biçimde kaydedin. Güncel normal anahtarların tam değeri oluşturma sonrasında tekrar gösterilmeyebilir. API Host, uygulamanızın bağlanacağı hizmet adresini anlamanıza yardım eder; anahtarın gizlenmiş liste görünümünü tam değer yerine kullanmayın.
Uygulamada Alibaba Cloud, DashScope veya Qwen sağlayıcısı varsa o seçeneği inceleyin. Özel OpenAI uyumlu bağlantı kullanıyorsanız seçtiğiniz bölge ve çalışma alanı için resmî belgede verilen uyumlu adresi kopyalayın. API Host'a tahmin ederek yol eklemeyin; Anthropic uyumlu adresle OpenAI uyumlu adres aynı değildir.
Model listesinden hesabınıza ve bölgenize açık bir Qwen modelinin API adını alın. Anahtar oluştururken model seçilmemesi, her modele otomatik erişeceğiniz anlamına gelmez. Ayarları kaydedip tek cümlelik bir selam isteyin; ilk denemeye uzun dosyalar eklemeyin.
Yanıt aldıktan sonra konsoldaki kullanım ve maliyet bölümüne dönün. Yeni kullanımın görünmesi biraz zaman alabilir. Yardım gerektiğinde anahtarı gizleyip bölgeyi, bağlantı türünü ve hata kodunu paylaşın. Anahtarınızın açığa çıktığından şüpheleniyorsanız eski anahtarı hemen iptal edin. Ardından yeni bir anahtar oluşturup uygulamanın güvenli alanına kaydedin ve kısa bir test yapın.
Kullanacağınız uygulamanın Ayarlar, Bağlantılar veya Yapay zekâ sağlayıcıları bölümünü açın. Anahtarı herkese açık bir mesaj kutusuna değil, uygulamanın bu iş için ayırdığı gizli bağlantı alanına girin. Alanların anlamı şöyledir:
401 veya InvalidApiKey hatası alıyorum.
Anahtarın tam kopyalandığını; bölge, çalışma alanı ve Base URL ile eşleştiğini kontrol edin. Plana özel anahtarın normal bağlantı adresiyle kullanılması da hataya yol açabilir.
403, AccessDenied veya çalışma alanı erişim hatası var.
Hizmet etkinliğini, hesabın ilgili çalışma alanına üyeliğini, model iznini ve hata mesajında belirtilen hesap durumunu kontrol edin. Borç/bakiye mesajını izin hatasıyla aynı kabul etmeyin.
404 veya model bulunamadı deniyor.
Model kimliğini, seçili bölgeyi ve bağlantı yolunu yeniden karşılaştırın. Başka bir bölgenin model adı veya yanlış protokol adresi kullanılmış olabilir; tekrar göndermek yanlış ayarı düzeltmez.
429 çıkıyor; hemen bakiye mi yüklemeliyim?
Önce tam hata mesajını okuyun. Hız sınırı, token sınırı veya tükenen kota farklı nedenlerdir. Hız sınırında istekleri azaltın; kota veya ödeme sorunu belirtiliyorsa ilgili hesabı ayrıca inceleyin.
Bilgi ve ekran kontrol tarihi: 3 Kasım 2026. Menü yerleşimi, hesap uygunluğu, model listesi ve ücretler değişebilir; işlem sırasında hesabınızda gösterilen güncel koşulları okuyun. Bu konudaki görsellerde kullanılabilir gizli API anahtarı bulunmaz.
Başlamak için açacağınız adresler
Önce ücret ve kullanım hakkını anlayın
Anahtarın oluşması bütün model çağrılarının ücretsiz olduğu anlamına gelmez. Model fiyatını, hesabınızın kampanya/kota koşullarını ve ücretlendirme durumunu kontrol edin. Cost and Usage bölümündeki maliyet görünümü tüketimi incelemenize yardımcı olur; bilgiler gecikmeli oluşabilir. Bütçe uyarısını kesin harcama kesici gibi değerlendirmeyin. Bir planınız varsa kapsamını kontrol edin; kapsam dışı işlemler farklı ücretlenebilir.
Adım adım API anahtarını alma
1. Alibaba Cloud hesabınızla başlayın
Resmî Model Studio konsolunu açın. Alibaba Cloud hesabınızla giriş yapın; hesabınız yoksa kayıt ve doğrulamayı tamamlayın. İstenen hesap bilgilerinizi doğru girin. Qwen sohbet sayfasında mesaj yazabilmeniz, bu konsoldaki API ayarlarının tamamlandığını göstermez.
2. Model Studio hizmetini etkinleştirin
İlk girişte hizmet koşulları veya etkinleştirme ekranı görünürse metni okuyarak kendiniz karar verin. Bu ekran çıkmıyorsa hizmet daha önce etkinleştirilmiş olabilir. Amaç, anahtar oluşturma sayfasına ulaşabilmektir; ihtiyacınız olmayan ek bir planı otomatik olarak satın almak değildir.
3. Kullanacağınız bölgeyi belirleyin
Konsolun bölge seçimini kontrol edin. Anahtarlar, modeller ve bağlantı adresleri bölgeye göre ayrılır. Rehberdeki doğrudan anahtar bağlantısı Singapore bölgesine gider; kendi kullanımınız için başka bölge seçerseniz o bölgenin adreslerini kullanın. Anahtarı bir bölgede oluşturup başka bölgenin adresine göndermeyin.
Gerçek Model Studio portalı
3 Kasım 2026 tarihinde Model Studio’nun giriş öncesi anahtar sayfasından alınan gerçek ekran. Kaynak: resmî ekran veya belge. Görseli büyütmek için üzerine dokunabilirsiniz.
- 1: Bölge seçimi. Bu örnekte Singapore seçili; anahtar ve API adresi aynı bölgeyle eşleşmelidir.
- 2: API Key menüsü.
- 3: Hesabınıza giriş yaparak sayfaya devam etme düğmesi.
4. Çalışma alanını kontrol edin
Workspace, yani çalışma alanı, kaynak ve erişimlerin ayrıldığı yerdir. Kişisel başlangıçta konsolda size sunulan varsayılan alanı kontrol edin. Bir şirkete veya ekibe bağlıysanız yöneticinizin belirlediği alanı kullanın. Anahtarın yetkileriyle deneyeceğiniz modelin aynı bağlama ait olmasına dikkat edin.
5. API anahtarı oluşturma sayfasını açın
API Key bölümünde yeni anahtar oluşturma işlemini başlatın. Oluşturma düğmesi görünmüyorsa veya kullanılamıyorsa hesabınızın bu sayfaya ait yetkisi bulunmayabilir. Başka birinin anahtarını istemek yerine çalışma alanı yöneticisinden kendi hesabınıza uygun erişim verilmesini isteyin.
6. Açıklama ve erişimi ayarlayın
Çalışma alanını seçin; açıklama alanı varsa Kisisel Qwen Denemesi gibi tanıyacağınız kısa bir ad yazın. Özel izin seçiyorsanız kullanacağınız modelin erişim kapsamına alındığını kontrol edin. IP sınırı ekliyorsanız uygulamanızın dışarıya hangi IP ile bağlandığını bilmeniz gerekir; rastgele değer girmeyin.
7. Anahtar ile API adresini birlikte kaydedin
Oluşturma sonucunda gösterilen tam anahtarı ve varsa API Host bilgisini güvenli biçimde kaydedin. Güncel normal anahtarların tam değeri oluşturma sonrasında tekrar gösterilmeyebilir. API Host, uygulamanızın bağlanacağı hizmet adresini anlamanıza yardım eder; anahtarın gizlenmiş liste görünümünü tam değer yerine kullanmayın.
8. Uygulamanızın istediği bağlantı biçimini seçin
Uygulamada Alibaba Cloud, DashScope veya Qwen sağlayıcısı varsa o seçeneği inceleyin. Özel OpenAI uyumlu bağlantı kullanıyorsanız seçtiğiniz bölge ve çalışma alanı için resmî belgede verilen uyumlu adresi kopyalayın. API Host'a tahmin ederek yol eklemeyin; Anthropic uyumlu adresle OpenAI uyumlu adres aynı değildir.
9. Güncel bir modelle kısa test yapın
Model listesinden hesabınıza ve bölgenize açık bir Qwen modelinin API adını alın. Anahtar oluştururken model seçilmemesi, her modele otomatik erişeceğiniz anlamına gelmez. Ayarları kaydedip tek cümlelik bir selam isteyin; ilk denemeye uzun dosyalar eklemeyin.
10. Sonucu ve maliyeti inceleyin
Yanıt aldıktan sonra konsoldaki kullanım ve maliyet bölümüne dönün. Yeni kullanımın görünmesi biraz zaman alabilir. Yardım gerektiğinde anahtarı gizleyip bölgeyi, bağlantı türünü ve hata kodunu paylaşın. Anahtarınızın açığa çıktığından şüpheleniyorsanız eski anahtarı hemen iptal edin. Ardından yeni bir anahtar oluşturup uygulamanın güvenli alanına kaydedin ve kısa bir test yapın.
Aldığım anahtarı uygulamaya nereye yazacağım?
Kullanacağınız uygulamanın Ayarlar, Bağlantılar veya Yapay zekâ sağlayıcıları bölümünü açın. Anahtarı herkese açık bir mesaj kutusuna değil, uygulamanın bu iş için ayırdığı gizli bağlantı alanına girin. Alanların anlamı şöyledir:
- Sağlayıcı: Alibaba Cloud Model Studio / DashScope / Qwen. İsim uygulamaya göre değişebilir; hangi API biçimini desteklediğini inceleyin.
- API anahtarı: Seçtiğiniz bölge ve çalışma alanında oluşturduğunuz tam gizli değer. Normal Model Studio anahtarıyla Token Plan/Coding Plan anahtarını karıştırmayın.
- Base URL / API Host: Kendi bölge ve çalışma alanınız için konsolda veya resmî belgede verilen adres. Tek bir adres bütün bölgeler için doğru değildir. Uygulama OpenAI uyumluysa o protokolün tam Base URL değerini kullanın.
- Model: Bölgenizdeki güncel Qwen API model kimliği. Belgelerde çağrı için verilen model adını kullanın.
Sık karşılaşılan sorunlar ve çözümleri
401 veya InvalidApiKey hatası alıyorum.
Anahtarın tam kopyalandığını; bölge, çalışma alanı ve Base URL ile eşleştiğini kontrol edin. Plana özel anahtarın normal bağlantı adresiyle kullanılması da hataya yol açabilir.
403, AccessDenied veya çalışma alanı erişim hatası var.
Hizmet etkinliğini, hesabın ilgili çalışma alanına üyeliğini, model iznini ve hata mesajında belirtilen hesap durumunu kontrol edin. Borç/bakiye mesajını izin hatasıyla aynı kabul etmeyin.
404 veya model bulunamadı deniyor.
Model kimliğini, seçili bölgeyi ve bağlantı yolunu yeniden karşılaştırın. Başka bir bölgenin model adı veya yanlış protokol adresi kullanılmış olabilir; tekrar göndermek yanlış ayarı düzeltmez.
429 çıkıyor; hemen bakiye mi yüklemeliyim?
Önce tam hata mesajını okuyun. Hız sınırı, token sınırı veya tükenen kota farklı nedenlerdir. Hız sınırında istekleri azaltın; kota veya ödeme sorunu belirtiliyorsa ilgili hesabı ayrıca inceleyin.
Resmî kaynaklar
- Model Studio: API anahtarı edinme
- Model Studio: Qwen ile ilk API çağrısı
- Model Studio: Bölgeler ve hizmet adresleri
- Model Studio: Fatura ve maliyet yönetimi
- Model Studio: Hata kodları
Bilgi ve ekran kontrol tarihi: 3 Kasım 2026. Menü yerleşimi, hesap uygunluğu, model listesi ve ücretler değişebilir; işlem sırasında hesabınızda gösterilen güncel koşulları okuyun. Bu konudaki görsellerde kullanılabilir gizli API anahtarı bulunmaz.
