Upstage Solar

Solar, Upstage'in ajan is akislari icin ayarlanmis model ailesidir. Uc satiri /v1/chat/completions uzerinden cagrilir. Ucu de metin girdisi alir; gorsel ve ses girdisi desteklemez.

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

Yalnizca Solar Pro 4'un baglam penceresinden ayri bir cikti tavani vardir. Pro 3 ve Pro 2'de uretilen tokenlar da ayni baglam penceresinden harcanir, yani uzun bir istemden sonra kalan cikti butcesi daralir.

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

Ucunde de 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-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-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-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 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.

Arac cagrisi

Uc model de arac/fonksiyon cagrisini destekler ve tool_choice alaninin tum degerlerini kabul eder: varsayilan (auto), required, none ve isimli fonksiyon secimi.

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

Uc model de 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-pro3",
    "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 bir lansman indirimi uyguluyor. Indirim 2026-09-11 UTC tarihinde sona erer; o andan itibaren standart fiyatlar gecerlidir. Gecis kendiliginden olur, gateway tarafinda bir islem gerekmez:

Metric	2026-09-11 UTC oncesi	2026-09-11 UTC ve sonrasi
Input	0.03	0.30
Input (cached)	0.006	0.06
Output	0.12	1.20

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.
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.