Singleshot API

POST

singleshot

Answer typed questions about a state

curl --request POST \
  --url https://api.morphllm.com/v1/singleshot \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "state": "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.",
  "model": "morph-systemone-v1",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Payment or subscription issues",
        "technical": "Bugs or integration problems",
        "sales": "Pricing or account questions"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "How frustrated does the customer appear?",
      "criteria": [
        "Calm, just stating facts",
        "Frustrated but civil",
        "Very angry, strong language"
      ]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "The message conveys urgency or time sensitivity."
    }
  }
}
EOF

import requests

url = "https://api.morphllm.com/v1/singleshot"

payload = {
    "state": "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.",
    "model": "morph-systemone-v1",
    "questions": {
        "department": {
            "type": "choice",
            "instructions": "Which team should handle this?",
            "criteria": {
                "billing": "Payment or subscription issues",
                "technical": "Bugs or integration problems",
                "sales": "Pricing or account questions"
            }
        },
        "frustration": {
            "type": "score",
            "instructions": "How frustrated does the customer appear?",
            "criteria": ["Calm, just stating facts", "Frustrated but civil", "Very angry, strong language"]
        },
        "is_urgent": {
            "type": "noul",
            "instructions": "The message conveys urgency or time sensitivity."
        }
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    state: 'Hi, I\'ve been trying to connect my Stripe account for 3 days and it keeps failing. I\'m losing sales. Please help ASAP.',
    model: 'morph-systemone-v1',
    questions: {
      department: {
        type: 'choice',
        instructions: 'Which team should handle this?',
        criteria: {
          billing: 'Payment or subscription issues',
          technical: 'Bugs or integration problems',
          sales: 'Pricing or account questions'
        }
      },
      frustration: {
        type: 'score',
        instructions: 'How frustrated does the customer appear?',
        criteria: [
          'Calm, just stating facts',
          'Frustrated but civil',
          'Very angry, strong language'
        ]
      },
      is_urgent: {type: 'noul', instructions: 'The message conveys urgency or time sensitivity.'}
    }
  })
};

fetch('https://api.morphllm.com/v1/singleshot', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.morphllm.com/v1/singleshot",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'state' => 'Hi, I\'ve been trying to connect my Stripe account for 3 days and it keeps failing. I\'m losing sales. Please help ASAP.',
    'model' => 'morph-systemone-v1',
    'questions' => [
        'department' => [
                'type' => 'choice',
                'instructions' => 'Which team should handle this?',
                'criteria' => [
                                'billing' => 'Payment or subscription issues',
                                'technical' => 'Bugs or integration problems',
                                'sales' => 'Pricing or account questions'
                ]
        ],
        'frustration' => [
                'type' => 'score',
                'instructions' => 'How frustrated does the customer appear?',
                'criteria' => [
                                'Calm, just stating facts',
                                'Frustrated but civil',
                                'Very angry, strong language'
                ]
        ],
        'is_urgent' => [
                'type' => 'noul',
                'instructions' => 'The message conveys urgency or time sensitivity.'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.morphllm.com/v1/singleshot"

	payload := strings.NewReader("{\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"model\": \"morph-systemone-v1\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.morphllm.com/v1/singleshot")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"model\": \"morph-systemone-v1\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.morphllm.com/v1/singleshot")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"model\": \"morph-systemone-v1\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "model": "morph-systemone-v1",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "billing",
      "probabilities": {
        "billing": 0.84,
        "technical": 0.159,
        "sales": 0.001
      },
      "confidence": 0.596
    },
    "frustration": {
      "type": "score",
      "score": 1.3,
      "probabilities": {
        "0": 0,
        "1": 0.7,
        "2": 0.3
      },
      "legend": {
        "0": "Calm, just stating facts",
        "1": "Frustrated but civil",
        "2": "Very angry, strong language"
      },
      "confidence": 0.54
    },
    "is_urgent": {
      "type": "noul",
      "noul": 0.999
    }
  },
  "usage": {
    "input_tokens": 312,
    "output_tokens": 3
  }
}

{
  "error": {
    "code": "invalid_request_error",
    "message": "The request body is missing the `model` field."
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key provided."
  }
}

{
  "error": {
    "message": "choice needs 2 to 255 options, got 1.",
    "type": "invalid_request_error",
    "param": "questions.department.criteria",
    "code": null
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry in 12 seconds."
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side."
  }
}

{
  "error": {
    "message": "The engine is at capacity; retry with backoff.",
    "type": "overloaded_error",
    "param": null,
    "code": "overloaded"
  }
}

Overview

Most of what an agent asks a model is not a paragraph. It is “which queue does this ticket go to”, “how severe is this”, “does this message need a human”. Asking a chat model means generating text, parsing it, and hoping the number it wrote reflects anything. Singleshot skips the generation: the model reads the state once and reports the probability of every option for every question in one forward pass per question, so your code branches on numbers. POST /v1/singleshot takes a state (text, a JSON object or an array of text) and a map of named questions of three types. Every answer is a distribution over the options you gave.

type	ask	answer
`noul`	a yes/no statement	`noul`: the probability of yes
`choice`	pick one of 2 to 255 named options	`choice`, `probabilities` per option, `confidence`
`score`	rate against 2 to 10 ordered levels	`score` (expected level), `probabilities` per level index, `legend`, `confidence`

Model: morph-systemone-v1, alias systemone-latest.

Writing questions

instructions is what you want judged. criteria describes the options: for choice a map of option name to description, for score an ordered list of level descriptions from lowest to highest, for noul an optional {"true": ..., "false": ...} pair. Descriptions do the work: an option the model can only see by name gets answered by the name alone. Instructions and descriptions accept JSON structure as well as strings. When a question has parts, an object with labelled keys reads better than a sentence that tries to hold them all:

{
  "type": "choice",
  "instructions": { "question": "Which topic does the line belong to?", "hint": "Read the heading above it first." },
  "criteria": {
    "returns": { "what": "Whether and how an item can be returned", "not_for": "Progress of a return already sent" },
    "shipping": "Delivery status, delays, lost packages"
  }
}

Ask every question about one state in one call. The state is read once and charged once however many questions follow; the questions are short extensions of it.

Reading answers

probabilities sum to 1 per question. choice is the argmax; score is the expected level, so a 3-level scale answering {0: 0.0, 1: 0.7, 2: 0.3} scores 1.3.
confidence (0 to 1) summarizes the shape of the distribution. For choice it is one minus the normalized entropy: 1.0 when all the mass is on one option, 0.0 when it is spread evenly. For score it is one minus the normalized standard deviation of the level: 1.0 when the mass sits on one level, 0.0 when it is split between the two ends. Gate actions on it: act automatically above a threshold you choose per action, route to a person below it.
A noul answer has no confidence; the probability is the whole answer, and you threshold it.
usage.input_tokens is the state plus the questions, read once. usage.output_tokens is the number of scored positions, one per question.

Measured on public benchmarks with this exact mechanism and no task-specific training: sentiment (2 options) 0.960, question classification (6) 0.915, intent (7) 0.956 accuracy, with expected calibration error under 0.04 after label-free calibration.

Limits and errors

state up to 32,768 tokens; state plus the longest question up to 32,768 tokens; a request up to 65,536 tokens; up to 256 questions.
422: the request does not fit the contract. error.param names the field, for example questions.department.criteria.
401: missing or invalid key. 429: your key’s rate limit. 529: the engine is at capacity. The request was not queued; retry with exponential backoff, honoring Retry-After.
Every response carries x-request-id.

Switching from another typed-decision API

If you already send {state, model, questions} with noul, choice and score questions, the bodies are the same here. Change four things: the base URL to https://api.morphllm.com, the key to a Morph key, the path to /v1/singleshot, and model to morph-systemone-v1. Answers come back in the same shapes.

Authorizations

Authorization

string

header

required

Morph API key, passed as Authorization: Bearer sk-.... Create keys at https://www.morphllm.com/dashboard/api-keys.

Body

application/json

The state and the questions to answer about it.

A state and the typed questions to answer about it.

state

required

What the questions are about: text, a JSON object, or an array of text. Up to 32,768 tokens. Charged once per request however many questions follow.

Example:

"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP."

model

string

required

morph-systemone-v1, or the alias systemone-latest.

Example:

"morph-systemone-v1"

questions

object

required

Named questions (1 to 256). The answer for each comes back under the same name.

Show child attributes

Example:

{
  "department": {
    "type": "choice",
    "instructions": "Which team should handle this?",
    "criteria": {
      "billing": "Payment or subscription issues",
      "technical": "Bugs or integration problems",
      "sales": "Pricing or account questions"
    }
  },
  "frustration": {
    "type": "score",
    "instructions": "How frustrated does the customer appear?",
    "criteria": [
      "Calm, just stating facts",
      "Frustrated but civil",
      "Very angry, strong language"
    ]
  },
  "is_urgent": {
    "type": "noul",
    "instructions": "The message conveys urgency or time sensitivity."
  }
}

Response

One answer per question.

The answers and what they cost.

model

string

required

The model that answered.

Example:

"morph-systemone-v1"

answers

object

required

One answer per question, under the name you gave it.

Show child attributes

Example:

{
  "department": {
    "type": "choice",
    "choice": "billing",
    "probabilities": {
      "billing": 0.84,
      "technical": 0.159,
      "sales": 0.001
    },
    "confidence": 0.596
  },
  "frustration": {
    "type": "score",
    "score": 1.3,
    "probabilities": { "0": 0, "1": 0.7, "2": 0.3 },
    "legend": {
      "0": "Calm, just stating facts",
      "1": "Frustrated but civil",
      "2": "Very angry, strong language"
    },
    "confidence": 0.54
  },
  "is_urgent": { "type": "noul", "noul": 0.999 }
}

usage

object

required

Token accounting for the request.

Show child attributes

Answer typed questions about a state

curl --request POST \
  --url https://api.morphllm.com/v1/singleshot \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "state": "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.",
  "model": "morph-systemone-v1",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Payment or subscription issues",
        "technical": "Bugs or integration problems",
        "sales": "Pricing or account questions"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "How frustrated does the customer appear?",
      "criteria": [
        "Calm, just stating facts",
        "Frustrated but civil",
        "Very angry, strong language"
      ]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "The message conveys urgency or time sensitivity."
    }
  }
}
EOF

import requests

url = "https://api.morphllm.com/v1/singleshot"

payload = {
    "state": "Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.",
    "model": "morph-systemone-v1",
    "questions": {
        "department": {
            "type": "choice",
            "instructions": "Which team should handle this?",
            "criteria": {
                "billing": "Payment or subscription issues",
                "technical": "Bugs or integration problems",
                "sales": "Pricing or account questions"
            }
        },
        "frustration": {
            "type": "score",
            "instructions": "How frustrated does the customer appear?",
            "criteria": ["Calm, just stating facts", "Frustrated but civil", "Very angry, strong language"]
        },
        "is_urgent": {
            "type": "noul",
            "instructions": "The message conveys urgency or time sensitivity."
        }
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    state: 'Hi, I\'ve been trying to connect my Stripe account for 3 days and it keeps failing. I\'m losing sales. Please help ASAP.',
    model: 'morph-systemone-v1',
    questions: {
      department: {
        type: 'choice',
        instructions: 'Which team should handle this?',
        criteria: {
          billing: 'Payment or subscription issues',
          technical: 'Bugs or integration problems',
          sales: 'Pricing or account questions'
        }
      },
      frustration: {
        type: 'score',
        instructions: 'How frustrated does the customer appear?',
        criteria: [
          'Calm, just stating facts',
          'Frustrated but civil',
          'Very angry, strong language'
        ]
      },
      is_urgent: {type: 'noul', instructions: 'The message conveys urgency or time sensitivity.'}
    }
  })
};

fetch('https://api.morphllm.com/v1/singleshot', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.morphllm.com/v1/singleshot",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'state' => 'Hi, I\'ve been trying to connect my Stripe account for 3 days and it keeps failing. I\'m losing sales. Please help ASAP.',
    'model' => 'morph-systemone-v1',
    'questions' => [
        'department' => [
                'type' => 'choice',
                'instructions' => 'Which team should handle this?',
                'criteria' => [
                                'billing' => 'Payment or subscription issues',
                                'technical' => 'Bugs or integration problems',
                                'sales' => 'Pricing or account questions'
                ]
        ],
        'frustration' => [
                'type' => 'score',
                'instructions' => 'How frustrated does the customer appear?',
                'criteria' => [
                                'Calm, just stating facts',
                                'Frustrated but civil',
                                'Very angry, strong language'
                ]
        ],
        'is_urgent' => [
                'type' => 'noul',
                'instructions' => 'The message conveys urgency or time sensitivity.'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.morphllm.com/v1/singleshot"

	payload := strings.NewReader("{\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"model\": \"morph-systemone-v1\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.morphllm.com/v1/singleshot")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"model\": \"morph-systemone-v1\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.morphllm.com/v1/singleshot")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"state\": \"Hi, I've been trying to connect my Stripe account for 3 days and it keeps failing. I'm losing sales. Please help ASAP.\",\n  \"model\": \"morph-systemone-v1\",\n  \"questions\": {\n    \"department\": {\n      \"type\": \"choice\",\n      \"instructions\": \"Which team should handle this?\",\n      \"criteria\": {\n        \"billing\": \"Payment or subscription issues\",\n        \"technical\": \"Bugs or integration problems\",\n        \"sales\": \"Pricing or account questions\"\n      }\n    },\n    \"frustration\": {\n      \"type\": \"score\",\n      \"instructions\": \"How frustrated does the customer appear?\",\n      \"criteria\": [\n        \"Calm, just stating facts\",\n        \"Frustrated but civil\",\n        \"Very angry, strong language\"\n      ]\n    },\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"The message conveys urgency or time sensitivity.\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "model": "morph-systemone-v1",
  "answers": {
    "department": {
      "type": "choice",
      "choice": "billing",
      "probabilities": {
        "billing": 0.84,
        "technical": 0.159,
        "sales": 0.001
      },
      "confidence": 0.596
    },
    "frustration": {
      "type": "score",
      "score": 1.3,
      "probabilities": {
        "0": 0,
        "1": 0.7,
        "2": 0.3
      },
      "legend": {
        "0": "Calm, just stating facts",
        "1": "Frustrated but civil",
        "2": "Very angry, strong language"
      },
      "confidence": 0.54
    },
    "is_urgent": {
      "type": "noul",
      "noul": 0.999
    }
  },
  "usage": {
    "input_tokens": 312,
    "output_tokens": 3
  }
}

{
  "error": {
    "code": "invalid_request_error",
    "message": "The request body is missing the `model` field."
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key provided."
  }
}

{
  "error": {
    "message": "choice needs 2 to 255 options, got 1.",
    "type": "invalid_request_error",
    "param": "questions.department.criteria",
    "code": null
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry in 12 seconds."
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side."
  }
}

{
  "error": {
    "message": "The engine is at capacity; retry with backoff.",
    "type": "overloaded_error",
    "param": null,
    "code": "overloaded"
  }
}

Get Started

Models

API Reference

Integrations

Overview

Writing questions

Reading answers

Limits and errors

Switching from another typed-decision API

Authorizations

Body

Response

​Overview

​Writing questions

​Reading answers

​Limits and errors

​Switching from another typed-decision API

Authorizations

Body

Response

Overview

Writing questions

Reading answers

Limits and errors

Switching from another typed-decision API