MyApp

<back to all web services

CreateDecision

AI

Decisions API (OpenRouter)

The following routes are available for this service:
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(){}
}


Swift CreateDecision DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + 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>