| POST | /v1/decisions |
|---|
import datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum
Object = TypeVar('Object')
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DecisionAnswer:
type: Optional[str] = None
noul: Optional[float] = None
"""
noul: probability from 0 (no) to 1 (yes)
"""
choice: Optional[str] = None
"""
choice: the selected option
"""
score: Optional[float] = None
"""
score: position on the scale, 0 = first description
"""
confidence: Optional[float] = None
probabilities: Optional[Dict[str, float]] = None
"""
choice/score: probability of each option (score options are "0", "1", ...)
"""
legend: Optional[Dict[str, str]] = None
"""
score: description of each scale position
"""
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DecisionUsage:
input_tokens: int = 0
output_tokens: int = 0
cost: Optional[float] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DecisionResponse:
id: Optional[str] = None
model: Optional[str] = None
provider: Optional[str] = None
answers: Dict[str, DecisionAnswer] = field(default_factory=dict)
"""
Answers by question name, validated against the submitted questions
"""
usage: Optional[DecisionUsage] = None
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DecisionQuestion:
type: Optional[str] = None
"""
noul, choice or score
"""
instructions: Optional[Object] = None
"""
What to decide: text, or a JSON object/array of guidance
"""
criteria: Optional[Object] = None
"""
noul: {true,false} descriptions; choice: {option: description}; score: ordered descriptions
"""
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class CreateDecision(IPost):
"""
Decisions API (OpenRouter)
"""
model: Optional[str] = None
"""
The decision model, e.g. ~typesafe/jev-latest
"""
state: Optional[Object] = None
"""
The content to evaluate: a plain string, or a JSON object or array of related context
"""
questions: Dict[str, DecisionQuestion] = field(default_factory=dict)
"""
Named noul (yes/no probability), choice (one option) or score (ordered scale) questions
"""
session_id: Optional[str] = None
"""
A unique identifier for grouping related requests
"""
user: Optional[str] = None
"""
End-user identifier sent to OpenRouter. Omitted unless you set it.
"""
provider: Optional[Dict[str, Object]] = None
"""
OpenRouter provider routing preferences
"""
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /v1/decisions HTTP/1.1
Host: vue-spa.web-templates.io
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
model: String,
state: {},
questions:
{
String:
{
type: String,
instructions: {},
criteria: {}
}
},
session_id: String,
user: String,
provider:
{
String: {}
}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
id: String,
model: String,
provider: String,
answers:
{
String:
{
type: String,
noul: 0,
choice: String,
score: 0,
confidence: 0,
probabilities:
{
String: 0
},
legend:
{
String: String
}
}
},
usage:
{
input_tokens: 0,
output_tokens: 0,
cost: 0
}
}