Upstage: Solar Decide API Reference

About

Upstage Solar Decide is a beta decision model served by Upstage on Solar Mini 4 for classification, routing, and policy checks. It reads text or JSON and returns typed decisions and probabilities for Noul, Choice, and Score questions without generating prose. The official context window is 512K tokens, and Choice accepts 2–26 options. Output tokens are reported by the API but are free of charge.

1. Calling the API

Setup your API Key

To begin using Infron, create an account and generate your API Key.

export INFRON_KEY="YOUR_API_KEY"

Submit a request

Send JSON to POST https://llm.onerouter.pro/v1/decisions using your Infron API key. This is a runnable request example; route availability depends on your deployment.

curl --request POST "https://llm.onerouter.pro/v1/decisions" \
  --header "Authorization: Bearer $INFRON_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "upstage/solar-decide",
  "state": "A customer reports being charged twice and asks for a refund today.",
  "questions": {
    "billing": {
      "type": "noul",
      "instructions": "Is this request about billing?"
    },
    "team": {
      "type": "choice",
      "instructions": "Which team should handle it?",
      "criteria": {
        "billing": "Payments and refunds",
        "technical": "Software support"
      }
    },
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this request?",
      "criteria": [
        "Can wait",
        "Handle today",
        "Immediate emergency"
      ]
    }
  },
  "provider": {
    "only": [
      "upstage"
    ],
    "allow_fallbacks": false
  },
  "usage": {
    "include": true
  }
}'

Response

The following single-answer response illustrates the schema. Its request ID, probabilities, and usage are placeholders, not a captured call.

{
  "id": "request_id_example",
  "request_id": "request_id_example",
  "model": "upstage/solar-decide",
  "answers": {
    "billing": {
      "type": "noul",
      "noul": 0.97
    }
  },
  "usage": {
    "input_tokens": 100,
    "output_tokens": 1
  }
}

Routing and usage

provider and usage.include are Infron fields. They are not forwarded to the upstream provider. Set provider.only to ["upstage"] and provider.service_tier to "standard" to select this route. usage.include=true includes cost information. Charges use the actual upstream usage.input_tokens; output tokens are free and their actual count is preserved.

Errors

Invalid parameter types or configured limits are rejected before the upstream request. Provider authentication, account, context, and media errors propagate through the existing gateway error handling. The service does not silently truncate the configured question or image arrays. Streaming and asynchronous task polling are unavailable.

2. Schema

Input

ParameterTypeRequiredDefaultRangeDescription
modelstringYes--upstage/solar-decidePublic model ID; upstream selector is solar-decide.
statestring / object / array / number / boolean / nullYes--See provider contractShared content for the questions.
questionsobjectYes--At least one entryNamed questions; names are retained in the response.
questions.<id>.typestringYes--noul, choice, scoreQuestion type.
questions.<id>.instructionsstring / object / arrayConditional--See Question typesWhat to evaluate; no default is injected.
questions.<id>.criteriaobject / arrayFor choice and score--See Question typesOptions or an ordered rubric.
providerobjectNo----Platform routing options.
usage.includebooleanNofalsetrue, falseInclude platform cost details.

Question types

Noul returns a yes probability. Choice accepts 2–26 options; Score accepts one or more ordered levels, indexed from zero. Choice requires an option map; Score requires an array. Instructions and criteria describe the task according to the upstream contract; Noul requires a meaningful question through instructions or criteria. The official model page states a 512K context window without an exact token integer.

Media inputs

Image inputs are not declared for this hosted route.

Output

ParameterTypeRangeDescription
id, request_idstring--Platform request ID.
modelstring--Public model ID.
provider, service_tierstring--Selected route.
answersobjectRequest question IDsTyped upstream answers.
answers.<id>.typestringnoul, choice, scoreAnswer type.
answers.<id>.noulnumber0–1Yes probability.
answers.<id>.choicestringChoice keysSelected option.
answers.<id>.scorenumber0 to levels minus 1Probability-weighted level.
answers.<id>.confidencenumber0–1Choice/Score confidence.
answers.<id>.probabilitiesobjectValues 0–1Probability distribution.
answers.<id>.legendobject--Score level descriptions.
usage.input_tokens, usage.output_tokensintegerNon-negativeActual upstream usage.
costnumberUSDCharge details when requested.
cost_detailsobject--Billing breakdown when requested.

3. Detailed Pricing

ModelBilling unitInput priceOutput price
Upstage Solar DecidePer 1 million tokens$0.10Free

This is the undiscounted base price; no promotional discount is configured. Charges use the actual upstream usage.input_tokens; output tokens are free and their actual count is preserved. Cached input has the same $0.10/M rate. Official pricing.