MyApp

<back to all web services

CreateDecision

AI

Decisions API (OpenRouter)

The following routes are available for this service:
POST/v1/decisions
const std = @import("std");

// @DataContract
pub const DecisionAnswer = struct {
    // @DataMember(Name="type")
    type: ?[]const u8 = null,

    /// noul: probability from 0 (no) to 1 (yes)
    // @DataMember(Name="noul")
    noul: ?f64 = null,

    /// choice: the selected option
    // @DataMember(Name="choice")
    choice: ?[]const u8 = null,

    /// score: position on the scale, 0 = first description
    // @DataMember(Name="score")
    score: ?f64 = null,

    // @DataMember(Name="confidence")
    confidence: ?f64 = null,

    /// choice/score: probability of each option (score options are "0", "1", ...)
    // @DataMember(Name="probabilities")
    probabilities: ?std.json.Value = null,

    /// score: description of each scale position
    // @DataMember(Name="legend")
    legend: ?std.json.Value = null,
};

// @DataContract
pub const DecisionUsage = struct {
    // @DataMember(Name="input_tokens")
    input_tokens: i64 = 0,

    // @DataMember(Name="output_tokens")
    output_tokens: i64 = 0,

    // @DataMember(Name="cost")
    cost: ?f64 = null,
};

// @DataContract
pub const DecisionResponse = struct {
    // @DataMember(Name="id")
    id: ?[]const u8 = null,

    // @DataMember(Name="model")
    model: ?[]const u8 = null,

    // @DataMember(Name="provider")
    provider: ?[]const u8 = null,

    /// Answers by question name, validated against the submitted questions
    // @DataMember(Name="answers")
    answers: ?std.json.Value = null,

    // @DataMember(Name="usage")
    usage: ?DecisionUsage = null,
};

// @DataContract
pub const DecisionQuestion = struct {
    /// noul, choice or score
    // @DataMember(Name="type")
    type: ?[]const u8 = null,

    /// What to decide: text, or a JSON object/array of guidance
    // @DataMember(Name="instructions")
    instructions: ?std.json.Value = null,

    /// noul: {true,false} descriptions; choice: {option: description}; score: ordered descriptions
    // @DataMember(Name="criteria")
    criteria: ?std.json.Value = null,
};

/// Decisions API (OpenRouter)
// @DataContract
pub const CreateDecision = struct {
    /// The decision model, e.g. ~typesafe/jev-latest
    // @DataMember(Name="model")
    model: ?[]const u8 = null,

    /// The content to evaluate: a plain string, or a JSON object or array of related context
    // @DataMember(Name="state")
    state: ?std.json.Value = null,

    /// Named noul (yes/no probability), choice (one option) or score (ordered scale) questions
    // @DataMember(Name="questions")
    questions: ?std.json.Value = null,

    /// A unique identifier for grouping related requests
    // @DataMember(Name="session_id")
    session_id: ?[]const u8 = null,

    /// End-user identifier sent to OpenRouter. Omitted unless you set it.
    // @DataMember(Name="user")
    user: ?[]const u8 = null,

    /// OpenRouter provider routing preferences
    // @DataMember(Name="provider")
    provider: ?std.json.Value = null,
};

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