Wiozen API

Yapay zekâ API'si "401 Invalid API key" hatası veriyor: anahtarım neden kabul edilmiyor?

Kısaca: 401, isteğin içinde kullanılabilir bir anahtar bulunamadığı demektir. Wiozen API bunu iki mesajla söyler: Missing API key isteğe hiç anahtar ulaşmadığında, Invalid API key ise gelen anahtar hesaplardaki etkin bir anahtarla eşleşmediğinde döner. İkincisinin en sık sebebi anahtarın eksik kopyalanması ya da iptal edilmiş olması. Anahtarın çalışıp çalışmadığını GET /v1/balance isteğiyle para harcamadan deneyebilirsin.

"Missing API key" ile "Invalid API key" farkı

Wiozen anahtarı önce Authorization: Bearer sk-gw-… başlığında arar. Orada yoksa sırayla x-api-key, api-key ve x-auth-token başlıklarına bakar. Hiçbirinde anahtar bulamazsa cevap 401 Missing API key olur. Bir anahtar bulup onu hiçbir etkin anahtarla eşleştiremezse 401 Invalid API key olur.

Hata gövdesi isteğin biçimine göre değişir. OpenAI biçimindeki uçlarda:

401
{"error":{"message":"Invalid API key","type":"invalid_request_error"}}

Anthropic biçimindeki /v1/messages uçlarında hata türü authentication_error olur:

401
{"type":"error","error":{"type":"authentication_error","message":"Invalid API key"}}

"Missing API key" alıyorsam neye bakmalıyım?

  • Bearer sözcüğü. Authorization başlığının değeri Bearer ile başlamalı. Authorization: sk-gw-… diye yalnız anahtarı yazarsan Wiozen o başlığı okumaz ve anahtar yok sayılır.
  • Boş değişken. Kodun anahtarı bir ortam değişkeninden okuyorsa ve değişken programı çalıştırdığın terminalde tanımlı değilse başlık boş gider. Değişkeni başka bir pencerede ya da başka bir kullanıcıyla tanımlamış olabilirsin.
  • Başlık adı. Kabul edilen adlar yukarıdaki dört başlık. X-Api-Token gibi başka bir ad okunmaz.

Bir araç bağlantıyı "başarılı" gösterip asıl isteklerde bu hatayı alıyorsa sebep çoğunlukla şudur: GET /v1/models model listesini anahtarsız da döner. Bağlantı testini bu uçla yapan bir araç, anahtarı hiç göndermese bile listeyi alır. Anahtar gönderilmişse aynı uç anahtarı denetler ve yanlışsa 401 verir.

"Invalid API key" alıyorsam neye bakmalıyım?

  • Anahtarın tamamı mı? Wiozen anahtarları sk-gw- ile başlar ve bunun ardından uzun bir dizi gelir. Anahtarlar sayfasındaki Önek sütunu yalnız ilk 12 karakteri gösterir; oradan kopyalanan metin bir anahtar değildir.
  • Anahtar iptal edildi ya da silindi mi? İptal edilen anahtar listede "iptal" durumunda görünür, silinen anahtar listeden kalkar. İkisi de bir daha çalışmaz.
  • Doğru servisin anahtarı mı? Başka bir yapay zekâ servisinin anahtarı Wiozen'de çalışmaz; Wiozen anahtarı da başka bir serviste çalışmaz. Araçta hem adresi hem anahtarı aynı servise ayarladığından emin ol.
  • İki başlık birden mi gidiyor? Hem Authorization hem x-api-key gönderiliyorsa Wiozen Authorization'daki anahtarı okur. Orada eski bir anahtar kaldıysa öbür başlıktaki doğru anahtar hiç denenmez.
  • Araya karakter girdi mi? Anahtarın başındaki ve sonundaki boşluklar ile anahtarı saran tırnaklar temizlenir. Anahtarın ortasına giren bir boşluk ya da satır sonu temizlenmez ve anahtarı bozar.

Anahtarı denemenin en kısa yolu bakiye isteğidir. Model çağırmaz ve ücretlenmez; anahtar doğruysa bakiyeyi döner, değilse aynı 401 mesajını verir:

terminal
curl https://api.wiozen.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

Bu ucun ayrıntısı bakiyeyi koddan sorgulama rehberinde.

Anahtarımı kaybettim, yeniden gösterilebilir mi?

Hayır. Anahtarın tamamı yalnız oluşturulduğu anda bir kez gösterilir. Wiozen anahtarın kendisini değil, ondan hesaplanan bir özetini saklar; özetten anahtar geri çıkarılamaz. Destek ekibi de anahtarını göremez.

Kaybettiysen Anahtarlar sayfasından yeni bir anahtar oluştur, kullandığın araçlara onu gir ve eskisini iptal et. Anahtarın başkasının eline geçtiğinden şüpheleniyorsan sıra farklı: önce iptal et, sonra harcamaya bak. Adımlar sızan anahtar rehberinde.

WordPress eklentisinde "API anahtarı kabul edilmedi"

İçerik Botu bu uyarıyı Wiozen'den 401 aldığında gösterir; panelin üstündeki bant da "Hesaba bağlanılamadı" der. En sık sebebi, sitenin anahtarının Anahtarlar sayfasında iptal edilmiş ya da silinmiş olması; örneğin eski WordPress: alan-adı satırlarını temizlerken sitenin kullandığı en yenisi de gitmiş olabilir. Bantta önce Bağlantıyı kes'e, sonra yerine gelen Hesaba bağlan'a bas; site yeni bir anahtarla bağlanır. Bağlanırken çıkan hatalar bağlantı hataları rehberinde, uyarının panelde nasıl göründüğü yazı üretemiyor rehberinde.

401'e benzeyen ama 401 olmayan hatalar

Kod ve mesajAnlamıNe yapmalı
403 Account is not activeAnahtar doğru, ama hesap askıdaDestek üzerinden bize yaz
429 Quota exhaustedAnahtar doğru, bakiye yetmiyorBakiye yükle
429 API key spend limit reachedAnahtar doğru, harcama limiti dolduAnahtarlar sayfasında limiti yükselt ya da kaldır

Bu üçünde anahtar kabul edilmiştir; anahtarı değiştirmek sorunu çözmez. 429'un diğer sebepleri 429 rehberinde.

Sık sorulan sorular

"Missing API key" ne demek?
İstekte Wiozen'in okuduğu başlıklarda (Authorization: Bearer, x-api-key, api-key, x-auth-token) hiç anahtar yok. Çoğunlukla Bearer sözcüğü eksiktir ya da anahtarı tutan değişken boştur.
"Invalid API key" ne demek?
Bir anahtar geldi ama etkin bir anahtarla eşleşmedi: eksik kopyalanmış, iptal edilmiş, silinmiş ya da başka bir servise ait olabilir.
Anahtarımı para harcamadan nasıl denerim?
GET /v1/balance isteğini anahtarla gönder. Model çağırmaz, ücretlenmez; doğru anahtarda bakiyeyi döner.
Kaybettiğim anahtarı geri alabilir miyim?
Hayır. Anahtarın tamamı yalnız oluşturulduğunda gösterilir ve sistemde yalnız özeti saklanır. Yeni bir anahtar oluşturup eskisini iptal et.
Bakiyem bitince 401 mi alırım?
Hayır. Biten bakiye 429 Quota exhausted döner. 401 yalnız anahtar eksik ya da geçersiz olduğunda gelir.

Anahtarlar sayfasında yeni bir anahtar oluştur ve yukarıdaki bakiye isteğiyle dene. Bütün hata kodları belgelerde.

Hesabını aç

Diğer rehberler: Türkiye'den kredi kartı olmadan yapay zekâ API'si nasıl kullanılır? · OpenAI uyumlu bir API mevcut bir araca nasıl bağlanır? · Yapay zekâ API maliyeti nasıl hesaplanır? · Yapay zekâ API anahtarım sızdıysa ne yapmalıyım? · Yapay zekâ API'siyle görsel nasıl üretilir ve görsel başı maliyeti ne kadar? · Ses dosyasını yazıya çeviren API'nin dakikası kaç dolar, ücret nasıl hesaplanıyor? · Yapay zekâ API'si neden 429 hatası veriyor, nasıl düzeltilir? · Uzun yanıt bekleyen API isteği neden zaman aşımına düşer: akışlı mı, akışsız mı? · Anthropic Messages API mı, OpenAI Chat Completions mı: hangisini kullanmalıyım? · Bağlam penceresi (context window) nedir, 1 milyon token ne işe yarar? · Hangi yapay zekâ modelini seçmeliyim: fiyat, bağlam ve kaliteye göre karar · Düşünen (reasoning) model neden boş cevap döner, düşünme tokenları neden ücretlenir? · API bakiyem neden beklediğimden hızlı bitiyor? Harcamayı istek istek takip etmek · Bir web sayfası yapay zekâya vermek için Markdown'a nasıl çevrilir? · WordPress'te yapay zekâyla otomatik makale nasıl yazdırılır? · Blog için RSS ve Google Trends'ten konu nasıl bulunur? · Yapay zekâyla yazılan içerik Google'da ve yapay zekâ yanıtlarında görünür mü? · WordPress'te yapay zekâyla yazılan makalelere iç bağlantı nasıl ekletilir? · WordPress'te her yazıya birbirine benzemeyen öne çıkan görsel yapay zekâyla nasıl ürettirilir? · Yapay zekâya blog yazısı yazdırırken içerik tarifi (brief) nasıl yazılır? · Yemek tarifi sitesine yapay zekâyla tarif yazdırırken nelere dikkat etmeli? · WordPress eklentisini yapay zekâ API hesabına bağlarken çıkan hatalar nasıl çözülür? · WordPress'te yapay zekâ yazı botu neden yarıda kalıyor? "Tur takıldı" uyarısı ve LiteSpeed · WordPress'te otomatik yazılar neden geç çıkıyor? WP-Cron ve gerçek sunucu cron'u · Yapay zekâ yazı botuyla İngilizce ya da başka dilde blog yazısı nasıl yazdırılır? · "İçerik Botu yazı üretemiyor" uyarısı ne demek? Bot günlüğündeki satırları okumak · WordPress yapay zekâ yazı eklentisini silersem yazdığı yazılar da silinir mi? · Yapay zekâ API'sinde araç çağırma (function calling) nasıl yapılır? · Yapay zekâ API bakiyemi koddan nasıl sorgularım, bakiye azalınca nasıl uyarı alırım? · Birden çok WordPress sitesinde aynı yapay zekâ yazı eklentisini tek hesap ve tek bakiyeyle kullanabilir miyim? · Claude Code başka bir API adresi ve anahtarıyla nasıl çalıştırılır? · Yapay zekâyla yazılan WordPress yazılarına SSS bölümü ve FAQ yapısal verisi (schema) eklenir mi? · Yapay zekâ API'sinin ücretsiz denemesi var mı? Wiozen API ne kadar deneme bakiyesi veriyor, neyi kapsıyor? · API üzerinden Claude Haiku mı, Claude Sonnet mi? 1 milyon token fiyatı ve hangisinin ne zaman kullanılacağı · Claude Code oturumu API anahtarıyla ne kadar tutar? · Claude Code abonelik olmadan, kullandığın kadar ödeyerek nasıl kullanılır? · Prompt önbelleği API maliyetini ne kadar düşürür? Önbellekten okuma ve yazma fiyatı · DeepSeek API hangi saatlerde daha ucuz? Yoğun saat ve indirimli saat fiyatı · Cline, Cursor, OpenCode ve Aider'da hangi model kullanılmalı? · Yapay zekâyla bir WordPress yazısı kaça mal olur? Metin, görsel ve araştırma maliyeti · Yapay zekâ botunun yazdığı yazı neden yayınlanmadı, taslakta kaldı? · Yapay zekâ botuyla günde kaç yazı yayınlanmalı, sıklık nasıl ayarlanır? · Yapay zekâyla yazılan WordPress yazılarında yazar olarak kim görünmeli? · Kredi, kripto ya da enerji sitesine yapay zekâyla yazı yazdırırken nelere dikkat etmeli? · Yapay zekâ API'si "Unknown model" hatası veriyor: doğru model adını nereden bulurum? · Yapay zekâ uygulamama web araması nasıl eklenir, arama başına ne kadar öder?