E-Ticaret Yapay Zeka API Rehberi: Ürün Açıklaması, Chatbot ve Öneri Sistemleri (Açık TL Maliyet Hesabıyla)

E-ticarette yapay zeka API'si üç işte kendini hemen amorti eder: ürün açıklaması üretimi, müşteri destek chatbot'u ve sınıflandırma/öneri. Doğru model sınıfıyla 10.000 ürün açıklaması yaklaşık 165 TL'ye üretilebilir (5 Ağustos 2026 ölçümü); Onysoft AI Gateway'de tek OpenAI uyumlu anahtarla 708+ modele TL bakiyeyle erişirsiniz.

E-ticaret, yapay zekanın en hızlı geri ödeme yaptığı sektörlerden biri: binlerce SKU için içerik, yoğun sezonda destek kuyruğu ve marjı belirleyen sınıflandırma kararları hep metin işidir. Ama aynı iş, seçilen modele göre 25 kattan fazla farklı faturalanabilir — bu yüzden "hangi API" sorusundan önce "hangi işe hangi model sınıfı" sorusunun cevaplanması gerekir.

Bu rehberde her kullanım senaryosu için uygun model sınıfını fiyatlarıyla eşliyor, 10.000 ürün açıklamasının maliyetini açık matematikle TL'ye çeviriyor, ürün açıklaması üreten çalışan kodu paylaşıyor ve Türkçe dil kalitesi ile KVKK (müşteri verisi maskeleme) konularını pratik düzeyde ele alıyoruz.

E-Ticarette Yapay Zeka API'si Hangi İşleri Çözer?

En hızlı geri dönüş üç alandadır: katalog içeriği üretimi, müşteri destek otomasyonu ve ürün verisi sınıflandırma/öneri. Üçü de aynı API şemasıyla, çoğu zaman aynı anahtar üzerinden çalışır; değişen yalnızca model seçimi ve istemdir.

• Ürün açıklaması ve katalog içeriği: Tedarikçiden gelen ham özellik listesini SEO uyumlu, marka sesine uygun açıklamaya çevirme; varyant metinleri, kategori sayfası açıklamaları, kampanya e-postaları. Toplu üretime en uygun iş — hacim yüksek, şablon nettir.
• Müşteri destek chatbot'u: Sipariş durumu, iade/değişim, kargo ve ürün soruları. Ürün kataloğu ve sipariş sistemiyle beslenen bir chatbot, yoğun sezonda destek kuyruğunu kısaltır; temsilciye yalnızca gerçekten insan gerektiren vakalar düşer.
• Sınıflandırma ve öneri: Yeni ürünlere otomatik kategori ataması, özellik (nitelik) çıkarımı, müşteri yorumlarında duygu analizi, arama sorgusu niyetinin anlaşılması ve "benzer ürün" önerileri için etiketleme. İstek başına token sayısı küçüktür ama adet çok yüksektir — birim fiyat burada her şeydir.

Üç senaryonun ortak noktası şu: hiçbiri tek bir "en iyi model" istemez. Her birinin doğru model sınıfı farklıdır ve fatura bu eşleştirmeyle belirlenir.

Hangi Kullanım İçin Hangi Model Sınıfı Uygun?

Kural basittir: hacmi yüksek ve şablonlu işler ekonomi sınıfına, gerçek zamanlı müşteri diyaloğu hız sınıfına, marka sesi kritik metinler amiral sınıfına gider. Aşağıdaki eşleştirme api.onysoft.com canlı kataloğundaki gerçek satış fiyatlarıyla:

Kullanım	Sınıf	Örnek model	Girdi ($/1M)	Çıktı ($/1M)
Toplu ürün açıklaması, etiketleme	Ekonomi	deepseek/deepseek-v4-flash	$0.21	$0.42
Toplu ürün açıklaması, yorum analizi	Ekonomi	openai/gpt-5.6-luna	$0.15	$0.90
Destek chatbot'u	Hız	anthropic/claude-haiku-4.5	$1.50	$7.50
Destek chatbot'u, çok modlu işler	Hız	google/gemini-3.6-flash	$2.25	$11.25
Marka sesi kritik içerik, karmaşık şikayet	Amiral	anthropic/claude-sonnet-5	$3.00	$15.00

Ölçüm: 5 Ağustos 2026 — api.onysoft.com canlı katalog.

Chatbot tarafında hız gerçek bir kısıt: müşteri yanıt beklerken saniyeler sayılır. Kendi üretim trafiğimizden ölçüm verelim — son 14 günde gateway üzerinden geçen 6.959 başarılı istekte uçtan uca ortalama yanıt 3,8 saniye, en hızlısı 0,3 saniye. Ortalamayı uzun üretim yapan amiral istekleri yukarı çeker; hız sınıfı modellerle kısa destek yanıtları saniye altına iner. Model seçimini elle yapmak istemiyorsanız model alanına onysoft/auto yazın: OnyRouter isteği analiz edip uygun sınıfa ücretsiz yönlendirir.

Örnek Hesap: 10.000 Ürün Açıklaması Kaç TL Tutar?

Varsayımlarımızla 110 TL ile 2.853 TL arasında — belirleyici olan model seçimidir. Hesabın tamamı açık: ürün başına ortalama 500 token girdi (özellik listesi + sistem istemi) ve 300 token çıktı (150-200 kelimelik Türkçe açıklama) varsayıyoruz. 10.000 ürün için toplam: 5 milyon girdi + 3 milyon çıktı tokeni.

Örnek: openai/gpt-5.6-luna ile (5M × $0.15) + (3M × $0.90) = $0.75 + $2.70 = $3.45. TL karşılığı: 3.45 × 47,555 = 164,06 TL. Aynı formül diğer modellere uygulanırsa:

Model	Toplam (USD)	Toplam (TL)	Ürün başına
deepseek/deepseek-v4-flash	$2.31	109,85 TL	~1,1 kuruş
openai/gpt-5.6-luna	$3.45	164,06 TL	~1,6 kuruş
anthropic/claude-haiku-4.5	$30.00	1.426,65 TL	~14,3 kuruş
google/gemini-3.6-flash	$45.00	2.139,98 TL	~21,4 kuruş
anthropic/claude-sonnet-5	$60.00	2.853,30 TL	~28,5 kuruş

Ölçüm: 5 Ağustos 2026 — api.onysoft.com canlı katalog. TL karşılıkları 5 Ağustos 2026 TCMB kuru (1 USD = 47,555 TL) ile hesaplanmıştır. Token varsayımları örnektir; kendi kataloğunuz için maliyet hesaplayıcıyı kullanın.

Pratikte en iyi sonucu genellikle hibrit strateji verir: kataloğun tamamını ekonomi sınıfıyla üretip en çok trafik alan 500 ürünü amiral modelle yeniden yazmak. Aynı varsayımlarla bu, 9.500 ürün Luna ($3.28) + 500 ürün Sonnet ($3.00) ≈ $6.28, yani yaklaşık 299 TL eder — tüm kataloğu amiralle üretmenin onda birinden ucuza, vitrin ürünlerinde amiral kalitesi.

Chatbot için de aynı şeffaflıkla kaba bir senaryo: ayda 5.000 destek görüşmesi, görüşme başına (geçmişin her mesajda yeniden gönderilmesi dahil) ~10.000 girdi + 1.500 çıktı token varsayalım. Toplam 50M girdi + 7,5M çıktı; gpt-5.6-luna ile $14.25 ≈ 677,66 TL/ay (görüşme başına ~14 kuruş), gemini-3.6-flash ile $196.88 ≈ 9.362,39 TL/ay (görüşme başına ~1,87 TL). Trafiğinize göre iki sınıf arasındaki fark, chatbot projesinin fizibilitesini tek başına değiştirebilir.

Onysoft'ta Nasıl Çalışıyor: Ürün Açıklaması Üreten Kod ve Maliyet Emniyetleri

Mevcut OpenAI SDK kodunuzda yalnızca base_url değişir; aşağıdaki betik katalogdaki herhangi bir modelle olduğu gibi çalışır. Panelden sk-ony- önekli anahtarınızı üretip TL bakiye yüklemeniz yeterli:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.onysoft.com/v1",  # degisen tek satir
    api_key="sk-ony-ANAHTARINIZ",
)

urun = {
    "ad": "Paslanmaz Celik Fransiz Presi 600 ml",
    "ozellikler": "cift katmanli govde, bulasik makinesinde yikanabilir",
    "kategori": "Mutfak > Kahve Ekipmanlari",
}

yanit = client.chat.completions.create(
    model="openai/gpt-5.6-luna",  # katalogdaki herhangi bir model
    messages=[
        {"role": "system", "content": "Turkce e-ticaret urun aciklamasi yaz: "
            "150-200 kelime, ozellikleri faydaya cevir, abartili sifat kullanma, "
            "urun adini ilk cumlede gecir."},
        {"role": "user", "content": str(urun)},
    ],
)

print(yanit.choices[0].message.content)

Aynı istek curl ile:

curl https://api.onysoft.com/v1/chat/completions \
  -H "Authorization: Bearer sk-ony-ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.6-luna",
    "messages": [
      {"role": "system", "content": "Turkce e-ticaret urun aciklamasi yaz: 150-200 kelime."},
      {"role": "user", "content": "Paslanmaz Celik Fransiz Presi 600 ml; cift katmanli govde"}
    ]
  }'

Toplu üretimde asıl soru "kod çalışır mı" değil "bütçe kontrolden çıkar mı" sorusudur. Gateway katmanındaki emniyetler şöyle çalışır:

• İstek öncesi bakiye ön-kontrolü: Her istekte tahmini maliyet 1,2 tamponuyla bakiyenizle karşılaştırılır; yetmiyorsa istek sağlayıcıya hiç gitmeden 402 döner. Bakiye bitince sistem otomatik durur, negatife düşme ve sürpriz fatura olmaz — 10.000 ürünlük betiği gece çalıştırıp gönül rahatlığıyla uyuyabilirsiniz.
• Anahtar bazlı model token limitleri: İçerik betiğinin anahtarına ayrı limit tanımlayıp chatbot anahtarından bağımsız yönetebilirsiniz.
• Gerçek maliyet her yanıtta: Yanıttaki cost alanı isteğin gerçek maliyetini USD olarak döner; panelde TL karşılığı görünür. Kullanım raporları tarih/model/durum filtresiyle alınır, PDF indirilir veya logolu e-posta raporu olarak gönderilir — muhasebeye aylık dökümü vermek tek tık.

Kod yazmadan denemek isterseniz panel içi Playground'da aynı ürün istemini birkaç modelle yan yana çalıştırabilirsiniz; şema ayrıntıları API dokümantasyonunda.

Türkçe Ürün Metinlerinde Dil Kalitesi Nasıl Güvence Altına Alınır?

En büyük kalite kaldıracı model değil, iyi bir sistem istemi ve 50 ürünlük pilot testtir. Ekonomi sınıfı modeller şablonlu ürün açıklamalarında genellikle yeterli Türkçe üretir; risk, ölçmeden 10.000 ürüne basmaktır.

Türkçe'de dikkat edilecek tipik sorunlar: çeviri kokan kalıplar ("bu ürün ile tanışın"), ek ve çekim hataları, aynı sıfatların enflasyonu ("mükemmel", "eşsiz") ve kategori jargonunun yanlış kullanımı. Bunların çoğu istem düzeyinde çözülür:

• Sistem istemine marka sesi tanımı (samimi/kurumsal, hedef kitle) ve yasak kelime listesi ekleyin.
• Uzunluk, başlık formatı ve "özellikleri faydaya çevir" kuralını açıkça yazın; iki örnek açıklama (few-shot) verin.
• Pilot: Aynı 50 ürünü iki-üç modelle üretin, Playground'da yan yana okuyun, kategori sorumlusuna puanlatın. Kazanan model + istem çiftiyle kataloğun kalanına geçin.

Üst segment veya marka sesi hassas kategorilerde (örn. vitrindeki amiral ürünler) bir önceki bölümdeki hibrit strateji devreye girer: bu ürünlerde anthropic/claude-sonnet-5 gibi amiral bir modelin çıktı farkı, ürün başına ~28 kuruşluk maliyetiyle kolay savunulur.

KVKK ve Faturalama: Müşteri Verisi Maskeleme, TL E-Fatura

Ürün açıklaması üretimi kişisel veri içermez; KVKK açısından asıl dikkat gereken yer chatbot ve yorum analizi gibi müşteri verisinin aktığı senaryolardır. Pratik kural: modele işi yapması için gerekmeyen hiçbir kişisel veriyi göndermeyin.

• Ad-soyad, telefon, adres ve e-postayı isteğe eklemeden önce maskeleyin veya takma kimliğe çevirin (örn. musteri_7421); sipariş numarasını modele değil, kendi sisteminize çözdürün.
• Chatbot sistem istemine, kullanıcıdan kişisel veri talep etmeme talimatı ekleyin.
• Log ve konuşma geçmişi saklama sürelerini aydınlatma metninize yazın.

Muhatap sorusu da netleşmeli: Onysoft ile veri işleme sözleşmenizin tarafı Türkiye'de yerleşik Onysoft Veri Merkezi A.Ş. (İzmir) olur — aydınlatma metninizde Türk hukukuna tabi somut bir muhatap gösterirsiniz. Ayrıntılı çerçeve KVKK uyumlu yapay zeka rehberinde.

Faturalama tarafı e-ticaret şirketleri için kritik: kayıt sonrası fatura bilgilerine VKN'nizi girip "GİB'den Sorgula" dediğinizde sicil canlı sorgulanır — mükellefseniz unvanınız otomatik dolar ve e-Fatura, değilseniz e-Arşiv kesilir. Fatura TL'dir ve TCMB kuru üzerinden düzenlenir; yurt dışı AI aboneliklerinde gündeme gelen KDV-2/stopaj yükümlülüğü yerli faturada oluşmaz. Bu bölüm hukuki/mali danışmanlık değildir; kendi KVKK ve vergi uzmanınıza danışın.

Başlamak için ücretsiz hesap açıp ilk ürün açıklamanızı Playground'da üretebilir, genel çerçeve için Yapay Zeka API rehberine göz atabilirsiniz.

Son güncelleme: 5 Ağustos 2026 · Veriler: api.onysoft.com canlı katalog