Claude entegrasyonu:
ürün içeriği ve analizler kendi modelinizle.

Claude entegrasyonu nedir, e-ticaret satıcısına hangi işlerde yarar?

Claude, Anthropic şirketinin geliştirdiği büyük dil modeli ailesidir. Anthropic'in model dokümanına göre güncel Claude modellerinin hepsi metin ve görsel girdisi, metin çıktısı, çok dilli kullanım ve araç kullanımı destekler. Satıcı için karşılığı somuttur: ürün kartındaki dağınık bilgiyi kurallı bir başlığa çevirmek, PDF faturayı okumak, kâr tablosunu yoruma dönüştürmek.

Yox İş Ortağım'da Claude, panelde doğrudan seçilebilen üç sağlayıcıdan biridir; diğer ikisi OpenAI'ın GPT modelleri ve Google Gemini'dir. Anahtarınızı AI Yönetimi ekranına girdiğinizde panel, Anthropic hesabınızın erişebildiği Claude modellerini listeler; model adını ezbere yazmanız gerekmez.

Panelde Claude'un çalıştığı işler

• Ürün içeriği: pazaryeri kurallarına uygun başlık ve açıklama önerisi; öneriyi düzenleyip onayladığınızda ürün kartına yazılır.
• Kategori ve özellik: panele bağlı satış kanalları için kategori eşleme önerisi, reddedilen ilanda eksik zorunlu özellik için öneri ve yurt dışı kanallar için ürün çevirisi.
• Belge okuma: alış faturası PDF'inden ya da görselinden bilgi okuma.
• Hazır analizler: günlük işletme brifi, sipariş analizi, kâr ve ciro yorumu, stok risk raporu, katalog kalite analizi, fiyatlandırma analizi, rekabet stratejisi, iade kök-neden analizi ve kargo analizi.
• Müşteri iletişimi: müşteri sorusuna yanıt taslağı; taslağı kullanıp kullanmamaya siz karar verirsiniz.

Claude panelde öneri ve rapor üretir; fiyatı, stoğu ya da ilanı kendiliğinden değiştirmez. Bu yüzden modelin hatası, onay adımında yakalanacak bir taslak olarak kalır.

Ekim 2026 itibarıyla Claude model ailesi ve model kimlikleri

Anthropic'in model genel bakış sayfası Ekim 2026 itibarıyla dört güncel model listeler ve kararsız olanlara çoğu iş için Claude Opus 5.5 ile başlamayı önerir. Dört modelin bağlam penceresi de 1 milyon token, tek yanıttaki en fazla çıktısı 128 bin token'dır; güvenilir bilgi kesim tarihleri Haziran 2026'dır.

Tablodaki effort, modelin bir yanıta ne kadar emek harcayacağını belirleyen API ayarıdır ve düşünme dahil bütün çıktıyı etkiler. Opus 5.5'te uyarlamalı düşünme (adaptive thinking) her zaman açıktır ve kapatılamaz; Anthropic bu modelde effort'u maliyetin ve düşünme derinliğinin ana kontrolü olarak tanımlar.

Önceki nesil Claude modelleri hâlâ seçilebilir mi?

Evet. Anthropic; Claude Fable 5, Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, Opus 4.5, Sonnet 5, Sonnet 4.6 ve Haiku 4.5'i eski ama erişilebilir modeller olarak listeler. Panel model listesini doğrudan hesabınızdan çektiği için bunlar da seçenek olarak görünebilir. Yeni kurulumda güncel nesli seçmenin iki nedeni var: Anthropic güncel dört modelin kullanımdan kaldırılmasını en erken Eylül ve Ekim 2027'ye tarihlemiştir ve fiyat farkı büyüktür. Örneğin Haiku 4.5 1 milyon girdi token'ı için 1 dolar alırken Haiku 5.5 0,10 dolar alır.

Claude API fiyatları: 1 milyon token başına girdi ve çıktı ücreti

Claude API abonelikle değil, kullandığınız token kadar ücretlendirilir. Fiyatlar ABD doları cinsindendir ve 1 milyon token (MTok) başına verilir. Anthropic'in fiyat sayfasındaki Ekim 2026 liste fiyatları şöyledir:

Haiku 5.5, istemi 100 bin token'ı aşan isteklerde daha yüksek fiyattan hesaplanır; tek bir ürün açıklaması bu sınırın çok altında kalır. Diğer güncel modellerde 1 milyon token'lık bağlamın tamamı standart fiyattandır. Önbelleğe yazma, 5 dakikalık önbellek için girdi fiyatının 1,25 katı, 1 saatlik önbellek için 2 katıdır.

Düşünme token'ları ve effort çıktı faturasını nasıl etkiler?

Güncel Claude modelleri yanıt vermeden önce düşünebilir. Anthropic'e göre max_tokens sınırı düşünme ile yanıt metninin toplamına uygulanır; yani düşünme de çıktı tarafında sayılır. Effort düşürüldüğünde model basit işlerde düşünmeyi kısaltır ya da hiç düşünmez. Bir diğer nokta: Claude 4.7 ve sonraki modeller yeni bir tokenizer kullanır ve aynı metin için yaklaşık %30 daha fazla token üretir; eski bir modelde ölçtüğünüz token sayısını yeni modele taşımayın.

Yox İş Ortağım'da Claude entegrasyonu: paket, ekran ve model seçimi

Panelde yapay zekâ iki yolla çalışır. Profesyonel paketten itibaren ürün açıklaması, başlık ve kategori önerisi platform token'ıyla kullanılır; harcama token bakiyenizden düşer. Kurumsal paketten itibaren AI Yönetimi ekranında kendi Claude API anahtarınızı bağlayabilirsiniz; bu kullanım token limitinden muaftır ve model ücretini Anthropic doğrudan sizin hesabınıza yansıtır.

Paketlere göre Claude kullanımı

Yıllık ödemede %20 indirim uygulanır; kanal, ürün ve kullanıcı sınırları paket karşılaştırmasında yer alır.

Hangi panel işinde hangi Claude modeli?

AI Yönetimi'nde tek bir model seçersiniz ve bu model bütün yapay zekâ görevlerinde kullanılır. Bu yüzden modeli en sık yaptığınız işe göre seçin; büyük bir toplu iş öncesinde modeli değiştirip iş bitince eski seçime dönebilirsiniz.

Aynı 20 ürünü iki modelle, gerekirse Gemini gibi başka bir sağlayıcının modeliyle deneyip sonuçları ve AI Yönetimi'ndeki kullanım kaydında görünen harcamayı karşılaştırmak, genel kanıdan daha güvenilir bir karar verir.

1.000 ürün açıklaması Claude ile kaç dolar tutar? Örnek hesap

Aşağıdaki hesap bir örnektir; gerçek tutar talimatın uzunluğuna, ürün kartındaki bilgi miktarına, istenen açıklama uzunluğuna ve modelin ne kadar düşündüğüne göre değişir. Anthropic Türkçe metin için resmî bir token oranı yayımlamaz; kendi metninizin token sayısını Anthropic'in ücretsiz token sayma uç noktasıyla (count_tokens) ölçebilirsiniz.

Hesabın varsayımları

Model ve indirim yoluna göre toplam maliyet

Prompt caching sütunu, 800 token'lık talimatın ilk istekte 5 dakikalık önbelleğe yazıldığını ve istekler ara vermeden aktığı için kalan 999 istekte önbellekten okunduğunu varsayar. Talimat, güncel dört model için geçerli 512 token'lık asgari önbellek uzunluğunu aştığı için önbelleğe alınabilir.

Prompt caching ve Batch API neyi ucuzlatır, neyi ucuzlatmaz?

Tablonun asıl dersi şudur: maliyetin büyük kısmı çıktı token'ından gelir. Prompt caching yalnız tekrar eden girdiyi ucuzlatır; bu örnekte tasarruf %15 civarında kalır. Batch API ise girdinin ve çıktının ikisine de %50 indirim uygular, karşılığında yanıtlar anında gelmez. Anthropic'e göre çoğu toplu iş 1 saatten kısa sürede biter, 24 saatte tamamlanamayan istekler düşer ve bir toplu iş en fazla 100.000 istek ya da 256 MB olabilir.

Claude API anahtarı nasıl alınır? Console, kredi ve oran sınırları

Claude API anahtarı, Anthropic'in geliştirici platformu Claude Console'da (platform.claude.com) oluşturulur; claude.ai sohbet hesabınızın ayarlarında yer almaz. Anthropic'in resmî adımlarıyla süreç şöyledir:

1. platform.claude.com adresinden Claude Console'a giriş yapın ya da yeni hesap oluşturun.
2. Settings → Billing sayfasında Buy credits ile ön ödemeli kredi alın; isterseniz bakiye belirlediğiniz eşiğin altına düştüğünde devreye giren otomatik yüklemeyi (auto-reload) açın.
3. Settings → API keys sayfasında Create key düğmesine basın, anahtara ad verin, bir son kullanma süresi seçin ve isterseniz anahtarı bir çalışma alanına (workspace) bağlayın.
4. sk-ant- ile başlayan anahtarı kopyalayıp güvenli bir yerde saklayın: Console tam anahtarı yalnız oluşturma anında bir kez gösterir.
5. Yox İş Ortağım'da AI Yönetimi ekranında sağlayıcı olarak Claude'u seçin, anahtarı yapıştırın ve listelenen modellerden birini seçin.

Kredi kuralları önemlidir. Anthropic'in yardım merkezine göre alınan krediler hemen kullanılabilir, satın alma tarihinden bir yıl sonra sona erer ve iade edilmez; kredi biterse API çağrıları yeni kredi eklenene kadar durur. Panelde bunun karşılığı, Claude ile başlatılan işlemlerin sonuç vermemesidir.

Harcama tavanı ve oran sınırı katmanları

Anthropic hesapları kullanım geçmişine göre katmanlara ayırır; yeni ve geçmişi az hesaplar standart sınırların altındaki bir değerlendirme (Evaluation) katmanından başlayabilir. Standart katmanların aylık harcama tavanı ve Claude Opus 5.5 için oran sınırları şöyledir:

Bu katmanlarda Sonnet 5.5 ve Haiku 5.5'in sınırları Opus 5.5 ile aynıdır ve her model ayrı sayılır. Önbellekten okunan token'lar çoğu modelde girdi sınırına sayılmaz. Sınır aşılırsa API 429 hatası ve ne kadar beklemeniz gerektiğini bildiren retry-after başlığı döner.

claude.ai aboneliği ile Claude API arasındaki fark

claude.ai'deki Free, Pro ve Max planları Claude'u web, masaüstü ve mobil uygulamada sohbet ederek kullanmak içindir. Anthropic'in yardım merkezi iki ürünü açıkça ayırır: ücretli bir Claude planı, Console üzerinden API kullanımını kapsamaz; API için ayrıca Console hesabı ve kredi gerekir. Panelin istediği şey bir sohbet hesabı değil, Console'da oluşturulmuş bir API anahtarıdır.

Max ve Team planlarındaki aylık API kredisi

Tek istisna, Anthropic'in Max ve Team planlarına tanıdığı aylık API kredisidir. Resmî dokümana göre Max 5x her ay 100 dolar, Max 20x 200 dolar, Team ise koltuk başına 20 dolar (Standard) ya da 100 dolar (Premium) kredi alır; Team kredisi tek havuzda toplanır ve en fazla 500 dolardır. Free, Pro ve Enterprise planları bu krediden yararlanamaz.

• Kredi, claude.ai'de Settings > Billing (Team planında Organization settings > Billing) bölümünden bir Console organizasyonu bağlanarak alınır; yeni aboneler 7 gün sonra talep edebilir.
• Kullanılmayan kredi her fatura döneminin sonunda sona erer, sonraki aya devretmez.
• Önce bu kredi harcanır, sonra satın aldığınız kredi; ikisi de yoksa API istekleri bir sonraki aylık krediye kadar durur ve kullanım Claude planınıza yansıtılmaz.
• Kredi Claude API'de geçerlidir; Claude Code ve claude.ai'deki ek kullanımı kapsamaz.

Pratik sonuç şudur: Max aboneyseniz kredinin bağlı olduğu Console organizasyonunda oluşturduğunuz anahtarı panele girerek bu aylık krediyi ürün içeriği ve analizler için kullanabilirsiniz.

Veri gizliliği: Claude API'ye gönderilen veri eğitimde kullanılır mı?

Varsayılan olarak kullanılmaz. Anthropic'in gizlilik merkezine göre ticari ürünlerdeki girdi ve çıktılar varsayılan olarak model eğitiminde kullanılmaz; API dokümanı da saklanan verinin açık izniniz olmadan eğitimde kullanılmadığını yazar. Saklama süreleri ise kullandığınız arayüze ve duruma göre değişir:

Verinin hiç saklanmaması (zero data retention, ZDR) gereken kurumsal hesaplar için Anthropic bu düzenlemeyi satış ekibiyle anlaşma üzerine açar.

KVKK açısından pratik kurallar

Yox İş Ortağım, yalnız bir yapay zekâ işlemi başlattığınızda o işlem için gereken bilgiyi seçtiğiniz modele gönderir: başlık önerisinde ürün kartı alanları, rapor görevlerinde özetlenmiş satış ve stok verileri. Riski azaltmak için şu kurallara uyun:

• Ürün açıklamasına ya da özellik alanlarına müşteri adı, telefon, adres gibi kişisel veri yazmayın.
• Yanıt taslağı görevinde müşterinin soru metni modele gider; soruda telefon ya da adres geçiyorsa bunu bilerek kullanın.
• Claude API istekleri varsayılan olarak küresel yönlendirmeyle işlenir, yani verinin Türkiye dışında işlenmesini bekleyin; kişisel veri aktarımı söz konusuysa KVKK yükümlülüklerinizi hukuk danışmanınızla değerlendirin.
• API anahtarını e-posta ya da mesajla paylaşmayın; anahtar yalnız AI Yönetimi ekranına girilir.

Türkçe pazaryeri içeriğinde Claude ile dikkat edilecekler

Anthropic'in çok dilli performans tablosu Türkçeyi ölçülen diller arasında saymaz; resmî ifade, Claude'un tabloda ölçülenlerin dışındaki birçok dilde de yetkin olduğu ve kendi dilinizde test yapmanız gerektiğidir. Aynı sayfa üretimde hedef dili sistem talimatında açıkça belirtmeyi önerir. Bu yüzden Türkçe içerikte ilk iş, görev talimatına çıktının Türkçe olacağını yazmaktır.

Başlık uzunluğu ve kanal kuralları

Her pazaryerinin başlık ve açıklama sınırı farklıdır. Örneğin Trendyol'a ürün gönderirken kullanılan ürün oluşturma servisinde ürün adı en fazla 100, HTML açıklama en fazla 30.000 karakterdir. Sınırı talimata yazmak tek başına yetmez; önerileri onaylamadan önce başlık optimizasyon aracında kontrol edin.

Abartılı iddia, marka ve yasaklı ifade riski

6502 sayılı Tüketicinin Korunması Hakkında Kanun'un 61. maddesi ticari reklamların doğru ve dürüst olmasını ve tüketiciyi aldatmamasını şart koşar. Dil modelleri, kural verilmediğinde akıcı ama kanıtsız ifadeler üretebilir. Onay ekranında özellikle şunlara bakın:

• Kanıtlayamayacağınız üstünlük ifadeleri: “en ucuz”, “piyasadaki en dayanıklı”, “%100 etkili”.
• Sağlık, zayıflama ya da tedavi çağrıştıran sözler.
• Başka markaların adı: uyumluluk bilgisi gerçekten doğru değilse başlığa yazdırmayın.
• Ürün kartında olmayan teknik değer: kartta bulunmayan ölçü, malzeme ya da sertifika metne girmemeli.

Prompt Merkezi'nde Claude talimatını özelleştirme

Prompt Merkezi'nde her görevin talimatı düzenlenebilir ya da görev kapatılabilir. Claude ile başlık ve açıklama üretirken talimata şu kuralları eklemek işe yarar:

• Çıktı dili Türkçe; doğal, satıcı ağzından, ünlemsiz ve abartısız.
• Başlık sırası: marka, ürün türü, ayırt edici özellik, renk ya da beden; satış yaptığınız kanalın, örneğin n11'in başlık sınırını aşma.
• Yalnız ürün kartındaki bilgileri kullan; eksik bilgi varsa uydurma, boş bırak.
• Kategorinizde reddedilen ifadelerden oluşan yasaklı kelime listesi.

Talimatı değiştirince aynı 10 üründe eski ve yeni çıktıyı karşılaştırın; her seferinde tek kural değiştirin.

Claude entegrasyonu için karar rehberi ve sık yapılan hatalar

Claude entegrasyonuna başlamadan önce üç soruyu cevaplayın: ayda kaç ürün içeriği üretilecek, analiz görevleri ne sıklıkla çalışacak ve harcamayı kim izleyecek. Hacim düşükse Profesyonel paketteki platform token'ı yeterli olabilir. Kendi anahtarınızı bağlamak Kurumsal paketle mümkündür ve token limitinden muaf olduğu için yüksek hacimde maliyetin kontrolünü doğrudan size bırakır.

Kurulum öncesi kontrol listesi

• Console'da kredi yüklü, otomatik yükleme bilinçli olarak açık ya da kapalı.
• Settings → Billing sayfasında katman tavanının altında kendi aylık harcama limitiniz tanımlı.
• Anahtar bir parola yöneticisinde saklanıyor, son kullanma tarihi takvimde.
• Prompt Merkezi'nde başlık talimatına kanal karakter sınırı ve Türkçe çıktı kuralı eklenmiş.
• İlk 20 öneri tek tek okunup öyle onaylanmış.

Sık yapılan hatalar

• claude.ai Pro aboneliğini API erişimi sanmak: Pro planı API kullanımını ve aylık API kredisini içermez.
• Kredi bitince panel işlemlerinin neden durduğunu başka yerde aramak; ilk bakılacak yer Console'daki bakiyedir.
• Ürün açıklaması için Fable 5.1 seçmek: örnek hesabımızda aynı iş Haiku 5.5'e göre yaklaşık 100 kat pahalıdır.
• Önerileri okumadan toplu onaylamak; model taslak üretir, sorumluluk ilan sahibindedir.
• Anahtarı paylaşılan bir belgede tutmak; kaybolan anahtar Console'da tekrar görüntülenemez, yenisi oluşturulur.

Kurulumu isterseniz birlikte yapıyoruz; bunun için Yox İş Ortağım başvuru formunu doldurabilirsiniz. Ayda kaç ürün içeriği üreteceğinizi ya da hangi modeli seçeceğinizi netleştiremediyseniz iletişim sayfamızdan bize yazabilirsiniz.