Pangram 3.0 API Geçiş Kılavuzu

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

v3'teki yenilikler nelerdir?

AI destekli metinler için üçüncü bir sınıflandırma kategorisi ekledik. Bu kategoriye giren metinler genellikle önemli ölçüde AI ve insan katkısıyla yazılır ve bu da insanların günümüzde AI araçlarını nasıl kullandığını yansıtır.

Önemli Şema Değişiklikleri

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

• fraksiyon_insan — insan tarafından yazılmış olarak sınıflandırılan kısım
• fraksiyon_ai_destekli — AI destekli olarak sınıflandırılan kısım
• fraksiyon_ai — AI tarafından üretilmiş olarak sınıflandırılan kısım

Bu üç alan birbirini dışlar ve topluca kapsamlıdır; toplamları her zaman 1'e eşittir.

Ek olarak, 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 yardımıyla oluşturulduğuna inanıyoruz, 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 giriş belgesi pencerelere bölünür. Her pencere şu şekilde etiketlenir:

• etiket — sınıflandırma dizesi ('İnsan', 'Orta derecede AI destekli', 'AI tarafından oluşturulmuş' vb.)
• güven — Pangram'ın algılama modelinden elde edilen güvenilirlik çıktısı ('Yüksek', 'Orta', 'Düşük')
• ai_yardım_puanı — AI yardımının büyüklüğünü gösteren 0 ile 1 arasında bir skaler

Not: Yakın gelecekte ek etiketlerin ('Hafif AI desteği', 'Ağır AI desteği') eklenmesi beklenmektedir.

---

Göç etmeli miyim?

EVET, eğer:

• Pangram sonuçlarını üretim ortamında kullanma
• En yeni AI modellerinin çıktılarının doğruluğunun artırılmasını istiyorsunuz
• 1 Nisan 2026'dan sonra Pangram API'yi kullanmayı planlayın

Aşağıdaki durumlarda HAYIR:

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

---

Zaman çizelgesi

Tarih	Etkinlik
11 Aralık 2025	Pangram 3.0 kontrol panelinden yayınlandı
23 Aralık 2025	API aracılığıyla Pangram 3.0 kullanılabilir
2026 yılının Ocak ayı sonu	Pangram 3.1 yayınlandı (kontrol paneli + API). Tüm 3.0 API kullanıcıları otomatik olarak yükseltildi.
1 Nisan 2026	Pangram 2.0 API'leri kullanımdan kaldırılıyor

---

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

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

• metin.api.pangram.com
• metin-toplu-işlem.api.pangram.com
• metin-kaydırma.api.pangram.com
• metin-genişletilmiş.api.pangram.com
• dashboard-text.api.pangram.com

---

Saha Göç Kılavuzu

Şuradan metin.api.pangram.com

Son 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 Algılanan" gibi değerler
ai_olasılık	fraksiyon_ai	AI tarafından üretildiği düşünülen metin miktarı
—	fraksiyon_ai_destekli	Yeni: AI destekli olduğu düşünülen miktar
—	fraksiyon_insan	İnsan tarafından yazıldığına inanılan miktar

Orijinal uç nokta davranışıyla eşleştirme: Orijinal uç nokta, tahminini yapmak için yalnızca metnin ilk penceresini kullanıyordu. Bu davranışla eşleştirmek için:

v2 Alanı	v3 Alanı
tahmin	windows[0].etiket ve windows[0].güvenilirlik
ai_olasılık	windows[0].ai_yardım_puanı

Önemli: Yorumlama ai_yardım_puanı farklıdır ai_olasılık. Bu alanlar bire bir değildir. Orta aralıkta (0–1) daha fazla tahmin bekleyin. Kullanın etiket önerdiğimiz yorumu anlamak için.

---

Şuradan metin-toplu-işlem.api.pangram.com

Şu anda v3 API için toplu iş sonu noktası bulunmamaktadır. Her bir öğeyi ayrı ayrı işlemek için bir döngü kullanın ve aşağıdaki adımları izleyin: metin.api.pangram.com yukarıdaki göç kılavuzu.

---

Şuradan metin-kaydırma.api.pangram.com

Son 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şmeden
ai_olasılık, ortalama_ai_olasılığı	fraksiyon_ai, fraksiyon_ai_destekli, fraksiyon_insan	Toplam güven puanları yerine miktar alanlarını kullanın
maksimum_ai_olasılığı	fraksiyon_ai (önerilen)	Miktar alanları tercih edilir

Pencere değişiklikleri:

• İçinde metin kaydırma, pencereler üst üste binme
• V3'te pencereler üst üste binmez.

v2 Pencere Alanı	v3 Pencere Alanı
windows[].tahmin	windows[].etiket + windows[].güven
windows[].ai_olasılık	windows[].ai_yardım_puanı

---

Şuradan metin-genişletilmiş.api.pangram.com

Son 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şmeden
tahmin	Değişmeden
kısa_tahmin	Değişmeden
fraksiyon_insan	Değişmeden
fraksiyon_ai	Değişmeden
windows[].etiket	Değişmeden
windows[].güven	Değişmeden
windows[].başlangıç_indeksi	Değişmeden
windows[].son_indeksi	Değişmeden

Değişen alanlar:

v2 Alanı	v3 Alanı	Notlar
karışık kesir	fraksiyon_ai_destekli	Netlik için alanın adı değiştirildi
gösterge paneli	kamu_kontrol_paneli_bağlantısı	Netlik için alanın adı değiştirildi
ortalama_ai_olasılığı	fraksiyon_ai, fraksiyon_ai_destekli, fraksiyon_insan	Toplam güven puanları yerine miktar alanlarını kullanın
maksimum_ai_olasılığı	fraksiyon_ai, fraksiyon_ai_destekli, fraksiyon_insan	Toplam güven puanları yerine miktar alanlarını kullanın
windows[].ai_olasılık	windows[].ai_yardım_puanı	AI olasılığı ve AI yardım puanları bire bir değildir. Kullanım etiket rehberlik için.

---

Belgeleme

API belgelerinin tamamı burada mevcuttur.

---

Sorularınız mı var?

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