API'ye erişim

Bu modül için tahmini süre: 5 dakika

Genel bakış

Claude ile uygulama geliştirirken bir isteğin (request) tam yaşam döngüsünü anlamak; daha iyi mimari kararlar almanıza ve sorunları daha verimli debug etmenize yardımcı olur. Bu derste kullanıcı bir chat arayüzünde “gönder”e bastığı andan Claude’un yanıtının ekranda belirmesine kadar olan beş aşamayı inceliyoruz: server’a istek, Anthropic API’ye istek, model processing, server’a response ve client’a response. Ayrıca Claude’un içinde tokenization, embedding, contextualization ve generation aşamalarının nasıl çalıştığına da kısaca bakıyoruz.

Beş aşamalı request akışı

Claude ile yapılan her etkileşim öngörülebilir bir pattern izler ve beş ayrı fazdan oluşur: client’tan server’a request, server’dan Anthropic API’ye request, model processing, API’den server’a response ve server’dan client’a response.

Neden bir server’a ihtiyacınız var?

Anthropic API’ye istekleri asla doğrudan client tarafında çalışan koddan yapmamalısınız. Sebepleri:

• API istekleri kimlik doğrulama için secret bir API key gerektirir
• Bu key’i client kodunda açığa çıkarmak ciddi bir güvenlik açığı yaratır
• Herhangi biri key’i çıkarıp yetkisiz request gönderebilir

Onun yerine web veya mobil uygulamanız kendi server’ınıza istek atar; server da güvenli şekilde saklanan key ile Anthropic API’ye iletir.

API isteği yapmak

Server’ınız Anthropic API ile konuşurken ya resmi bir SDK kullanır ya da düz HTTP request gönderir. Anthropic Python, TypeScript, JavaScript, Go ve Ruby için SDK sağlar.

Her request şu temel alanları içermek zorundadır:

• API Key — request’inizi Anthropic’e tanıtır
• Model — kullanmak istediğiniz modelin adı (örn. claude-3-sonnet)
• Messages — kullanıcının input metnini içeren liste
• Max Tokens — Claude’un üretebileceği token sayısının üst sınırı

Claude’un içinde ne oluyor?

Anthropic request’i aldığında Claude bunu dört ana aşamadan geçirir: tokenization, embedding, contextualization ve generation.

Tokenization

Claude önce input metnini token denen daha küçük parçalara böler. Bunlar bütün kelimeler, kelime parçaları, boşluklar veya semboller olabilir. Basit tutmak için her kelimeyi bir token gibi düşünebilirsiniz.

Embedding

Her token bir embedding’e — o kelimenin tüm olası anlamlarını temsil eden uzun bir sayı listesine — dönüştürülür. Embedding’leri, anlamsal ilişkileri yakalayan sayısal tanımlar olarak düşünebilirsiniz.

Kelimelerin çoğu zaman birden fazla anlamı vardır. Örneğin “quantum” şunları ifade edebilir:

• Fiziksel niceliğin ayrık bir birimi (fizik)
• Quantum mechanics veya quantum physics kavramları
• Çok küçük veya atom altı bir şey
• Quantum computing uygulamaları

Contextualization

Claude her embedding’i çevresindeki kelimelere göre rafine ederek context içinde en olası anlamı belirler. Bu süreç sayısal temsilleri uygun tanımı vurgulayacak şekilde ayarlar.

Generation

Contextualized embedding’ler bir output layer’dan geçer ve bir sonraki olası kelime için olasılıklar hesaplanır. Claude her zaman en yüksek olasılığa sahip kelimeyi seçmez; doğal ve çeşitli yanıtlar üretmek için olasılık ile kontrollü bir randomness karışımı kullanır.

Bir kelime seçtikten sonra Claude bunu diziye ekler ve aynı süreci bir sonraki kelime için tekrar eder.

Claude generation’ı ne zaman durdurur?

Her token sonrasında Claude devam edip etmeyeceğine karar vermek için birkaç koşulu kontrol eder:

• Max tokens’a ulaşıldı — belirttiğiniz sınıra geldi mi?
• Natural ending — bir end-of-sequence token üretti mi?
• Stop sequence — önceden tanımlanmış bir stop ifadesiyle karşılaştı mı?

API response

Generation tamamlandığında API yapılandırılmış bir response döner:

• Message — üretilen metin
• Usage — input ve output token sayıları
• Stop Reason — generation’ın neden durduğu

Server’ınız bu response’u alır ve üretilen metni client uygulamanıza iletir; orada kullanıcı arayüzünde görünür.

Temel çıkarımlar

• Bu akışı anlamak güvenli mimari kurmanıza, uygun token limit belirlemenize ve pipeline’da hata ayıklamanıza yardımcı olur
• API key asla client’a sızmamalı; her istek mutlaka kendi server’ınız üzerinden gitmeli
• Her request zorunlu olarak model, messages, max_tokens ve API Key içerir
• Claude’un içinde tokenization → embedding → contextualization → generation döngüsü kelime kelime tekrarlanır
• Generation üç koşuldan biriyle durur: max_tokens, natural ending veya stop_sequence
• Response içindeki stop_reason alanı, generation’ın neden bittiğini anlamak için kritik bilgidir