Dokümantasyon
Anthropic (Claude) API anahtarı
platform.claude.com adresinde, Settings → API keys bölümünden Anthropic Claude API anahtarı oluşturun — anahtar sk-ant- ile başlar ve yalnızca bir kez gösterilir. Kunavo anahtarıyla Anthropic hesabı olmadan OpenAI SDK veya Anthropic'e özgü Messages API üzerinden aynı Claude modellerine erişebilirsiniz.
Anthropic Claude API anahtarı almak için platform.claude.com adresindeki Claude Console'da oturum açın, Settings → API keys bölümünü açın ve Create Key'e tıklayın. Anthropic API anahtarı sk-ant- ile başlar ve oluşturulurken yalnızca bir kez gösterilir. Anthropic konsolu console.anthropic.com adresinden platform.claude.com adresine taşındı ve anahtarlar sayfası artık platform.claude.com/settings/keys adresinde. Anthropic API anahtarı, https://api.anthropic.com adresine yapılan istekleri x-api-key başlığı ve anthropic-version başlığıyla doğrular; Authorization: Bearer kullanılmaz. Anthropic'in fiyatlandırma SSS'sinde yeni kullanıcılara API'yi denemeleri için az miktarda ücretsiz kredi verildiği belirtiliyor; bu kredinin ötesinde ücretsiz kullanım katmanı yoktur, dolayısıyla başlangıç kredileri tükendiğinde Claude API kullanımı belirteç başına ücretlendirilir.
Kunavo, bağımsız ve OpenAI uyumlu bir AI API ağ geçididir: Tek bir API anahtarı ve kullandıkça öde bakiyesiyle Claude, GPT ve görüntü, video ve ses modellerine, sağlayıcı başına hesap gerekmeksizin erişebilirsiniz. Kunavo API anahtarı sk-kn- ile başlar, kunavo.com/app/keys adresinde oluşturulur ve Anthropic hesabı gerektirmez. Kunavo, Claude'u hem OpenAI uyumlu uç nokta https://api.kunavo.com/v1/chat/completions hem de Anthropic'e özgü uç nokta https://api.kunavo.com/v1/messages üzerinden sunar. Böylece resmi OpenAI SDK'si yalnızca base_url değiştirilerek Claude'a erişebilir. Kunavo kullandıkça ödemelidir; en az $10 yükleme gerekir ve yeni hesaplara ücretsiz kredi verilmez.
Seçenek A — doğrudan Anthropic'ten alınan API anahtarı
Claude, projenin kullanacağı tek model olacaksa Anthropic Console anahtarı doğru seçimdir. Anthropic anahtarı belirteç başına ücretlendirir ve kullanıma sunulduğu gün tüm Claude özelliklerini destekler.
platform.claude.comadresine gidip oturum açın. Eski console.anthropic.com adresi artık aynı konsola yönlendiriyor.- Settings → API keys bölümünü açın (doğrudan bağlantı:
platform.claude.com/settings/keys) ve Create Key'e tıklayın. Anthropic anahtarlarısk-ant-...biçimindedir ve yalnızca bir kez gösterilir. - Billing bölümünden ödeme yöntemi ekleyin. Anthropic yeni kullanıcılara az miktarda ücretsiz kredi verir, ardından belirteç başına ücretlendirir.
- Anahtarı bir
anthropic-versionbaşlığıyla birliktex-api-keyolarak gönderin.
# Anthropic direct — x-api-key, not Bearer
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'Önceden planlanması gereken bir sonuç: Anthropic anahtarı yalnızca Claude'a erişir. GPT, görüntü veya video modellerini de çağıran bir proje için her sağlayıcıda ayrı hesap, anahtar, SDK ve fatura gerekir.
Seçenek B — Claude ve diğer her şey için tek Kunavo anahtarı
Kunavo, Claude'u hem OpenAI uyumlu API hem de Anthropic'e özgü Messages API üzerinden sunar. Tek bir sk-kn- anahtarı, Anthropic hesabı olmadan Stripe üzerinden yüklenen tek bir bakiye ile Claude'a ve katalogdaki diğer tüm modellere erişim sağlar.
| Anthropic Console anahtarı | Kunavo anahtarı | |
|---|---|---|
| Modeller | Yalnızca Claude | Claude, GPT, görüntü, video, ses |
| Uç nokta | api. | api. |
| APIs | Messages API | OpenAI uyumlu + Messages API |
| Kimlik doğrulama başlığı | x-api-key | Authorization: Bearer |
| Sağlayıcı hesabı | Anthropic hesabı gerekir | Gerekmez |
| Faturalandırma | Anthropic, belirteç başına | Stripe ile desteklenen tek bakiye |
| Anahtar biçimi | sk-ant-... | sk-kn-... |
- Bir Kunavo hesabı oluşturup hesabınıza $10 yükleyin. Kunavo kullandıkça ödemelidir ve bakiyenin süresi dolmaz.
/app/keysadresinde anahtar oluşturun. Kunavo anahtarı yalnızca bir kez gösterilir; anahtarı bir ortam değişkeninde saklayın.- OpenAI SDK'sini
https://api.kunavo.com/v1adresine yönlendirin ve bir Claude kısa adını kullanarak çağrı yapın.
Claude API anahtarı ve Anthropic API anahtarı
“Anthropic API anahtarı” ile “Claude API anahtarı”, iki farklı adla anılan aynı kimlik bilgisidir. Anthropic şirketin, Claude ise model ailesinin adıdır; Claude Console'da oluşturulan anahtar Claude API çağrılarını doğrular. Aşağıdaki iki anahtar arasındaki fark, her birinin nereden geldiği ve hangi modellere erişebildiğidir:
- Anthropic Console anahtarı (
sk-ant-...) —platform.claude.com/settings/keysadresinde oluşturulur. Anthropic Console anahtarı yalnızca Claude'u çağırır ve Anthropic anahtarı belirteç başına ücretlendirir. - Kunavo anahtarı (
sk-kn-...) —kunavo.com/app/keysadresinde oluşturulur. Kunavo anahtarı, OpenAI SDK veya Anthropic'e özgü Messages API üzerinden aynı Claude modellerini çağırır; ayrıca Anthropic hesabı olmadan, Stripe üzerinden yüklenen tek bir bakiye ile GPT, görüntü, video ve ses modellerine de erişim sağlar.
Python ile Claude'u çağırın
Resmi OpenAI SDK'sini kullanmaya devam edin. Geçiş için base_url ile model adını değiştirmek yeterlidir.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["KUNAVO_API_KEY"],
base_url="https://api.kunavo.com/v1", # the only line that changes
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Explain quicksort in one paragraph."}],
)
print(resp.choices[0].message.content)Node.js ile Claude'u çağırın
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KUNAVO_API_KEY,
baseURL: "https://api.kunavo.com/v1",
});
const resp = await client.chat.completions.create({
model: "claude-sonnet-5",
messages: [{ role: "user", content: "Explain quicksort in one paragraph." }],
});
console.log(resp.choices[0].message.content);Ya da Claude'u curl ile çağırın
curl https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'/v1/messages adresine POST gönderin — Messages API başvurusuna bakın.Claude API anahtarı çalışmıyor
401 authentication_error döndüren bir Claude API anahtarında sorun neredeyse her zaman şu beş nedenden biridir: uç nokta için yanlış başlık kullanılması, anahtarın ait olmadığı bir uç noktaya gönderilmesi, ortam değişkenine boşluk ya da tırnak işareti sızması, anahtarın iptal edilmiş olması veya anahtar için yanlış temel URL kullanılması.
En yaygın neden başlık uyuşmazlığıdır. Anthropic'in kendi API'si x-api-key ve anthropic-version bekler. Kunavo dahil OpenAI uyumlu uç noktalar Authorization: Bearer bekler. sk-ant- anahtarı yalnızca api.anthropic.com adresinde, sk-kn- anahtarı ise yalnızca api.kunavo.com adresinde çalışır.
| Belirti | Olası neden | Çözüm |
|---|---|---|
401 unauthorized | Anahtar yanlış, iptal edilmiş veya ilgili uç nokta için yanlış başlıkla gönderilmiş | Anahtarı /app/keys adresinde yeniden oluşturun ve Authorization: Bearer sk-kn-… olarak gönderin |
402 insufficient_ | Bakiye boş veya anahtar için belirlenen harcama sınırına ulaşıldı | Bakiyeye para yükleyin veya o anahtarın harcama sınırını yükseltin |
model not found | Yanlış kısa ad | claude-sonnet-5 gibi tam bir kısa ad kullanın; /models adresindeki modellere göz atın |
429 rate limit | Kısa bir süre içinde çok fazla istek gönderildi | Bir süre bekleyin ve üstel gecikmeyle yeniden deneyin |
Aşağıdaki her hata için tam hata JSON'unu, bilinen tüm nedenleri ve kopyalayıp yapıştırabileceğiniz çözümleri içeren ayrıntılı bir kılavuz bulunur: 401 invalid api key, 429 rate_limit_error, credit balance too low / 402, 529 overloaded ve model_not_found.
Claude API'yi kredi kartı olmadan kullanma
Anthropic, standart Claude API hesapları için büyük kredi kartlarını kabul eder ve faturalı ödemeyi kurumsal müşterilere sunar. Bu nedenle doğrudan kullanımda pratikte kart gerekir.
Kunavo bakiyesine aşağıdaki yöntemlerden herhangi biriyle, hiç kart kullanmadan para yüklenebilir: ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). Kunavo yüklemeleri USD cinsinden fiyatlandırır ve Stripe ödeme sayfasında dönüşüm yapar; bu sayede Brezilyalı bir alıcı, uluslararası alışverişe açık bir kart aramak yerine real cinsinden bir tutar için Pix kodunu tarar. Kartla desteklenen dijital cüzdanlar da kullanılabilir; ancak kart kullanan bir cüzdan bu sorunun yanıtı olmadığı için özellikle listeye dahil edilmemiştir. Yöntemlerin tam listesi faturalandırma başvurusunda yer alır.
Hangi Claude modeli kullanılmalı?
- claude-haiku-4-5 — en ucuz ve en hızlı model; yüksek hacimli sınıflandırma ve destek işleri için uygundur. Kunavo, Claude Haiku 4.5 için 1M giriş belirteci başına $0.70, 1M çıkış belirteci başına $3.50 ücret alır.
- claude-sonnet-5 — çoğu akıl yürütme, bilgi erişimi ve kodlama işi için dengeli varsayılan seçenek: en yeni Sonnet; kodlama ve ajan tabanlı işlerde Opus'a yakın. Kunavo, Claude Sonnet 5 için 1M belirteç başına $1.40 / $7.00 ücret alır; Anthropic'in liste fiyatı $2.00 / $10.00 düzeyindedir.
- claude-sonnet-4-6 — önceki Sonnet sürümü; zaten bu modele göre ayarlanmış istemler için. Kunavo, Claude Sonnet 4.6 için 1M belirteç başına $2.10 / $10.50 ücret alır.
- claude-opus-5 — yoğun akıl yürütme ve uzun bağlam için. Kunavo, Claude Opus 5 için 1M belirteç başına $3.50 / $17.50 ücret alır; Anthropic'in liste fiyatı $5.00 / $25.00 düzeyindedir.
- claude-fable-5 — Anthropic'in en yetenekli modeli; en ileri düzey akıl yürütme ve uzun vadeli ajanlar için 1 Eylül 2026'da yayımlandı. Kunavo bu model için 1M belirteç başına $7.00 / $35.00 ücret alır; Anthropic'in liste fiyatı $10.00 / $50.00 düzeyindedir. Önceki sürüm claude-fable-5 de aynı ücretle sunulmaya devam ediyor.
API anahtarı güvenlik kontrol listesi
- API anahtarını asla istemci tarafında açığa çıkarmayın. Her çağrıyı geliştiricinin denetlediği bir sunucu üzerinden yönlendirin.
- Her proje veya ortam için ayrı bir API anahtarı kullanın; böylece bir anahtar sızdığında diğer her şeyi devre dışı bırakmadan o anahtarı iptal edebilirsiniz.
- API anahtarlarını üç ayda bir yenileyin. Kunavo aynı anda birden fazla etkin anahtara izin verir; bu da yenileme için sorunsuz bir geçiş aralığı sağlar.
SSS
Anthropic Claude API anahtarını nasıl alırım?
Anthropic Claude API anahtarı almak için platform.claude.com adresindeki Claude Console'da oturum açın, Settings → API keys bölümünü açın ve Create Key'e tıklayın. Anthropic API anahtarı sk-ant- ile başlar ve oluşturulurken yalnızca bir kez görüntülenir; bu nedenle anahtar o anda kopyalanıp saklanmalıdır. Anthropic konsolu console.anthropic.com adresinden platform.claude.com adresine taşındı ve anahtarlar sayfası artık platform.claude.com/settings/keys adresinde. Anthropic API anahtarı, https://api.anthropic.com adresine yapılan istekleri Authorization: Bearer başlığıyla değil, x-api-key başlığı ve bir anthropic-version başlığıyla doğrular.
Anthropic API anahtarı ile Claude API anahtarı aynı şey mi?
Anthropic API anahtarı ile Claude API anahtarı, iki farklı adla anılan aynı kimlik bilgisidir. Anthropic şirketin, Claude ise model ailesinin adıdır; Claude Console'da oluşturulan anahtar (sk-ant-...) Claude API çağrılarını doğrular. Kunavo API anahtarı (sk-kn-...), farklı bir şirkete ait ayrı bir kimlik bilgisidir; tek bir OpenAI uyumlu uç nokta üzerinden aynı Claude modellerine, ayrıca GPT ve medya modellerine erişir.
Claude API ücretsiz mi?
Claude API sürekli olarak ücretsiz değildir. Anthropic'in fiyatlandırma SSS'sinde yeni kullanıcılara API'yi denemeleri için az miktarda ücretsiz kredi verildiği belirtiliyor; Anthropic bu kredinin miktarını yayımlamıyor ve bunun ötesinde ücretsiz bir kullanım katmanı yok. Bu nedenle başlangıç kredileri tükendiğinde Claude API kullanımı belirteç başına ücretlendirilir. Kunavo da yeni hesaplara ücretsiz kredi vermez: Kunavo hesabına en az $10 yüklemeyle başlanır, bakiye süresi dolmadan kalır ve başarısız 4xx ve 5xx çağrıları hiçbir zaman faturalandırılmaz.
Claude API anahtarım neden çalışmıyor?
401 authentication_error döndüren bir Claude API anahtarında sorun neredeyse her zaman şu beş nedenden biridir: uç nokta için yanlış başlık kullanılması, anahtarın ait olmadığı bir uç noktaya gönderilmesi, ortam değişkenine boşluk ya da tırnak işareti sızması, anahtarın iptal edilmiş olması veya yanlış temel URL kullanılması. Anthropic'in kendi API'si api.anthropic.com, x-api-key ve anthropic-version bekler; OpenAI uyumlu uç noktalar Authorization: Bearer bekler. sk-ant- anahtarı yalnızca api.anthropic.com adresinde, sk-kn- Kunavo anahtarı ise yalnızca api.kunavo.com adresinde çalışır.
Claude API'yi kredi kartı olmadan kullanabilir miyim?
Anthropic, standart Claude API hesapları için büyük kredi kartlarını kabul eder; faturalı ödemeyi ise kurumsal müşterilere sunar. Bu nedenle doğrudan kullanımda pratikte kart gerekir. Kunavo bakiyesine çeşitli yöntemlerle kart olmadan para yüklenebilir: ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). Kunavo yüklemeleri USD cinsinden fiyatlandırır; Stripe ödeme sayfasında dönüşüm yapar. Böylece Brezilyalı bir alıcı dolar cinsinden tutarı real olarak ödeyebilir. Her iki yöntemde de sürekli ücretsiz erişim yoktur — her iki yolla da Claude çağırmak, belirteçler için ödeme gerektirir.
Claude'u OpenAI SDK ile çağırabilir miyim?
Claude, Kunavo'nun OpenAI uyumlu uç noktası üzerinden resmi OpenAI SDK ile çağrılabilir. OpenAI SDK'sinde base_url değerini https://api.kunavo.com/v1 olarak ayarlayın, bearer token olarak Kunavo anahtarını geçin ve model parametresini claude-sonnet-5 gibi bir Claude kısa adı olarak belirleyin. Anthropic'in api.anthropic.com adresindeki kendi API'si, OpenAI biçimindeki chat completion isteklerini kabul etmez; dolayısıyla Claude'u doğrudan çağırmak için Anthropic SDK'si veya Anthropic'e özgü Messages API gerekir.
Anthropic API anahtarı ile Kunavo API anahtarı arasındaki fark nedir?
Anthropic API anahtarı yalnızca Claude modellerini çağırır ve Anthropic üzerinden ücretlendirilir. Kunavo API anahtarı Claude'un yanı sıra GPT, görüntü, video ve ses modellerini tek bir OpenAI uyumlu API üzerinden çağırır; ödemeler Stripe ile tek bir bakiyeden yapılır. Anthropic API anahtarı için Anthropic hesabı gerekir; Kunavo API anahtarı için gerekmez.
Hangi Claude modeliyle başlamalıyım?
Çoğu akıl yürütme, bilgi erişimi ve kodlama işi için dengeli varsayılan seçenek olan claude-sonnet-5 ile başlayın. Uygun maliyetli, yüksek hacimli sınıflandırma ve destek işleri için claude-haiku-4-5 modeline geçin. Zor akıl yürütme görevlerinde claude-opus-5 modelini kullanın; Anthropic'in en yetenekli modeli claude-fable-5'i ise yalnızca en ileri düzey akıl yürütme ve uzun vadeli ajanlar için tercih edin.
Claude API ne kadar tutar?
Anthropic, Claude API'sini model katmanına göre değişen oranlarda belirteç başına ücretlendirir — Claude Haiku 4.5 en ucuz, Claude Fable 5 ise en pahalıdır. Kunavo tüm modellerde aynı Claude modellerini Anthropic'in liste fiyatının altında sunar: Claude Opus 5'in 1M belirteç başına fiyatı $3.50 / $17.50, Anthropic'in fiyatı $5.00 / $25.00; Claude Haiku 4.5'in fiyatı $0.70 / $3.50, Anthropic'in fiyatı $1.00 / $5.00; Claude Sonnet 5'in fiyatı $1.40 / $7.00 iken Anthropic'in $2.00 / $10.00 tutarındaki tanıtım fiyatı 31 Ağustos 2026'da kalıcı standart fiyatı oldu.
Kunavo, Anthropic'in bir parçası mı?
Kunavo, bu modellere erişimi yeniden satan bağımsız bir ağ geçididir. Kunavo; Anthropic, Google veya OpenAI değildir ve sunduğu modelleri eğitmez ya da barındırmaz.
Kunavo nedir, ne değildir
Kunavo, bağımsız ve OpenAI uyumlu bir AI API ağ geçididir: Tek bir API anahtarı ve kullandıkça öde bakiyesiyle Claude, GPT ve görüntü, video ve ses modellerine, sağlayıcı başına hesap gerekmeksizin erişebilirsiniz.
Kunavo, bu modellere erişimi yeniden satan bağımsız bir ağ geçididir. Kunavo; Anthropic, Google veya OpenAI değildir ve sunduğu modelleri eğitmez ya da barındırmaz.
Anthropic'in platform.claude.com adresindeki kendi belgeleri, Anthropic'in ürün, fiyatlandırma ve politikaları için yetkili kaynaktır. Bu sayfada Anthropic'in yayımladığı işlem adımları, her iddianın doğrulandığı tarihle birlikte aktarılır ve Kunavo'nun alternatifi yanlarında belirtilir.