MyApp

<back to all web services

CreateDecision

AI

Decisions API (OpenRouter)

The following routes are available for this service:
POST/v1/decisions
using System;
using System.IO;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.Serialization;
using ServiceStack;
using ServiceStack.DataAnnotations;
using ServiceStack.AI;

namespace ServiceStack.AI
{
    ///<summary>
    ///Decisions API (OpenRouter)
    ///</summary>
    [DataContract]
    public partial class CreateDecision
        : IPost
    {
        ///<summary>
        ///The decision model, e.g. ~typesafe/jev-latest
        ///</summary>
        [DataMember(Name="model")]
        public virtual string Model { get; set; }

        ///<summary>
        ///The content to evaluate: a plain string, or a JSON object or array of related context
        ///</summary>
        [DataMember(Name="state")]
        public virtual Object State { get; set; }

        ///<summary>
        ///Named noul (yes/no probability), choice (one option) or score (ordered scale) questions
        ///</summary>
        [DataMember(Name="questions")]
        public virtual Dictionary<string, DecisionQuestion> Questions { get; set; } = new();

        ///<summary>
        ///A unique identifier for grouping related requests
        ///</summary>
        [DataMember(Name="session_id")]
        public virtual string? SessionId { get; set; }

        ///<summary>
        ///End-user identifier sent to OpenRouter. Omitted unless you set it.
        ///</summary>
        [DataMember(Name="user")]
        public virtual string? User { get; set; }

        ///<summary>
        ///OpenRouter provider routing preferences
        ///</summary>
        [DataMember(Name="provider")]
        public virtual Dictionary<string, Object>? Provider { get; set; }
    }

    [DataContract]
    public partial class DecisionAnswer
    {
        [DataMember(Name="type")]
        public virtual string Type { get; set; }

        ///<summary>
        ///noul: probability from 0 (no) to 1 (yes)
        ///</summary>
        [DataMember(Name="noul")]
        public virtual double? Noul { get; set; }

        ///<summary>
        ///choice: the selected option
        ///</summary>
        [DataMember(Name="choice")]
        public virtual string? Choice { get; set; }

        ///<summary>
        ///score: position on the scale, 0 = first description
        ///</summary>
        [DataMember(Name="score")]
        public virtual double? Score { get; set; }

        [DataMember(Name="confidence")]
        public virtual double? Confidence { get; set; }

        ///<summary>
        ///choice/score: probability of each option (score options are "0", "1", ...)
        ///</summary>
        [DataMember(Name="probabilities")]
        public virtual Dictionary<string, double>? Probabilities { get; set; }

        ///<summary>
        ///score: description of each scale position
        ///</summary>
        [DataMember(Name="legend")]
        public virtual Dictionary<string, string>? Legend { get; set; }
    }

    [DataContract]
    public partial class DecisionQuestion
    {
        ///<summary>
        ///noul, choice or score
        ///</summary>
        [DataMember(Name="type")]
        public virtual string Type { get; set; }

        ///<summary>
        ///What to decide: text, or a JSON object/array of guidance
        ///</summary>
        [DataMember(Name="instructions")]
        public virtual Object Instructions { get; set; }

        ///<summary>
        ///noul: {true,false} descriptions; choice: {option: description}; score: ordered descriptions
        ///</summary>
        [DataMember(Name="criteria")]
        public virtual Object? Criteria { get; set; }
    }

    [DataContract]
    public partial class DecisionResponse
    {
        [DataMember(Name="id")]
        public virtual string? Id { get; set; }

        [DataMember(Name="model")]
        public virtual string Model { get; set; }

        [DataMember(Name="provider")]
        public virtual string? Provider { get; set; }

        ///<summary>
        ///Answers by question name, validated against the submitted questions
        ///</summary>
        [DataMember(Name="answers")]
        public virtual Dictionary<string, DecisionAnswer> Answers { get; set; } = new();

        [DataMember(Name="usage")]
        public virtual DecisionUsage? Usage { get; set; }
    }

    [DataContract]
    public partial class DecisionUsage
    {
        [DataMember(Name="input_tokens")]
        public virtual long InputTokens { get; set; }

        [DataMember(Name="output_tokens")]
        public virtual long OutputTokens { get; set; }

        [DataMember(Name="cost")]
        public virtual double? Cost { get; set; }
    }

}

C# CreateDecision DTOs

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

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