VS Code'u açmadan önce ihtiyacınız olanlar
VS Code için bir qwen api anahtarı, bir API anahtarı ve bir uzantıdaki doğru uç nokta ayarlarından ibarettir. Önce bu üç değeri toplayın:
- Temel URL:
https://api.uncensoredqwen.com/v1 - model kimliği:
uncensored - API anahtarı: Google veya e-posta ve şifre ile kayıt olduktan sonra API anahtarı sayfasında oluşturulur
Yeni hesaplar, bu sayfada tek tıkla $0,50 deneme kredisi talep edebilir. Kart girişi gerekmez, kişi başı bir kezle sınırlıdır ve 7 gün boyunca geçerlidir. Bu, birkaç günlük gerçek kodlama için editör kurulumunu test etmek için yeterlidir.
Adlandırma hakkında bir not: hizmet, bağımsız bir sağlayıcı tarafından barındırılan açık ağırlıklı bir modeldir. Alibaba'nın resmi API'si değildir ve diğer satıcılara bir yönlendirici değildir. Editörünüzde, ona verdiğiniz görüntüleme adına göre görünür.
Anahtarı önce curl ile test edin
Herhangi bir editör ayarını değiştirmeden önce, anahtarın ve URL'nin kendi başlarına çalıştığını doğrulayın. Bu başarısız olursa, hiçbir uzantı başarılı olmaz ve sorunun eklenti değil anahtar olduğunu bilirsiniz.
export API_KEY="paste-your-key-here"
curl https://api.uncensoredqwen.com/v1/models \
-H "Authorization: Bearer $API_KEY"
uncensored içeren bir JSON listesi kimlik doğrulamanın çalıştığını gösterir. Ardından gerçek bir tamamlama isteği gönderin:
curl https://api.uncensoredqwen.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python function that reverses a string."}],"max_tokens":200}'
Yanıt başlıkları, kalan krediyi terminalden ayrılmadan görmek için hızlı bir yol olan X-Balance-USD başlığını içerir.
Bir VS Code uzantısında sağlayıcıyı ekleyin
Yapay zeka kodlama yardımı için birkaç VS Code uzantısı, herhangi bir OpenAI uyumlu sunucuyla iletişim kurabilir. Etiketler araçtan araca biraz farklılık gösterir ancak alanlar birebir eşleşir. "OpenAI Compatible", "OpenAI" (özelleştirilmiş temel URL ile) veya "Özel uç nokta" gibi bir sağlayıcı seçeneği arayın.
| Uzantı alanı | Girilecek değer |
|---|---|
| Sağlayıcı | OpenAI uyumlu (veya özel temel URL ile OpenAI) |
| Temel URL / API temel | https://api.uncensoredqwen.com/v1 |
| API anahtarı | Hesabınızdaki anahtar |
| Model kimliği | uncensored |
JSON yapılandırma dosyası okuyan uzantılar genellikle bu şekilde bir şey ister. Tam anahtar adları değişebilir, bu nedenle uzantınızın belgelerine bakın ve alan adlarını buna göre uyarlayın:
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.uncensoredqwen.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
Bu dosyayı commit etmeyin. Ayarlarınız bir depoda bulunuyorsa, uzantının gizli depolamasını veya bir ortam değişkenini kullanın ve yapılandırma yolunu .gitignore dosyasına ekleyin.
Kaydettikten sonra, uzantının sohbet panelini açın ve bir dosya açıkken "Bu fonksiyonu açıkla" gibi kısa bir mesaj gönderin. Akışlı bir yanıt, kurulumun tamamlandığını gösterir.
Yaygın yapılandırma hatalarını düzeltin
Başarısız kurulumların çoğu birkaç yazım hatasına dayanır. Bu listeyi sırayla kontrol edin.
URL yanlış yapıda
Temel URL /v1 ile sonlanır. Uzantılar /chat/completions'i kendileri ekler. Tam yolu yapıştırırsanız, istemci /v1/chat/completions/chat/completions isteği yaptığı için 404 alırsınız. Sonunda / karakteri olması genellikle zararsızdır, ancak eksik /v1 sorun yaratır.
Model adı yanlış
Bazı uzantılar, başka bir hizmetten isimler alarak bir model açılır listesini önceden doldurur. Bunu tam olarak küçük harfle uncensored ile geçersiz kılın. Alan, özel giriş içermeyen bir açılır liste ise "custom model" veya "other" seçeneğini arayın.
Anahtar gereksiz karakterler içeriyor
Bir web sayfasından kopyalama, sonuna boşluk veya yeni satır ekleyebilir. Düz metin editörüne yapıştırın, temizleyin ve tekrar yapıştırın. 401 yanıtı neredeyse her zaman buna veya farklı bir hesaba ait bir anahtara işaret eder.
Uzantı hala varsayılan sunucusuyla konuşuyor
Sohbet isteklerinden sonra bakiyeniz değişmiyorsa, editör yerleşik bir sağlayıcı kullanıyor olabilir. Düzenlediğiniz aktif model profilinin doğru olduğundan emin olun ve ayarları değiştirdikten sonra pencereyi yeniden yükleyin.
İstekler 429 hatası ile başarısız olur
Bu bir hız limitidir, bir sonraki bölümde ele alınmıştır. Hata gövdesi, hangi limite ulaştığınızı söyleyen bir kod içerir.
İsteklerin gerçekten API'ye ulaştığını doğrulayın
Editörler hangi sunucunun yanıt verdiğini nadiren söyler. Şüpheyi gidermek için iki hızlı kontrol yapın.
- Bakiyeyi izleyin. Terminalden
/v1/modelsveya kısa bir tamamlama çağrısı çalıştırın,X-Balance-USDbaşlığını not edin, editörde üç sohbet mesajı gönderin, ardından terminal çağrısını tekrar yapın. Sayı küçük bir miktar düşmelidir. Aynı rakamGET /v1/balanceüzerinden de mevcuttur. - Varsayılan kurulumun reddedeceği veya farklı şekilde ele alacağı bir şey isteyin. Küçük, zararsız bir test olarak, tam olarak beş kelimelik bir yanıt isteyin. Yanıt talimatı takip ederse ve akışlı olarak gelirse, bağlantı sağlıklıdır.
Bakiye değişmiyorsa, uzantının çıktı panelini veya geliştirici konsolunu açın. Çoğu uzantı istek URL'sini ve HTTP durumunu günlüğe kaydeder ve yanlış bir ana bilgisayar hemen görünür. Base URL'yi düzeltin, pencereyi yeniden yükleyin ve tekrar deneyin.
Bir depoyu paylaşan ekipler, tek bir paylaşılan değer yerine her kişiye ayrı bir anahtar vermelidir. Bu şekilde, bir kişinin yaşadığı bir hız limiti diğerlerini engellemez ve sızan bir anahtar, diğerlerini rahatsız etmeden değiştirilebilir.
Otomatik tamamlama, sohbet ve hız limitleri
Sohbet limitlere naziktir: mesaj başına bir istek. Satır içi otomatik tamamlama farklıdır. Uzantıların çoğu, yazarken kısa bir duraklamada bir istek gönderir; bu, çalışırken dakikada düzinelerce çağrı üretebilir.
Sayıları bilin. Tam anahtar 8 eşzamanlı istek ve dakika başına 300 istek izin verir. Deneme anahtarı 2 eşzamanlı ve dakika başına 60 izin verir. Bunları aştığınızda API HTTP 429 ve rate_limited (dakikada çok fazla) veya concurrency (aynı anda çok fazla) koduyla yanıt verir. Geçici aşırı yüklenmede ayrıca Retry-After: 5 başlığıyla 429 alırsınız. Akışlı bir tamamlama, akış bitene kadar eşzamanlılık slotunu korur, bu nedenle yavaş akışlar sizi daha uzun süre etkiler.
Yararlı pratik ayarlar:
- Hizmeti sohbet, düzenlemeler ve açıklamalar için kullanın ve deneme anahtarıyken tab otomatik tamamlamayı kapatın veya gecikme süresini artırın.
- Otomatik tamamlama için maksimum çıktı token sayısını birkaç düzineye düşürün. Kısa tamamlamalar hızlıca biter ve slotu serbest bırakır.
- Deneme sırasında aynı anahtar için birden fazla editör penceresi çalıştırmaktan kaçının.
Başarısız veya reddedilen istekler için ücret alınmaz, bu nedenle hataların bir maliyeti yoktur, yalnızca zaman harcanır.
Bir kodlama oturumunun maliyeti
Kodlama istemleri, uzantılar dosya içeriklerini eklediği için yüksek giriş yoğunluğu gerektirir. Fiyatlandırma 1M input token başına $0,15 ve 1M output token başına $0,50'dir. 6.000 token kod ve bağlam gönderip 800 token alan bir sohbet dönüşünü düşünün:
- Girdi: 6.000 x $0,15 / 1.000.000 = $0,0009
- Çıktı: 800 x $0,50 / 1.000.000 = $0,0004
- Toplam: Tur başına $0,0013
Bir çalışma gününde 100 böyle sohbet dönüşü $0,13'e mal olur. $0,50'lik deneme kredisi bu boyuttaki yaklaşık 380 dönüşü karşılar ($0,50 / $0,0013 yaklaşık 385 eder). Kredi ön ödemelidir, süresi dolmaz ve bakiye yüklemeler $20 ile $500 arasında tam tutarlardır; $50'den itibaren %5, $100'den itibaren %10 ve $200'den itibaren %15 bonus sağlanır. Ödeme yöntemleri için fiyatlandırma sayfasına bakın.
Bağlam penceresi 100.000 token'dır (istem ve tamamlama birlikte). Bir uzantı tüm deponuzu her isteme indekslerse, büyük istekler daha pahalıya mal olur ve bu tavana yaklaşır. Bağlamı yalnızca gerçekten ihtiyacınız olan dosyalarla sınırlayın.
Gizlilik ve daha fazla bilgi
İstemler eğitim için kullanılmaz. Yine de kaynak kod genellikle gizli anahtarlar içerir, bu nedenle sohbetinize eklediğiniz dosyalardan .env dosyalarını ve kimlik bilgilerini çıkarın. Çoğu uzantı, yolları bağlam penceresinden hariç tutmanıza olanak tanır.
Model yalnızca metin desteği sunar. Kodlama sorularını yanıtlar, fonksiyon taslağı oluşturur, hataları açıklar ve fonksiyon çağırma ile JSON modunu destekler; ancak görsel, ses veya video üretmez. Bu sayfadaki istek alanları ve örnekler için API belgelerine bakın. Yukarıdaki kontrollerden sonra hala bir hata alıyorsanız, yaygın Qwen API hataları hakkındaki önceki makale, daha fazla hata deseni ve çözümler listeler.
