| 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 .other suffix or ?format=other
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/jsonl
Content-Type: text/jsonl
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/jsonl
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}}