Ürün Güncellemeleri

Pangram 3.0 API Geçiş Kılavuzu

5 Ocak 2026

Pangram'ın 3.0 API'si yayında! Bu kılavuz, v2 uç noktalarımızdan yeni v3 API'ye geçişle ilgili bilmeniz gereken her şeyi ele almaktadır.

v3'teki yenilikler nelerdir?

AI destekli metinler için üçüncü bir sınıflandırma kategorisi ekledik. Bu kategoriye giren metinler genellikle hem AI hem de insan katkısıyla yazılır; bu durum, günümüzde insanların AI araçlarını gerçekte nasıl kullandığını yansıtmaktadır.

Önemli Şema Değişiklikleri

v3 API'si, her belgeyi, belgenin her bir kategoriye ne kadarının girdiğini gösteren üç oran alanıyla sınıflandırır:

  • insan kesri — insan tarafından yazılmış olarak sınıflandırılan kısım
  • fraksiyon_AI_destekli — yapay zeka destekli olarak sınıflandırılan kısım
  • fraction_ai — yapay zeka tarafından üretildiği belirtilen kısım

Bu üç alan birbirini dışlar ve topluca tüm olasılıkları kapsar; bunların toplamı her zaman 1'e eşittir.

Ayrıca, her belge farklı ayrıntı düzeylerinde üç tahmin dizesi içerir:

  • başlık — örneğin, "Tamamen İnsan Tarafından Yazılmış", "AI Destekli", "AI Tarafından Algılanan"
  • tahmin — sınıflandırmanın ayrıntılı açıklaması. Örneğin, "Bu belgenin tamamen yapay zeka tarafından oluşturulduğuna eminiz" veya "Bu belgenin yapay zeka desteğiyle hazırlandığını, ancak tamamen yapay zeka tarafından oluşturulmadığını düşünüyoruz".
  • kısa tahmin — örneğin, "İnsan", "Karışık", "AI"

Pencere Düzeyinde Analiz

Her bir girdi belgesi pencerelere bölünür. Her pencere şu şekilde etiketlenir:

  • etiket — sınıflandırma dizesi ('İnsan', 'Orta düzeyde AI destekli', 'AI tarafından oluşturulmuş' vb.)
  • güven — Pangram'ın algılama modelinden elde edilen güven derecesi ('Yüksek', 'Orta', 'Düşük')
  • ai_yardım_puanı — 0 ile 1 arasında değişen ve yapay zeka desteğinin düzeyini gösteren bir skaler

Not: Yakın gelecekte yeni etiketlerin ('Hafif AI desteği', 'Yoğun AI desteği') ekleneceğini bekleyebilirsiniz.


Taşınmalı mıyım?

AŞAĞIDAKİLERDEN HERHANGİ BİRİ SİZİN İÇİN GEÇERLİ İSE:

  • Pangram sonuçlarını üretim ortamında kullanma
  • En yeni yapay zeka modellerinden elde edilen sonuçların doğruluğunu artırmak mı istiyorsunuz?
  • 1 Nisan 2026'dan sonra da Pangram API'sini kullanmayı planlıyorsanız

AŞAĞIDAKİLERDEN HERHANGİ BİRİ SİZİN İÇİN GEÇERLİ İSE:

  • Tekrarlanabilirlik için statik bir API'ye ihtiyaç duyan bir araştırmacı mısınız?

Zaman çizelgesi

TarihEtkinlik
11 Aralık 2025Pangram 3.0, kontrol paneli üzerinden yayınlandı
23 Aralık 2025Pangram 3.0, API üzerinden kullanılabilir
2026 yılının Ocak ayı sonuPangram 3.1 sürümü yayınlandı (kontrol paneli + API). Tüm 3.0 API kullanıcıları otomatik olarak güncellendi.
1 Nisan 2026Pangram 2.0 API'lerinin kullanımdan kaldırılması

V2 Uç Noktaları (1 Nisan 2026'ya kadar kullanılabilir)

Geçiş dönemi boyunca aşağıdaki v2 uç noktaları kullanılmaya devam edecektir:

  • text.api.pangram.com
  • text-batch.api.pangram.com
  • text-sliding.api.pangram.com
  • text-extended.api.pangram.com
  • dashboard-text.api.pangram.com

Saha Göç Rehberi

Kaynak: text.api.pangram.com

Son nokta: https://text.api.pangram.comhttps://text.api.pangram.com/v3

Pangram'ın tahminlerini en kapsamlı şekilde anlamak için üst düzey alanları kullanın:

v2 Alanıv3 AlanıNotlar
tahminbaşlık"Tamamen İnsan Tarafından Yazılmış", "AI Destekli", "AI Tarafından Tespit Edildi" gibi değerler
ai_olasılıkfraction_aiYapay zeka tarafından üretildiği düşünülen metin miktarı
fraksiyon_AI_destekliYeni: Yapay zeka desteğiyle hesaplandığı düşünülen miktar
insan kesriİnsan eliyle yazıldığı düşünülen miktar

Orijinal uç noktanın davranışını taklit etme: Orijinal uç nokta, tahminini yapmak için metnin yalnızca ilk penceresini kullanıyordu. Bu davranışı taklit etmek için:

v2 Alanıv3 Alanı
tahminwindows[0].etiket ve windows[0].güven
ai_olasılıkwindows[0].ai_assistance_score

Önemli: Şu ifadenin yorumu ai_yardım_puanı farklıdır ai_olasılık. Bu alanlar bire bir ilişki içinde değildir. Orta aralıkta (0–1) daha fazla tahmin bekleyin. Şunu kullanın etiket önerdiğimiz yorumu anlamak için.


Kaynak: text-batch.api.pangram.com

Şu anda v3 API için toplu iş son noktası bulunmamaktadır. Aşağıdaki adımları izleyerek her bir öğeyi tek tek işlemek için bir döngü kullanın: text.api.pangram.com yukarıdaki göç kılavuzu.


Kaynak: text-sliding.api.pangram.com

Son nokta: https://text-sliding.api.pangram.comhttps://text.api.pangram.com/v3

v2 Alanıv3 AlanıNotlar
tahminbaşlık veya tahminFarklı ayrıntı düzeyleri mevcuttur
kısa tahminkısa tahminDeğişmedi
ai_olasılık, ortalama AI olasılığıfraction_ai, fraksiyon_AI_destekli, insan kesriToplam güven puanları yerine miktar alanlarını kullanın
maksimum yapay zeka olasılığıfraction_ai (önerilir)Tercihen miktar alanları

Pencere değişiklikleri:

  • İçinde metin kaydırma, pencereler üst üste binen
  • v3 sürümünde pencereler birbiriyle çakışmaz
v2 Pencere Alanıv3 Pencere Alanı
windows[].tahminwindows[].etiket + windows[].güven
windows[].ai_likelihoodwindows[].ai_yardım_puanı

Kaynak: text-extended.api.pangram.com

Son nokta: https://text-extended.api.pangram.comhttps://text.api.pangram.com/v3

Çoğu alan değişmeden kalır:

AlanDurum
başlıkDeğişmedi
tahminDeğişmedi
kısa tahminDeğişmedi
insan kesriDeğişmedi
fraction_aiDeğişmedi
windows[].etiketDeğişmedi
windows[].güvenDeğişmedi
windows[].başlangıç_indeksiDeğişmedi
windows[].son_indeksDeğişmedi

Değişen alanlar:

v2 Alanıv3 AlanıNotlar
karışık kesirfraksiyon_AI_destekliAnlaşılır olması için alanın adı değiştirildi
kontrol paneligenel_kontrol_paneli_bağlantısıAnlaşılır olması için alanın adı değiştirildi
ortalama AI olasılığıfraction_ai, fraksiyon_AI_destekli, insan kesriToplam güven puanları yerine miktar alanlarını kullanın
maksimum yapay zeka olasılığıfraction_ai, fraksiyon_AI_destekli, insan kesriToplam güven puanları yerine miktar alanlarını kullanın
windows[].ai_likelihoodwindows[].ai_yardım_puanıAI olasılığı ve AI yardım puanları birbirinin tam karşılığı değildir. Kullanım etiket yol gösterici olması amacıyla.

Belgeler

API belgelerinin tamamına buradan ulaşabilirsiniz.


Sorularınız mı var?

v3'e geçişle ilgili sorularınız varsa, lütfen support@pangram.com adresinden bize ulaşın.


Max Spero
Max SperoCEO, Kurucu Ortak

Max, deneyimli bir makine öğrenimi mühendisidir. En son Nuro’da otonom araçlar üzerinde çalışmış ve şirketin aktif öğrenme çalışmalarını yönetmiştir. Google, Two Sigma ve Yelp’te başarılı makine öğrenimi ürünlerini hayata geçirme konusunda uzun bir geçmişe sahiptir.

Max, Stanford Üniversitesi'nden teorik bilgisayar bilimi alanında lisans ve yapay zeka alanında yüksek lisans derecesine sahiptir. Oyun geliştirmeye olan tutkusu yanı sıra, Magic: The Gathering küp topluluğunun da aktif bir üyesidir.

Max Spero'dan daha fazlası