İlk isteği göndermek

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

Genel bakış

Anthropic API’sine ilk isteğinizi göndermek, temel kurulumu ve yapıyı anladıktan sonra oldukça basittir. Bu bölüm Python kullanarak Claude’u prompt’larınıza yanıt vermeye başlatmak için izleyeceğiniz temel adımları gösterir.

Ortamı hazırlamak

Herhangi bir API çağrısı yapmadan önce gerekli paketleri yüklemeniz ve API key’inizi güvenli şekilde yapılandırmanız gerekir.

Önce Jupyter notebook’unuza bağımlılıkları kurun:

%pip install anthropic python-dotenv

Sonra notebook ile aynı dizinde API key’inizi güvenli saklamak için bir .env dosyası oluşturun:

ANTHROPIC_API_KEY="your-api-key-here"

Bu yaklaşım, API key’inizi kodunuzun dışında tutar ve yanlışlıkla version control’a commit edilmesini engeller. .env dosyasını her zaman .gitignore’a ekleyin.

Environment variable’ları yükleyin ve API client’ınızı oluşturun:

from dotenv import load_dotenv
load_dotenv()

from anthropic import Anthropic

client = Anthropic()
model = "claude-sonnet-4-0"

Create fonksiyonu

API request yapmanın kalbinde client.messages.create() fonksiyonu vardır. Bu fonksiyon üç temel parametre ister:

• model — kullanmak istediğiniz Claude modelinin adı
• max_tokens — response uzunluğu için bir güvenlik sınırı (hedef değil)
• messages — Claude’a göndereceğiniz conversation history

max_tokens parametresi bir güvenlik mekanizması gibi çalışır. 1000 olarak ayarlarsanız Claude, söyleyecek daha çok şeyi olsa bile 1000 token sonra durur. Claude bu sınıra ulaşmaya çalışmaz — uygun bulduğu kadar yazar ve maksimuma ulaşırsa durur.

Messages’ı anlamak

Messages, sizin ve Claude arasındaki konuşmayı temsil eder; bir chat uygulamasına benzer. İki tür mesaj vardır:

• User messages — Claude’a göndermek istediğiniz içerik (insanlar tarafından yazılır)
• Assistant messages — Claude’un ürettiği yanıtlar

Her mesaj role (user veya assistant) ve content (asıl metin) içeren bir dictionary’dir.

İlk request’inizi yapmak

İşte Claude’a request yapmanın tam bir örneği:

message = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What is quantum computing? Answer in one sentence"
        }
    ]
)

Bu kodu çalıştırdığınızda Claude isteğinizi işler ve üretilen metni, request’le ilgili metadata ile birlikte içeren bir response object döner.

Response’u çıkarmak

Response object birçok bilgi içerir, ancak genelde sadece üretilen metni istersiniz. Şu şekilde erişin:

message.content[0].text

Bu size temiz, okunabilir bir output verir: “Quantum computing is a type of computation that leverages quantum mechanics principles like superposition and entanglement to process information using quantum bits (qubits), potentially solving certain complex problems exponentially faster than classical computers.”

Bu temellerle birlikte artık farklı prompt’larla denemeler yapmaya ve Claude ile daha karmaşık etkileşimler kurmaya başlayabilirsiniz.

Temel çıkarımlar

• API key her zaman .env dosyasında saklanır ve .gitignore’a eklenir
• client.messages.create() Claude’a istek atmanın temel yoludur ve model, max_tokens, messages ister
• max_tokens bir hedef değil güvenlik üst sınırıdır; Claude ona ulaşmaya çalışmaz
• Her message bir role (user/assistant) ve content alanı içeren dict’tir
• Response object’inden üretilen metni message.content[0].text ile alırsınız