Claude API ile PHP'den İlk İstek: Messages API Temelleri

Claude ai üzerinde çalışırken Claude API ile PHP'den İlk İstek: Messages API Temelleri konusunu doğru kavramak hem zaman kazandırır hem de ileride çıkabilecek sorunların önüne geçer. Aşağıda konunun özünü 5 başlık altında topladık.

Claude API ile PHP'den İlk İstek: Messages API Temelleri nedir, neden önemlidir?

Claude'u kendi uygulamanıza eklemenin yolu Anthropic API'sidir. Resmî PHP SDK ile birkaç satırda bir mesaj gönderip yanıt alabilir; ürün açıklaması üretme, müşteri yorumunu sınıflandırma ya da metin özetleme gibi işleri sitenize taşıyabilirsiniz. API anahtarını kodun içine değil ortam değişkenine koymak ve kullanım maliyetini izlemek, ilk günden edinilmesi gereken alışkanlıklardır.

Adım adım

1. Anahtarı gizli tutun

API anahtarını ortam değişkeninde ya da sunucu dışındaki bir yapılandırma dosyasında saklayın; depoya eklemeyin.

2. Mesaj yapısı

İstek; model adı, en fazla üretilecek token (max_tokens) ve rol/içerik çiftlerinden oluşan mesajlar listesi içerir.

3. Yanıtı okuyun

Yanıt içerik bloklarından oluşur; metin, type alanı text olan bloklardadır.

4. Hataları yakalayın

Hız sınırı ve geçici sunucu hatalarında yeniden deneme, kullanıcıya anlaşılır bir mesaj gösterin.

5. Maliyeti izleyin

Yanıttaki kullanım bilgisi girdi ve çıktı token sayısını verir; günlük kullanımı kaydedin.

Örnek kod

Aşağıdaki PHP örneği, yukarıdaki noktaların gerçek bir kodda nasıl bir araya geldiğini gösteriyor:

<?php
// composer require anthropic-ai/sdk
require __DIR__ . '/vendor/autoload.php';

$istemci = new Anthropic\Client(apiKey: getenv('ANTHROPIC_API_KEY'));

$mesaj = $istemci->messages->create(
    maxTokens: 1024,
    model: 'claude-opus-5-5',
    messages: [
        ['role' => 'user', 'content' => 'Organik zeytinyağı için 2 cümlelik ürün açıklaması yaz.'],
    ],
);

foreach ($mesaj->content as $blok) {
    if ($blok->type === 'text') echo $blok->text, PHP_EOL;
}

Örneği kendi projenize uyarlarken değişken adlarını ve yapılandırma değerlerini ortamınıza göre değiştirmeyi unutmayın.

Avantajları

Kısaca özetlemek gerekirse:

• Yapay zekâ özellikleri kendi sitenizin içinde çalışır
• Resmî SDK hata ve yeniden deneme işlerini kolaylaştırır
• Küçük işlerle başlayıp ihtiyaca göre büyütebilirsiniz

Kontrol listesi

Dersi bitirmeden önce aşağıdaki maddeleri kendi projenizde denediğinizden emin olun:

• Anahtarı gizli tutun
• Mesaj yapısı
• Yanıtı okuyun
• Hataları yakalayın
• Maliyeti izleyin

Özetle

Claude API ile PHP'den İlk İstek: Messages API Temelleri, küçük ama düzenli adımlarla ustalaşılan konulardan biri. Özellikle Anahtarı gizli tutun ve Maliyeti izleyin başlıklarını uygulamaya geçirmek iyi bir başlangıç olur.

İlgili içerikler:

• Claude ile temel web kodlama
• Claude Code ile Terminalde Yapay Zekâ Destekli Geliştirme: İlk Adımlar
• Claude ile Etkili Prompt Yazma: Bağlam, XML Etiketleri ve Örnekler

Bir sonraki adım için Akademi sayfasındaki diğer derslere geçebilirsiniz.