Pangram 3.0 API Geçiş Kılavuzu
Pangram’ın v2 uç noktalarından yeni v3 API’ye nasıl geçiş yapılır: nelerin değiştiği, yeni yanıt alanları ve sorunsuz bir yükseltme için ihtiyacınız olan her şey.
İçindekiler
- v3'teki yenilikler nelerdir?
- Önemli Şema Değişiklikleri
- Pencere Düzeyinde Analiz
- Taşınmalı mıyım?
- Zaman çizelgesi
- V2 Uç Noktaları (1 Nisan 2026'ya kadar kullanılabilir)
- Saha Göç Rehberi
- text.api.pangram.com adresinden
- text-batch.api.pangram.com adresinden
- text-sliding.api.pangram.com adresinden
- text-extended.api.pangram.com adresinden
- Belgeler
- Sorularınız mı var?
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ı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ı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
| 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ı |
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.comtext-batch.api.pangram.comtext-sliding.api.pangram.comtext-extended.api.pangram.comdashboard-text.api.pangram.com
Saha Göç Rehberi
Kaynak: text.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 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.
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.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:
- İçinde
metin kaydırma, pencereler üst üste binen - v3 sürümünde pencereler birbiriyle çakışmaz
| v2 Pencere Alanı | v3 Pencere Alanı |
|---|---|
windows[].tahmin | windows[].etiket + windows[].güven |
windows[].ai_likelihood | windows[].ai_yardım_puanı |
Kaynak: text-extended.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ş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. |
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, 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.
İlgili makaleler
Pangram 4 Teknik Genel Bakış
Etiketler ve Gruplar
Yeni Pangram Ürün Seviyeleri
İnsancı nedir?
Pangram, akıl yürütme modellerini ne kadar iyi tespit edebiliyor?
