| POST | /v1/decisions |
|---|
import Foundation
import ServiceStack
/**
* Decisions API (OpenRouter)
*/
// @DataContract
public class CreateDecision : IPost, Codable
{
/**
* The decision model, e.g. ~typesafe/jev-latest
*/
// @DataMember(Name="model")
public var model:String
/**
* The content to evaluate: a plain string, or a JSON object or array of related context
*/
// @DataMember(Name="state")
public var state:String
/**
* Named noul (yes/no probability), choice (one option) or score (ordered scale) questions
*/
// @DataMember(Name="questions")
public var questions:[String:DecisionQuestion] = [:]
/**
* A unique identifier for grouping related requests
*/
// @DataMember(Name="session_id")
public var session_id:String
/**
* End-user identifier sent to OpenRouter. Omitted unless you set it.
*/
// @DataMember(Name="user")
public var user:String
/**
* OpenRouter provider routing preferences
*/
// @DataMember(Name="provider")
public var provider:[String:String]
required public init(){}
}
// @DataContract
public class DecisionQuestion : Codable
{
/**
* noul, choice or score
*/
// @DataMember(Name="type")
public var type:String
/**
* What to decide: text, or a JSON object/array of guidance
*/
// @DataMember(Name="instructions")
public var instructions:String
/**
* noul: {true,false} descriptions; choice: {option: description}; score: ordered descriptions
*/
// @DataMember(Name="criteria")
public var criteria:String
required public init(){}
}
// @DataContract
public class DecisionResponse : Codable
{
// @DataMember(Name="id")
public var id:String
// @DataMember(Name="model")
public var model:String
// @DataMember(Name="provider")
public var provider:String
/**
* Answers by question name, validated against the submitted questions
*/
// @DataMember(Name="answers")
public var answers:[String:DecisionAnswer] = [:]
// @DataMember(Name="usage")
public var usage:DecisionUsage
required public init(){}
}
// @DataContract
public class DecisionAnswer : Codable
{
// @DataMember(Name="type")
public var type:String
/**
* noul: probability from 0 (no) to 1 (yes)
*/
// @DataMember(Name="noul")
public var noul:Double?
/**
* choice: the selected option
*/
// @DataMember(Name="choice")
public var choice:String
/**
* score: position on the scale, 0 = first description
*/
// @DataMember(Name="score")
public var score:Double?
// @DataMember(Name="confidence")
public var confidence:Double?
/**
* choice/score: probability of each option (score options are "0", "1", ...)
*/
// @DataMember(Name="probabilities")
public var probabilities:[String:Double]
/**
* score: description of each scale position
*/
// @DataMember(Name="legend")
public var legend:[String:String]
required public init(){}
}
// @DataContract
public class DecisionUsage : Codable
{
// @DataMember(Name="input_tokens")
public var input_tokens:Int
// @DataMember(Name="output_tokens")
public var output_tokens:Int
// @DataMember(Name="cost")
public var cost:Double?
required public init(){}
}
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
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: application/xml
Content-Type: application/xml
Content-Length: length
<CreateDecision xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ServiceStack.AI">
<model>String</model>
<provider xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d2p1:KeyValueOfstringanyType>
<d2p1:Key>String</d2p1:Key>
<d2p1:Value />
</d2p1:KeyValueOfstringanyType>
</provider>
<questions xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d2p1:KeyValueOfstringDecisionQuestionPZTEmqZr>
<d2p1:Key>String</d2p1:Key>
<d2p1:Value>
<criteria />
<instructions />
<type>String</type>
</d2p1:Value>
</d2p1:KeyValueOfstringDecisionQuestionPZTEmqZr>
</questions>
<session_id>String</session_id>
<state />
<user>String</user>
</CreateDecision>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length
<DecisionResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ServiceStack.AI">
<answers xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d2p1:KeyValueOfstringDecisionAnswerPZTEmqZr>
<d2p1:Key>String</d2p1:Key>
<d2p1:Value>
<choice>String</choice>
<confidence>0</confidence>
<legend>
<d2p1:KeyValueOfstringstring>
<d2p1:Key>String</d2p1:Key>
<d2p1:Value>String</d2p1:Value>
</d2p1:KeyValueOfstringstring>
</legend>
<noul>0</noul>
<probabilities>
<d2p1:KeyValueOfstringdouble>
<d2p1:Key>String</d2p1:Key>
<d2p1:Value>0</d2p1:Value>
</d2p1:KeyValueOfstringdouble>
</probabilities>
<score>0</score>
<type>String</type>
</d2p1:Value>
</d2p1:KeyValueOfstringDecisionAnswerPZTEmqZr>
</answers>
<id>String</id>
<model>String</model>
<provider>String</provider>
<usage>
<cost>0</cost>
<input_tokens>0</input_tokens>
<output_tokens>0</output_tokens>
</usage>
</DecisionResponse>