MyApp

<back to all web services

CreateDecision

AI

Decisions API (OpenRouter)

The following routes are available for this service:
POST/v1/decisions
#![allow(
    dead_code,
    non_camel_case_types,
    non_snake_case,
    clippy::upper_case_acronyms
)]

use serde::{Deserialize, Serialize};
use serde_json::Value;
use std::collections::HashMap;

#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Default)]
#[serde(default)]
pub struct DecisionAnswer {
    pub r#type: String,
    /// noul: probability from 0 (no) to 1 (yes)
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub noul: Option<f64>,
    /// choice: the selected option
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub choice: Option<String>,
    /// score: position on the scale, 0 = first description
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub score: Option<f64>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub confidence: Option<f64>,
    /// choice/score: probability of each option (score options are "0", "1", ...)
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub probabilities: Option<HashMap<String, f64>>,
    /// score: description of each scale position
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub legend: Option<HashMap<String, String>>,
}

#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Default)]
#[serde(default)]
pub struct DecisionUsage {
    pub input_tokens: i64,
    pub output_tokens: i64,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub cost: Option<f64>,
}

#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Default)]
#[serde(default)]
pub struct DecisionResponse {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub id: Option<String>,
    pub model: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub provider: Option<String>,
    /// Answers by question name, validated against the submitted questions
    pub answers: HashMap<String, DecisionAnswer>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub usage: Option<DecisionUsage>,
}

#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Default)]
#[serde(default)]
pub struct DecisionQuestion {
    /// noul, choice or score
    pub r#type: String,
    /// What to decide: text, or a JSON object/array of guidance
    pub instructions: Value,
    /// noul: {true,false} descriptions; choice: {option: description}; score: ordered descriptions
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub criteria: Option<Value>,
}

/// Decisions API (OpenRouter)
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Default)]
#[serde(default)]
pub struct CreateDecision {
    /// The decision model, e.g. ~typesafe/jev-latest
    pub model: String,
    /// The content to evaluate: a plain string, or a JSON object or array of related context
    pub state: Value,
    /// Named noul (yes/no probability), choice (one option) or score (ordered scale) questions
    pub questions: HashMap<String, DecisionQuestion>,
    /// A unique identifier for grouping related requests
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub session_id: Option<String>,
    /// End-user identifier sent to OpenRouter. Omitted unless you set it.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub user: Option<String>,
    /// OpenRouter provider routing preferences
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub provider: Option<HashMap<String, Value>>,
}

Rust CreateDecision DTOs

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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/json
Content-Type: application/json
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: application/json
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}}