Dokümantasyon

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.

Bu sayfadaki Anthropic ürün ayrıntıları — konsol adresi, menü yolu, anahtar öneki, kimlik doğrulama başlığı ve ücretsiz kredi politikası — en son Anthropic'in resmi API belgeleriyle 31 Ağustos 2026 tarihinde doğrulandı.

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.

  1. platform.claude.com adresine gidip oturum açın. Eski console.anthropic.com adresi artık aynı konsola yönlendiriyor.
  2. 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.
  3. 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.
  4. Anahtarı bir anthropic-version başlığıyla birlikte x-api-key olarak 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ı
ModellerYalnızca ClaudeClaude, GPT, görüntü, video, ses
Uç noktaapi.anthropic.comapi.kunavo.com/v1
APIsMessages APIOpenAI uyumlu + Messages API
Kimlik doğrulama başlığıx-api-keyAuthorization: Bearer
Sağlayıcı hesabıAnthropic hesabı gerekirGerekmez
FaturalandırmaAnthropic, belirteç başınaStripe ile desteklenen tek bakiye
Anahtar biçimisk-ant-...sk-kn-...
  1. Bir Kunavo hesabı oluşturup hesabınıza $10 yükleyin. Kunavo kullandıkça ödemelidir ve bakiyenin süresi dolmaz.
  2. /app/keys adresinde anahtar oluşturun. Kunavo anahtarı yalnızca bir kez gösterilir; anahtarı bir ortam değişkeninde saklayın.
  3. OpenAI SDK'sini https://api.kunavo.com/v1 adresine 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/keys adresinde 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/keys adresinde 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"}]
  }'
Anthropic'in kendi istek biçimi aynı Kunavo anahtarıyla çalışır: /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.

BelirtiOlası nedenÇözüm
401 unauthorizedAnahtar 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_quotaBakiye 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 foundYanlış kısa adclaude-sonnet-5 gibi tam bir kısa ad kullanın; /models adresindeki modellere göz atın
429 rate limitKısa bir süre içinde çok fazla istek gönderildiBir 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.

Her iki yöntemde de kullanım ücretsiz değildir. Anthropic yeni kullanıcılara az miktarda ücretsiz kredi verir, ardından belirteç başına ücretlendirir. Kunavo yeni hesaplara hiç ücretsiz kredi vermez ve en az $10 yüklemeyle başlar. Sürekli ücretsiz Claude API erişimi arayanlar bunu iki yöntemde de bulamaz.

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.
Model başına fiyatlar ve örnek maliyet hesaplamaları için Claude API fiyatlandırma kılavuzuna bakın.

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.

Sonraki adımlar