Entegrasyon rehberleri · 2026-10-12

Alice AI LLM Flash'ta istem önbelleği: cached_tokens ve maliyet

yandex/alice-ai-llm-flash'ta tekrarlanan istem başı önbellekten okunabilir ve girdi fiyatının dörtte biriyle faturalanır. İstemi kurmak ve cached_tokens'ı okumak.

Şema: aynı istem başı https://llmtr.com/v1 adresine iki kez gönderiliyor; ikinci istekte bu baş önbellekten okunuyor.

Kısa yanıt: tekrarlanan istem başı dörtte bir fiyatla faturalanır

LLMTR (llmtr.com), Türkiye'de ve global sağlayıcılarda barındırılan dil modellerine tek, OpenAI uyumlu API'den erişim veren bir gateway'dir. Alice AI LLM Flash'ı yandex/alice-ai-llm-flash kimliğiyle, https://llmtr.com/v1 adresindeki /v1/chat/completions uç noktası üzerinden çağırırsınız. Bu modelde, önceki isteklerle aynı başlayan bir istemin tekrarlanan başı önbellekten okunabilir. Önbellekten okunan token'lar 1 milyon token başına 0,204918 $ ile, yani 0,819672 $ olan girdi fiyatının dörtte biriyle faturalanır.

Önbellek isabeti olduğunda yanıtın usage.prompt_tokens_details.cached_tokens alanı önbellekten okunan token sayısını taşır; bu token'lar prompt_tokens toplamının içindedir. İsabet garanti değildir. Sizin kontrol ettiğiniz şey istemin düzenidir: sabit kısım başta ve bayt bayt aynı, değişen içerik sonda.

Alice AI LLM Flash'ta istem önbelleği maliyeti nasıl düşürür?

Bir sohbet isteğinin girdisi iki parçadan oluşur. İstem başı her istekte aynı kalan kısımdır: sistem istemi, sabit talimatlar, örnekler, bir politika belgesi. Değişen kısım ise kullanıcının sorusu ya da o isteğe özel veridir. Aynı başla gelen sonraki bir istekte bu baş önbellekten okunabilir; okunan token'lar 0,204918 $, girdinin geri kalanı 0,819672 $, çıktı 1,639344 $ fiyatından faturalanır.

Kazanç, isteğin ne kadarının önbellekten okunduğuna bağlıdır: uzun ve sabit bir baş taşıyan istekte fark büyüktür, kısa bir istemde küçüktür. Bağlam penceresi 65.536 token'dır; sabit baş ile değişen kısım birlikte bu pencereye sığmalıdır.

Katalogdaki Yandex modelleri arasında bu indirim yalnızca Alice AI LLM Flash'ta vardır; Alice AI LLM, YandexGPT 5.1 Pro, YandexGPT 5 Pro ve YandexGPT 5 Lite'ta önbellek indirimi yoktur.

yandex/alice-ai-llm-flash fiyatları, 1M token başına USD (katalog, 2026-10-12)
KalemFiyat (1M token)Hangi token'lara uygulanır
Girdi0,819672 $Önbellekten okunmayan istem token'ları
Önbellekten okunan girdi0,204918 $usage.prompt_tokens_details.cached_tokens içindeki token'lar
Çıktı1,639344 $Yanıtın completion_tokens değeri

İstemi önbellek isabetine göre kurmak

Önbellek tekrarlanan istem başına uygulanır; bu yüzden sıra önemlidir. Her istekte aynı kalan her şeyi başa, değişen her şeyi sona koyun ve baştaki metni bayt bayt aynı tutun.

Çok turlu bir sohbette önceki mesajları değiştirmeden ve aynı sırayla geri gönderin, yeni mesajı sona ekleyin; böylece önceki turlar da tekrarlanan başın parçası olur.

  • Sistem istemini kodda tek bir sabitten üretin ve her istekte aynı metni gönderin.
  • Tarih, saat, kullanıcı adı ya da istek numarası gibi değişen değerleri sistem istemine gömmeyin; bunları kullanıcı mesajına taşıyın.
  • Sabit belgeleri ve örnekleri sistem isteminin hemen arkasına, her seferinde aynı sırayla koyun.
  • Boşluk, satır sonu ya da noktalama farkı da metni değiştirir; şablonu her istekte yeniden biçimlendirmeyin.
  • Kullanıcının sorusunu ve isteğe özel veriyi en sona koyun.

cached_tokens değerini Python ile okumak

Aşağıdaki örnek OpenAI Python SDK'sıyla aynı uzun sistem istemini iki ayrı soruyla gönderir ve her yanıtın usage değerlerini yazdırır. Sistem istemi dosyadan bir kez okunur ve iki istekte de aynı metin kullanılır; değişen kısım olan soru en sondadır.

İsabet olmayan bir yanıtta alan gelmeyebilir; kod bu yüzden değeri getattr ile okur ve yokluğu 0 sayar. İkinci istekte istem başı önbellekten okunduysa cached_tokens sıfırdan büyüktür ve prompt_tokens içinde yer alır, ona eklenmez. İsabet garanti olmadığı için ikinci istekte de 0 görebilirsiniz; bu bir hata değildir, o istek tam girdi fiyatından faturalanır.

Aynı uzun sistem istemini iki kez gönderen ve her yanıtta usage.prompt_tokens_details.cached_tokens değerini yazdıran OpenAI Python SDK örneği.

import os
from openai import OpenAI

client = OpenAI(base_url="https://llmtr.com/v1", api_key=os.environ["LLMTR_API_KEY"])

# Fixed part: the same text, byte for byte, at the start of every request.
with open("store_policy.txt", encoding="utf-8") as f:
    SYSTEM_PROMPT = "Answer customer questions using only this policy. " + f.read()


def ask(question: str) -> str:
    response = client.chat.completions.create(
        model="yandex/alice-ai-llm-flash",
        messages=[
            {"role": "system", "content": SYSTEM_PROMPT},
            {"role": "user", "content": question},  # varying part goes last
        ],
        max_tokens=500,
    )
    usage = response.usage
    details = getattr(usage, "prompt_tokens_details", None)
    cached = getattr(details, "cached_tokens", None) or 0
    print("prompt_tokens:", usage.prompt_tokens,
          "cached_tokens:", cached,
          "completion_tokens:", usage.completion_tokens)
    return response.choices[0].message.content


ask("Can I return an opened item?")
ask("How long does a refund take?")

Maliyet örneği: 10.000 token'lık istemin 8.000 token'ı önbellekten

10.000 token'lık bir istemin 8.000 token'ı önbellekten okunsun ve yanıt 500 token olsun: (2.000 x 0,819672 + 8.000 x 0,204918 + 500 x 1,639344) / 1.000.000 = 0,004098 $. Aynı tur önbellek isabeti olmadan (10.000 x 0,819672 + 500 x 1,639344) / 1.000.000 = 0,009016 $ tutar.

Böyle 1.000 tur, önbellek isabetiyle 4,09836 $, isabetsiz 9,016392 $ eder; aradaki fark 4,918032 $.

LLMTR'deki 1M token fiyatları Yandex'in yayımladığı USD liste fiyatlarıyla aynıdır; Yandex fiyatı 1.000 token başına verir, katalog aynı fiyatı 1M token başına yazar (2026-10-12'de kontrol edildi). Bu modelin fiyatına marj eklenmez; LLMTR'nin %8 platform payı yalnızca kredi yüklerken alınır.

yandex/alice-ai-llm-flash, 10.000 token'lık istem ve 500 token'lık yanıt (katalog fiyatları, 2026-10-12)
DurumÖnbellekten okunmayan girdiÖnbellekten okunan girdiÇıktıTek tur1.000 tur
Önbellek isabeti2.000 token8.000 token500 token0,004098 $4,09836 $
İsabet yok10.000 token0 token500 token0,009016 $9,016392 $

Sınırlar ve LLMTR'de başlamak

Alice AI LLM Flash yalnızca metin kabul eder; görsel içeren istek 400 unsupported_input ile reddedilir ve ücretlendirilmez. reasoning_effort gönderilen istek 400 invalid_request döndürür. finish_reason değeri length ise yanıt kesilmiştir; max_tokens değerini artırıp yeniden deneyin. Akışta (stream: true) usage, stream_options.include_usage gönderildiğinde yanıtın sonunda gelir.

Başlamak için llmtr.com'da hesap açın ve ön ödemeli kredi yükleyin, Dashboard > API Anahtarları altında bir anahtar oluşturun ve SDK'da base_url olarak https://llmtr.com/v1 kullanın. Ham anahtar yalnızca bir kez gösterilir; LLMTR_API_KEY gibi bir ortam değişkeninde saklayın. Aynı anahtar katalogdaki her modelde çalışır.

Alice AI LLM Flash'ı LLMTR'de istem önbelleğiyle kullanmaya başlamak

Hesap açın, anahtar oluşturun ve yandex/alice-ai-llm-flash'a sabit sistem istemi başta olacak şekilde ilk isteği gönderin.

  1. Hesap ve kredi. llmtr.com'da hesap açın ve ön ödemeli kredi yükleyin.
  2. API anahtarı. Dashboard > API Anahtarları altında bir anahtar oluşturun. Ham anahtar bir kez gösterilir; LLMTR_API_KEY ortam değişkeninde saklayın.
  3. İlk istek. SDK'da base_url olarak https://llmtr.com/v1, model olarak yandex/alice-ai-llm-flash verin ve sabit sistem istemini başa koyarak ilk isteği gönderin.

Sık sorulan sorular

Alice AI LLM Flash'ta önbellek isabeti garanti mi?

Hayır. Aynı istem başı tekrar gönderildiğinde önbellekten okunabilir, ama bu garanti değildir. İsabet olmayan istekte girdinin tamamı 0,819672 $ fiyatından faturalanır.

Önbellekten okunan token'ları nerede görürüm?

Yanıtın usage.prompt_tokens_details.cached_tokens alanında. Bu token'lar prompt_tokens toplamının içindedir; önbellekten okunan kısım 0,204918 $, girdinin geri kalanı 0,819672 $ fiyatından faturalanır.

Diğer Yandex modellerinde önbellek indirimi var mı?

Hayır. LLMTR kataloğundaki Yandex modelleri arasında önbellek indirimi yalnızca Alice AI LLM Flash'ta vardır. Alice AI LLM, YandexGPT 5.1 Pro, YandexGPT 5 Pro ve YandexGPT 5 Lite'ta yoktur.

İlgili yazılar