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.
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.
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ımfraksiyon_AI_destekli — yapay zeka destekli olarak sınıflandırılan kısımfraction_ai — yapay zeka tarafından üretildiği belirtilen kısımBu üç 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"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 skalerNot: Yakın gelecekte yeni etiketlerin ('Hafif AI desteği', 'Yoğun AI desteği') ekleneceğini bekleyebilirsiniz.
AŞAĞIDAKİLERDEN HERHANGİ BİRİ SİZİN İÇİN GEÇERLİ İSE:
AŞAĞIDAKİLERDEN HERHANGİ BİRİ SİZİN İÇİN GEÇERLİ İSE:
| Tarih | Etkinlik |
|---|---|
| 11 Aralık 2025 | Pangram 3.0, kontrol paneli üzerinden yayınlandı |
| 23 Aralık 2025 | Pangram 3.0, API üzerinden kullanılabilir |
| 2026 yılının Ocak ayı sonu | Pangram 3.1 sürümü yayınlandı (kontrol paneli + API). Tüm 3.0 API kullanıcıları otomatik olarak güncellendi. |
| 1 Nisan 2026 | Pangram 2.0 API'lerinin kullanımdan kaldırılması |
Geçiş dönemi boyunca aşağıdaki v2 uç noktaları kullanılmaya devam edecektir:
text.api.pangram.comtext-batch.api.pangram.comtext-sliding.api.pangram.comtext-extended.api.pangram.comdashboard-text.api.pangram.comtext.api.pangram.comSon nokta: https://text.api.pangram.com → https://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 |
|---|---|---|
tahmin | başlık | "Tamamen İnsan Tarafından Yazılmış", "AI Destekli", "AI Tarafından Tespit Edildi" gibi değerler |
ai_olasılık | fraction_ai | Yapay zeka tarafından üretildiği düşünülen metin miktarı |
| — | fraksiyon_AI_destekli | Yeni: 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ı |
|---|---|
tahmin | windows[0].etiket ve windows[0].güven |
ai_olasılık | windows[0].ai_assistance_score |
Önemli: Şu ifadenin yorumu
ai_yardım_puanıfarklıdırai_olasılık. Bu alanlar bire bir ilişki içinde değildir. Orta aralıkta (0–1) daha fazla tahmin bekleyin. Şunu kullanınetiketönerdiğimiz yorumu anlamak için.
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.
text-sliding.api.pangram.comSon nokta: https://text-sliding.api.pangram.com → https://text.api.pangram.com/v3
| v2 Alanı | v3 Alanı | Notlar |
|---|---|---|
tahmin | başlık veya tahmin | Farklı ayrıntı düzeyleri mevcuttur |
kısa tahmin | kısa tahmin | Değişmedi |
ai_olasılık, ortalama AI olasılığı | fraction_ai, fraksiyon_AI_destekli, insan kesri | Toplam güven puanları yerine miktar alanlarını kullanın |
maksimum yapay zeka olasılığı | fraction_ai (önerilir) | Tercihen miktar alanları |
Pencere değişiklikleri:
metin kaydırma, pencereler üst üste binen| v2 Pencere Alanı | v3 Pencere Alanı |
|---|---|
windows[].tahmin | windows[].etiket + windows[].güven |
windows[].ai_likelihood | windows[].ai_yardım_puanı |
text-extended.api.pangram.comSon nokta: https://text-extended.api.pangram.com → https://text.api.pangram.com/v3
Çoğu alan değişmeden kalır:
| Alan | Durum |
|---|---|
başlık | Değişmedi |
tahmin | Değişmedi |
kısa tahmin | Değişmedi |
insan kesri | Değişmedi |
fraction_ai | Değişmedi |
windows[].etiket | Değişmedi |
windows[].güven | Değişmedi |
windows[].başlangıç_indeksi | Değişmedi |
windows[].son_indeks | Değişmedi |
Değişen alanlar:
| v2 Alanı | v3 Alanı | Notlar |
|---|---|---|
karışık kesir | fraksiyon_AI_destekli | Anlaşılır olması için alanın adı değiştirildi |
kontrol paneli | genel_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 kesri | Toplam güven puanları yerine miktar alanlarını kullanın |
maksimum yapay zeka olasılığı | fraction_ai, fraksiyon_AI_destekli, insan kesri | Toplam güven puanları yerine miktar alanlarını kullanın |
windows[].ai_likelihood | windows[].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. |
API belgelerinin tamamına buradan ulaşabilirsiniz.
v3'e geçişle ilgili sorularınız varsa, lütfen support@pangram.com adresinden bize ulaşın.

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.






