MyApp

<back to all web services

CreateDecision

AI

Decisions API (OpenRouter)

The following routes are available for this service:
POST/v1/decisions
package dtos

// @DataContract
type DecisionAnswer struct {
	// @DataMember(Name="type")
	Type string `json:"type"`
	/** @description noul: probability from 0 (no) to 1 (yes) */
	// @DataMember(Name="noul")
	Noul *float64 `json:"noul,omitempty"`
	/** @description choice: the selected option */
	// @DataMember(Name="choice")
	Choice *string `json:"choice,omitempty"`
	/** @description score: position on the scale, 0 = first description */
	// @DataMember(Name="score")
	Score *float64 `json:"score,omitempty"`
	// @DataMember(Name="confidence")
	Confidence *float64 `json:"confidence,omitempty"`
	/** @description choice/score: probability of each option (score options are "0", "1", ...) */
	// @DataMember(Name="probabilities")
	Probabilities map[string]float64 `json:"probabilities,omitempty"`
	/** @description score: description of each scale position */
	// @DataMember(Name="legend")
	Legend map[string]string `json:"legend,omitempty"`
}

// @DataContract
type DecisionUsage struct {
	// @DataMember(Name="input_tokens")
	InputTokens int64 `json:"input_tokens,omitempty"`
	// @DataMember(Name="output_tokens")
	OutputTokens int64 `json:"output_tokens,omitempty"`
	// @DataMember(Name="cost")
	Cost *float64 `json:"cost,omitempty"`
}

// @DataContract
type DecisionResponse struct {
	// @DataMember(Name="id")
	Id *string `json:"id,omitempty"`
	// @DataMember(Name="model")
	Model string `json:"model"`
	// @DataMember(Name="provider")
	Provider *string `json:"provider,omitempty"`
	/** @description Answers by question name, validated against the submitted questions */
	// @DataMember(Name="answers")
	Answers map[string]DecisionAnswer `json:"answers"`
	// @DataMember(Name="usage")
	Usage *DecisionUsage `json:"usage,omitempty"`
}

// @DataContract
type DecisionQuestion struct {
	/** @description noul, choice or score */
	// @DataMember(Name="type")
	Type string `json:"type"`
	/** @description What to decide: text, or a JSON object/array of guidance */
	// @DataMember(Name="instructions")
	Instructions interface{} `json:"instructions"`
	/** @description noul: {true,false} descriptions; choice: {option: description}; score: ordered descriptions */
	// @DataMember(Name="criteria")
	Criteria *interface{} `json:"criteria,omitempty"`
}

/** @description Decisions API (OpenRouter) */
// @DataContract
type CreateDecision struct {
	/** @description The decision model, e.g. ~typesafe/jev-latest */
	// @DataMember(Name="model")
	Model string `json:"model"`
	/** @description The content to evaluate: a plain string, or a JSON object or array of related context */
	// @DataMember(Name="state")
	State interface{} `json:"state"`
	/** @description Named noul (yes/no probability), choice (one option) or score (ordered scale) questions */
	// @DataMember(Name="questions")
	Questions map[string]DecisionQuestion `json:"questions"`
	/** @description A unique identifier for grouping related requests */
	// @DataMember(Name="session_id")
	SessionId *string `json:"session_id,omitempty"`
	/** @description End-user identifier sent to OpenRouter. Omitted unless you set it. */
	// @DataMember(Name="user")
	User *string `json:"user,omitempty"`
	/** @description OpenRouter provider routing preferences */
	// @DataMember(Name="provider")
	Provider map[string]interface{} `json:"provider,omitempty"`
}

Go 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
	}
}