Upstage Solar

Solar, Upstage'in ajan is akislari icin ayarlanmis model ailesidir. Asagidaki tablodaki tum satirlar /v1/chat/completions uzerinden cagrilir ve yalnizca metin girdisi alir; gorsel ve ses girdisi desteklenmez. Solar Mini 4 ailenin kompakt uyesidir (toplam 35B, 3B aktif parametre) ve yuksek hacimli, maliyete duyarli ajan isleri icindir.

Model	Baglam	Maksimum cikti
upstage/solar-pro4	524.288	131.072
upstage/solar-mini4	524.288	baglam penceresiyle ortak
upstage/solar-pro3	131.072	baglam penceresiyle ortak
upstage/solar-pro2	65.536	baglam penceresiyle ortak

Solar Decide icin Yapilandirilmis Kararlar sayfasina bakin.

Yalnizca Solar Pro 4'un baglam penceresinden ayri, zorlanan bir cikti tavani vardir: max_tokens 131.072'yi asarsa istek reddedilir. Diger uc modelde uretilen tokenlar ayni baglam penceresinden harcanir, yani uzun bir istemden sonra kalan cikti butcesi daralir. Upstage, Solar Mini 4 icin tek yanitta 128K tokene kadar cikti belirtir; bu deger istek reddiyle zorlanmiyor, dolayisiyla uzun ciktilarda finish_reason alanini kontrol edin.

curl "$LLMTR_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "upstage/solar-pro4",
    "messages": [
      { "role": "user", "content": "Bu fonksiyondaki hatayi bul." }
    ],
    "max_tokens": 2048
  }'

Reasoning effort

Tum Solar modellerinde dusunme varsayilan olarak kapalidir. reasoning_effort gondermezseniz model dogrudan yanit verir ve reasoning tokeni uretmez.

Onemli olan nokta: kabul edilen seviye kumesi her modelde farklidir.

Model	Kabul edilen seviyeler
upstage/solar-pro4	none, minimal, low, medium, high, xhigh, max
upstage/solar-mini4	none, minimal, low, medium, high, xhigh, max
upstage/solar-pro3	none, minimal, low, medium, high
upstage/solar-pro2	minimal, low, medium, high

Solar Pro 2'de none seviyesi yoktur. Solar Pro 3 ve Pro 2'de xhigh ve max yoktur. Bu modellere desteklenmeyen bir seviye gonderirseniz istek 400 ile reddedilir ve hata mesaji o modelin gercek seviye listesini verir.

Seviye vermek dusunmeyi acmaya yetmez

Her seviye dusunmeyi tetiklemez. Model, esik seviyesinin altindaki degerleri kabul eder, 200 doner ve hic reasoning tokeni uretmez:

Model	Reasoning uretmeyen seviyeler	Dusunmenin basladigi seviye
upstage/solar-pro4	none, minimal	low
upstage/solar-mini4	none, minimal	low
upstage/solar-pro3	none, minimal, low	medium
upstage/solar-pro2	minimal, low	medium

Yani Solar Pro 3'e reasoning_effort: "low" gondermek, dusunme aciyor gibi gorunse de aslinda dusunmesiz bir yanit uretir. Dusunme istiyorsaniz Pro 3 ve Pro 2'de en az medium verin.

Efor, model kimligine suffix olarak da verilebilir:

upstage/solar-pro4          -> varsayilan (dusunme kapali)
upstage/solar-pro4:none     -> kabul edilir, dusunmez
upstage/solar-pro4:low      -> dusunme burada baslar
upstage/solar-pro4:high     -> yuksek efor
upstage/solar-pro4:max      -> en yuksek efor
upstage/solar-mini4:low     -> Mini 4'te de dusunme burada baslar
upstage/solar-pro3:medium   -> Pro 3'te dusunme burada baslar
upstage/solar-pro2:medium   -> Pro 2'de dusunme burada baslar

curl "$LLMTR_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "upstage/solar-pro4",
    "messages": [{ "role": "user", "content": "17 * 23 kac eder?" }],
    "reasoning_effort": "medium",
    "max_tokens": 2048
  }'

Reasoning effort'un genel davranisi icin reasoning effort sayfasina bakin.

Dusunce izi

Solar Pro 4, Solar Mini 4 ve Solar Pro 3, dusunme aciksa dusunce izini yanitin reasoning alaninda ayrica dondurur ve streaming sirasinda parca parca gonderir.

Solar Pro 2 dusunce izini dondurmez. Reasoning tokenlari yine uretilir, usage.completion_tokens_details.reasoning_tokens alaninda sayilir ve cikti olarak ucretlendirilir; yani bu modelde dusunmenin maliyetini gorursunuz ama icerigini goremezsiniz.

max_tokens ile birlikte kullanim

Reasoning tokenlari completion_tokens icinde sayildigi icin max_tokens butcesini de tuketirler. Dusunme aciksa ve butce dusukse, model asil yaniti uretmeden butce biter:

max_tokens	finish_reason
16	length
64	length
256	stop

Dusunme aciksa max_tokens degerini en az 200-250 tutun. Kisa bir yanit bekliyor olmaniz bunu degistirmez; butce once dusunmeye harcanir. Dusunmeye ihtiyaciniz yoksa reasoning_effort gondermeyin; dusunme varsayilan olarak kapalidir ve kucuk butceler sorunsuz calisir.

Solar Mini 4'te bu alt sinir yetmez: dusunme aciksa max_tokens icin 2.000 ve ustu bir butce verin. Buyuk butce de garanti degildir; ayni istemde dusunme uzunlugu degisir. finish_reason: "length" ve bos content aldiysaniz istegi daha dusuk bir seviyeyle ya da reasoning_effort gondermeden tekrarlayin.

Arac cagrisi

Tum Solar modelleri arac/fonksiyon cagrisini destekler ve tool_choice alaninin tum degerlerini kabul eder: varsayilan (auto), required, none ve isimli fonksiyon secimi.

Tek yanitta birden fazla arac cagrisi gelebilir, ancak bu garanti degildir ve modele gore degisir. Istemcinizi iki durumu da isleyecek sekilde yazin: donen her cagriyi cevaplayin, eksik kalan bilgi icin ikinci tur atin.

curl "$LLMTR_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "upstage/solar-pro4",
    "messages": [{ "role": "user", "content": "Istanbul hava durumu?" }],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Bir sehrin guncel hava durumunu dondurur",
        "parameters": {
          "type": "object",
          "properties": { "city": { "type": "string" } },
          "required": ["city"]
        }
      }
    }],
    "tool_choice": "required"
  }'

Arac sonucunu ikinci turda role: "tool" mesajiyla geri verdiginizde model sonucu metne cevirir. Genel akis icin arac cagrisi sayfasina bakin.

Yapilandirilmis cikti

Tum Solar modelleri response_format ile hem JSON nesne ciktisini hem de semaya uyan yapilandirilmis ciktiyi destekler.

curl "$LLMTR_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "upstage/solar-pro4",
    "messages": [{ "role": "user", "content": "Ankara hangi ulkede?" }],
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "city_info",
        "strict": true,
        "schema": {
          "type": "object",
          "properties": {
            "city": { "type": "string" },
            "country": { "type": "string" }
          },
          "required": ["city", "country"],
          "additionalProperties": false
        }
      }
    }
  }'

Prompt cache

Ayni istem onekini tekrar gonderdiginizde onbellek devreye girer ve o tokenlar indirimli cache fiyatindan ucretlendirilir. Onbellege alinan token sayisi yanitta prompt_tokens_details.cached_tokens alaninda doner. Onbellek bir indirimdir, garanti degildir; isabet orani istem uzunluguna ve trafige gore degisir.

Fiyatlandirma

Guncel birim fiyatlar her modelin kendi sayfasinda gosterilir; asagidaki tablo referans icindir.

upstage/solar-pro3 ve upstage/solar-pro2 icin, 1M token basina USD:

Metric	$/1M
Input	0.15
Input (cached)	0.015
Output	0.60

upstage/solar-pro4 icin Upstage uc adimli bir indirim uyguluyor. 2026-10-11 UTC itibariyla gecerli olan %50 indirimin bitis tarihi duyurulmadi; liste fiyati 0.30 / 0.06 / 1.20'dir ve Upstage bir tarih yayinladiginda o tarihten itibaren gecerli olur. Her gecis kendiliginden olur, gateway tarafinda bir islem gerekmez:

Metric	2026-09-11 UTC oncesi	2026-09-11 - 2026-10-11 UTC	2026-10-11 UTC ve sonrasi
Input	0.03	0.09	0.15
Input (cached)	0.006	0.018	0.03
Output	0.12	0.36	0.60

upstage/solar-mini4 icin lansman indirimi iki adimlidir ve 2026-10-23 00:00 UTC aninda sona erer; o andan itibaren standart fiyatlar gecerlidir:

Metric	2026-10-11 00:00 UTC oncesi	2026-10-11 00:00 UTC - 2026-10-23 00:00 UTC	2026-10-23 00:00 UTC ve sonrasi
Input	0.03	0.05	0.10
Input (cached)	0.003	0.005	0.01
Output	0.12	0.20	0.40

Model fiyatlarina platform marji eklenmez; marj yalnizca kredi yuklemede gecerlidir.

Dil destegi

Upstage bu modeller icin Ingilizce, Korece ve Japonca destegini resmi olarak belirtir. Turkce istemler pratikte calisir, ancak resmi destek listesinde degildir.

Desteklenmeyenler

• Gorsel girdi: image_url icerik parcasi 400 ile reddedilir.
• Ses girdi: input_audio icerik parcasi 400 ile reddedilir.
• stop: uc alani kabul eder ama uygulamaz; uretim durdurma dizisinin otesine devam eder. Kesme gerekiyorsa ciktiyi kendi tarafinizda kirpin.
• Istek govdesinde reasoning alani: kullanmayin, reasoning_effort kullanin. Gateway reasoning: { "effort": ... } seklindeki nesneyi kabul edip reasoning_effort alanina cevirir, boylece uca sizmaz.

Veri islenmesi

Solar istekleri Upstage altyapisinda islenir; Turkiye'de barindirilan bir LLMTR modeli degildir. Upstage bu API'de istem ve yanitlari egitim icin kullanmadigini ve saklamadigini belirtir.

Solar Pro 3 ve Solar Pro 2'nin kapanmasi

Upstage upstage/solar-pro3 ve upstage/solar-pro2 modellerini 2026-10-30 (Kore saati) tarihinde kapatiyor. Bu iki model 2026-10-29 15:00 UTC (TSI 18:00) itibariyla 410 model_retired doner; hata yaniti yerine gecilecek modeli (upstage/solar-pro4) bildirir. O ana kadar ikisi de bugunku fiyat ve davranisla calisir.

upstage/solar-pro4'e gecerken model kimligi disinda iki sey degisir:

• Dusunme low seviyesinde baslar. Pro 3 ve Pro 2'de low dusunmesiz yanit veriyordu; Pro 4'te ayni sonucu minimal verir. reasoning_effort gondermiyorsaniz bir sey degismez, dusunme yine kapalidir.
• Onbellekten okunan girdi daha pahalidir. Diger fiyatlar icin yukaridaki tabloya bakin.

upstage/solar-mini4 her metrikte daha ucuzdur, ancak kompakt bir modeldir; gecmeden once kendi isinizde deneyin.