Bilgi Çıkarımı (Extract)

Bir metinden kişi, şirket, tarih, tutar gibi değerleri çekmek ya da metni önceden belirlediğiniz etiketlerle sınıflandırmak için bir sohbet modeline talimat yazıp çıktısını ayrıştırmanız gerekmez. /v1/extract uç noktasındaki modeller metni ve neyin çıkarılacağını tarif eden bir schema alır, sonucu tek geçişte JSON olarak döndürür. Varsayılan olarak metinden çekilen her parça bir güven değeri ve karakter konumuyla, her sınıflandırma bir güven değeriyle gelir.

Bu modeller metin üretmez ve sohbet etmez. Serbest biçimli bir yanıta ihtiyacınız varsa Chat Completions kullanın.

Model

Model	Bağlam	Giriş / Çıkış ($/1M token)
fastino/gliner2.5-multi-v1	4.096	0,03 / 0

fastino/gliner2.5-multi-v1 çok dillidir; Türkçe metin ve Türkçe etiket adlarıyla çalışır.

Katalogdaki çıkarım modellerini listelemek için:

curl -s "$LLMTR_BASE_URL/v1/models" \
  | jq -r '.data[] | select(.supported_operations[] == "EXTRACTION").id'

İstek

curl "$LLMTR_BASE_URL/v1/extract" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fastino/gliner2.5-multi-v1",
    "text": "Turkcell Genel Müdürü Ali Taha Koç yeni 5G paketini İstanbul basın toplantısında 299 TL fiyatla tanıttı.",
    "schema": {
      "entities": [
        { "name": "kişi", "description": "kişi adı" },
        { "name": "şirket", "description": "şirket adı" },
        "şehir"
      ],
      "classifications": [
        { "task": "duygu", "labels": ["olumlu", "olumsuz", "nötr"] }
      ]
    },
    "threshold": 0.5
  }'

Alan	Zorunlu	Açıklama
model	Evet	Çıkarım modelinin kimliği.
text	Evet	Çözümlenecek metin.
schema	Evet	Neyin çıkarılacağı. entities, classifications, structures ve relations anahtarlarından en az biri.
threshold	Hayır	0 ile 1 arasında güven eşiği, varsayılan 0,5. Düşük değer daha fazla sonuç, yüksek değer daha az ama daha kesin sonuç verir.
include_confidence	Hayır	Varsayılan true. false olursa güven değerleri dönmez.
include_spans	Hayır	Varsayılan true. false olursa start / end konumları dönmez.
max_budget_usd	Hayır	İstek öncesi tahmini maliyet kontrolü; tahmini maliyet bu değeri aşarsa istek gönderilmeden reddedilir.

Tablodaki alanlar dışındaki anahtarlar 400 invalid_request ile reddedilir.

Şema

Dört görev türü aynı istekte birlikte kullanılabilir; model hepsini aynı metin üzerinde tek geçişte çalıştırır.

Varlıklar

Etiket adlarının listesi. Açıklama eklemek, özellikle genel adlı etiketlerde sonucu iyileştirir.

{
  "entities": [
    { "name": "şirket", "description": "şirket veya kurum adı" },
    { "name": "ürün", "description": "ticari ürün veya paket" },
    "şehir"
  ]
}

Sınıflandırma

Her görev bir ad (task) ve seçilebilecek etiketleri (labels) taşır. multi_label: true birden fazla etiketin seçilmesine izin verir, top_k dönen etiket sayısını sınırlar.

{
  "classifications": [
    { "task": "duygu", "labels": ["olumlu", "olumsuz", "nötr"] },
    { "task": "konular", "labels": ["pil", "ekran", "fiyat", "kargo"], "multi_label": true, "top_k": 2 }
  ]
}

Yapılar

Metinden tiplenmiş kayıtlar çıkarır. Her alan ad::tip::açıklama biçiminde yazılır; tip str veya list olabilir.

{
  "structures": {
    "duyuru": [
      "urun::str::tanıtılan ürün",
      "fiyat::str::belirtilen fiyat",
      "tarih::str::duyuru tarihi"
    ]
  }
}

İlişkiler

İlişki adlarının listesi ya da ada göre açıklama ve eşik veren bir nesne. İlişki tanımına baş ve kuyruk varlığı yazılmaz; model ikisini de metinden kendisi bulur.

{
  "relations": ["works_for", "located_in"]
}

{
  "relations": {
    "works_for": { "description": "çalışma ilişkisi", "threshold": 0.6 }
  }
}

Yanıt

{
  "object": "extraction",
  "model": "fastino/gliner2.5-multi-v1",
  "result": {
    "entities": {
      "kişi": [{ "text": "Ali Taha Koç", "confidence": 1, "start": 22, "end": 34 }],
      "şirket": [{ "text": "Turkcell", "confidence": 0.99609375, "start": 0, "end": 8 }],
      "şehir": [{ "text": "İstanbul", "confidence": 0.99609375, "start": 52, "end": 60 }]
    },
    "duygu": { "label": "olumlu", "confidence": 0.95703125 }
  },
  "usage": { "input_tokens": 33, "output_tokens": 139 }
}

result içindeki anahtarlar şemanızdan gelir:

Şemada	result içinde
entities	entities altında, etiket adına göre bir liste
classifications	görev adıyla üst seviyede; { "label", "confidence" }, multi_label ise bu nesnelerin listesi
structures	yapı adıyla üst seviyede, her biri alan adına göre değerler taşıyan kayıtların listesi
relations	relation_extraction altında, ilişki adına göre { "head", "tail" } çiftlerinin listesi

start ve end, gönderdiğiniz text içindeki yarı açık karakter aralığıdır: start dahil, end hariç.

Eşleşme bulunmayan bir varlık etiketi boş liste olarak döner. Eşleşme bulunmayan bir yapı ise yanıtta hiç yer almayabilir; kodunuzda anahtarın varlığını varsaymayın.

include_spans: false gönderildiğinde varlıklar konum taşımaz ve aynı metin bir kez listelenir. include_confidence da false ise varlıklar düz metin listesi, sınıflandırmalar tek bir etiket metni olarak döner.

model alanı LLMTR katalog kimliğini döndürür.

Faturalandırma

Ücret yalnızca giriş tokenları üzerindendir ve faturalanan sayı yanıttaki usage.input_tokens değeridir. output_tokens genellikle sıfırdan büyük döner ama ücretsizdir; kendi token muhasebenizi kurarken bu alanı sıfır varsaymayın.

Model fiyatlarına platform marjı eklenmez; marj yalnızca kredi yüklemede geçerlidir. Ayrıntı için Faturalandırma sayfasına bakın.

Limitler

Metin ve şema birlikte istek başına 4.096 token ile sınırlıdır. Sınırı aşan istek kırpılmaz, 400 invalid_request ile reddedilir ve mesaj isteğin kaç token olduğunu söyler. Uzun belgeleri parçalara bölüp her parçayı ayrı istekle gönderin; start / end değerleri gönderdiğiniz parçaya göredir, belge içindeki konum için parçanın başlangıç konumunu ekleyin.

Her istek tek bir metni işler. Birden çok metni eş zamanlı ayrı isteklerle gönderin.

Model bir süre çağrılmadıysa ilk yanıt belirgin biçimde gecikebilir. İstemci zaman aşımını en az 300 saniye tutun.

İstek içeriği model sağlayıcısında saklanmaz. Bu nedenle store gibi saklama alanları kabul edilmez.

Bu uç nokta akış (streaming) desteklemez. Çıkarım modelleri Playground'da görünmez ve sohbet uçlarında çağrılamaz; fastino/gliner2.5-multi-v1 yalnızca /v1/extract üzerinde yanıt verir.

Hatalar

Durum	Anlamı
400 invalid_request	İstek gövdesi şemaya uymuyor ya da metin ve şema birlikte token sınırını aşıyor. Mesaj hangisi olduğunu söyler.
404 model_not_found	Model kimliği katalogda yok.
400 unsupported_operation	Model bu uç noktayı desteklemiyor. Yanıt, modelin desteklediği uç noktaları listeler.
422 invalid_request	Model bir alan değerini kabul etmedi. Mesaj hangi alan olduğunu söyler.
429 rate_limit_error	API anahtarının istek limiti aşıldı.
503 model_unavailable	Model geçici olarak yanıt veremiyor. Yanıt Retry-After başlığı taşıyorsa o süre kadar bekleyip tekrar deneyin.

Hata biçimi için Hatalar sayfasına bakın.