API anahtarı nedir?
API anahtarı, isteklerinizin sizin hesabınızdan geldiğini ve bakiyenizden düşeceğini belirten gizli bir metindir. Şuna benzer: sk-cocorex- ile başlayan uzun bir dizi. Her isteğe Authorization: Bearer <anahtarınız> başlığıyla (ya da x-api-key başlığıyla) eklenir.
Anahtar bir parola gibidir: kimseyle paylaşmayın ve tarayıcıda / mobil uygulamanın içinde çalışan kodda kullanmayın (bkz. API güvenliği).
Yeni anahtar oluşturmak
- Konsolda API anahtarları sekmesine gidin.
- Yeni anahtar bölümündeki alana bir ad yazın (örn. "Mobil uygulama", "Test ortamı", "Müşteri A"). Ad boş bırakılırsa "API key" adı verilir.
- Oluştur'a basın.
- Altta anahtarınızın tam metni bir kutuda belirir. Kopyala düğmesine basın ve hemen güvenli bir yere kaydedin (parola yöneticisi, ortam değişkeni dosyası).
- Kutunun altında, yeni anahtarınızla hazır kod örnekleri (cURL, Python, Node.js, Anthropic) gösterilir; anahtar örneklere otomatik eklenmiştir.
sk-cocorex-aaa...aaaa) görürsünüz. Kaybederseniz yenisini oluşturup eskisini iptal edin.Hesap başına en fazla 20 aktif anahtar oluşturabilirsiniz.
Anahtarlarınızı görüntülemek
Anahtarların listesinde her anahtar için şunlar görünür:
- Ad ve maskelenmiş değer
- İstek sayısı ve toplam token (anahtarın tüm kullanımı)
- Oluşturulma zamanı (ör. "21 gün önce")
- Son kullanım zamanı ("2 dk önce" ya da "henüz yok")
Bu bilgiler, hangi anahtarın ne kadar kullanıldığını ve artık kullanılmayan anahtarları tespit etmenizi sağlar.
Anahtarı yeniden adlandırmak
Anahtarın yanındaki Adlandır düğmesine basın, yeni adı yazın ve Kaydet'e basın (Enter da çalışır). Anahtar metni değişmez; yalnızca etiketi güncellenir. Anlamlı adlar (hangi uygulama/ortam) kullanımı izlemeyi kolaylaştırır.
Anahtarı iptal etmek
- Anahtarın yanındaki İptal et düğmesine basın.
- Açılan onay penceresini okuyun: "Bu anahtarı kullanan uygulamalar hemen çalışmayı durdurur. Bu işlem geri alınamaz."
- İptal et'e basarak onaylayın.
İptal edilen anahtar anında geçersiz olur; o anahtarla gelen istekler 401 invalid_api_key döner. İptal geri alınamaz; gerekirse yeni anahtar oluşturursunuz. İptal edilmiş anahtarların geçmiş kullanımı, istek günlüğünde "(iptal)" etiketiyle görünmeye devam eder.
Ne zaman yeni anahtar oluşturmalı / iptal etmeli?
- Sızıntı şüphesi: Anahtarı yanlışlıkla herkese açık bir yere (GitHub, ekran görüntüsü, sohbet) koyduysanız hemen iptal edin, yenisini oluşturun.
- Kişi ayrıldı: Anahtara erişimi olan biri ekipten ayrıldıysa iptal edin.
- Kullanılmayan anahtar: Artık kullanmadığınız uygulamanın anahtarını iptal edin.
- Düzenli döndürme: Hassas projelerde anahtarları periyodik olarak yenileyin (önce yeni anahtarı oluşturup uygulamaya verin, sonra eskisini iptal edin; kesinti olmaz).
Çoklu anahtar stratejisi
Tek anahtar yerine her uygulama/ortam için ayrı anahtar kullanın:
| Anahtar adı | Amaç |
|---|---|
uretim | Canlı uygulama |
test | Test/geliştirme |
musteri-a | Belirli bir müşterinin entegrasyonu |
betik-rapor | Otomatik raporlama betiği |
Faydaları: bir anahtar sızarsa yalnızca onu iptal edersiniz; hangi uygulamanın ne kadar harcadığını anahtar bazında görürsünüz; bir hatalı döngü yüzünden bakiyenizin nereye gittiğini hızla bulursunuz.
Anahtarı koda nasıl koymalı?
Anahtarı kodun içine yazmayın. Ortam değişkeni kullanın:
export COCOREX_API_KEY="sk-cocorex-..."import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["COCOREX_API_KEY"], base_url="https://api.cocorex-ai.com/v1")Anahtarı bir .env dosyasında tutuyorsanız, o dosyayı .gitignore'a ekleyerek depoya girmesini engelleyin.
Sorun giderme
"401 invalid_api_key" alıyorum. Anahtar yanlış kopyalanmış (baştaki/sondaki boşluk), iptal edilmiş ya da hesap silinmiş olabilir. Anahtarı yeniden kopyalayın; sorun sürerse yenisini oluşturun.
Anahtarı kopyalayamadım. Kutudaki metni elle seçip kopyalayın. Sayfa yenilenmişse yeni bir anahtar oluşturun.
Anahtar sınırına ulaştım. Kullanmadıklarınızı iptal edin; sınır aktif anahtarlar içindir.