Chat

Criar decisões

Beta: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice.

Evaluate a state against a map of typed questions and get back structured answers, one per question. Question types: noul (yes/no probability), choice (pick one option with full probability distribution), and score (probability-weighted position on an ordered rubric). Every question is evaluated in parallel against the same state. This endpoint returns typed judgments, not generated text. It is also available at /api/v1/systemone for drop-in compatibility with TypeSafe SDKs (set TYPESAFE_BASE_URL=https://api.venice.ai/api).

Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.

POST

decisions

/api/v1/decisions

curl --request POST \
  --url https://api.venice.ai/api/v1/decisions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "state": "Help! My payouts have been failing for 3 days.",
  "model": "jev-latest",
  "questions": {
    "is_urgent": {
      "type": "noul",
      "instructions": "Does this message convey urgency?"
    }
  }
}
'

import requests

url = "https://api.venice.ai/api/v1/decisions"

payload = {
    "state": "Help! My payouts have been failing for 3 days.",
    "model": "jev-latest",
    "questions": { "is_urgent": {
            "type": "noul",
            "instructions": "Does this message convey urgency?"
        } }
}
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: 'Help! My payouts have been failing for 3 days.',
    model: 'jev-latest',
    questions: {is_urgent: {type: 'noul', instructions: 'Does this message convey urgency?'}}
  })
};

fetch('https://api.venice.ai/api/v1/decisions', 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.venice.ai/api/v1/decisions",
  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' => 'Help! My payouts have been failing for 3 days.',
    'model' => 'jev-latest',
    'questions' => [
        'is_urgent' => [
                'type' => 'noul',
                'instructions' => 'Does this message convey urgency?'
        ]
    ]
  ]),
  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.venice.ai/api/v1/decisions"

	payload := strings.NewReader("{\n  \"state\": \"Help! My payouts have been failing for 3 days.\",\n  \"model\": \"jev-latest\",\n  \"questions\": {\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Does this message convey urgency?\"\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.venice.ai/api/v1/decisions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"state\": \"Help! My payouts have been failing for 3 days.\",\n  \"model\": \"jev-latest\",\n  \"questions\": {\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Does this message convey urgency?\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.venice.ai/api/v1/decisions")

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\": \"Help! My payouts have been failing for 3 days.\",\n  \"model\": \"jev-latest\",\n  \"questions\": {\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Does this message convey urgency?\"\n    }\n  }\n}"

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

{
  "model": "jev-latest",
  "answers": {
    "is_urgent": {
      "type": "noul",
      "noul": 0.92
    }
  },
  "usage": {
    "input_tokens": 312,
    "output_tokens": 48
  }
}

{
  "error": "<string>",
  "details": {
    "_errors": [],
    "field": {
      "_errors": [
        "Field is required"
      ]
    }
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Autorizações

Authorization

string

header

obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cabeçalhos

Accept-Encoding

string

Supported compression encodings (gzip, br)

Exemplo:

"gzip, br"

Corpo

application/json

Evaluate a state against a map of typed questions and get back structured answers, one per question.

state

obrigatório

The content to evaluate: a plain string for text, or structured data (object/array) for things like chat logs, records, or application state.

Minimum string length: 1

Exemplo:

"Help! My payouts have been failing for 3 days."

model

obrigatório

ID of the decision model to use. You can use the List models API (type=decision) to see available models, or see our Model overview for descriptions of them.

Exemplo:

"jev-latest"

questions

object

obrigatório

Map of typed questions, keyed by an id you choose. Answers come back under the same ids. Every question is evaluated in parallel and in isolation against the same state. Question ids are not sent to the model.

Show child attributes

Exemplo:

{
  "is_urgent": {
    "type": "noul",
    "instructions": "Does this message convey urgency?"
  }
}

Resposta

model

string

obrigatório

The model that performed the evaluation.

answers

object

obrigatório

One answer per question, keyed by the same ids used in the request.

Show child attributes

usage

object

obrigatório

Show child attributes

⌘I

/api/v1/decisions

curl --request POST \
  --url https://api.venice.ai/api/v1/decisions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "state": "Help! My payouts have been failing for 3 days.",
  "model": "jev-latest",
  "questions": {
    "is_urgent": {
      "type": "noul",
      "instructions": "Does this message convey urgency?"
    }
  }
}
'

import requests

url = "https://api.venice.ai/api/v1/decisions"

payload = {
    "state": "Help! My payouts have been failing for 3 days.",
    "model": "jev-latest",
    "questions": { "is_urgent": {
            "type": "noul",
            "instructions": "Does this message convey urgency?"
        } }
}
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: 'Help! My payouts have been failing for 3 days.',
    model: 'jev-latest',
    questions: {is_urgent: {type: 'noul', instructions: 'Does this message convey urgency?'}}
  })
};

fetch('https://api.venice.ai/api/v1/decisions', 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.venice.ai/api/v1/decisions",
  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' => 'Help! My payouts have been failing for 3 days.',
    'model' => 'jev-latest',
    'questions' => [
        'is_urgent' => [
                'type' => 'noul',
                'instructions' => 'Does this message convey urgency?'
        ]
    ]
  ]),
  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.venice.ai/api/v1/decisions"

	payload := strings.NewReader("{\n  \"state\": \"Help! My payouts have been failing for 3 days.\",\n  \"model\": \"jev-latest\",\n  \"questions\": {\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Does this message convey urgency?\"\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.venice.ai/api/v1/decisions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"state\": \"Help! My payouts have been failing for 3 days.\",\n  \"model\": \"jev-latest\",\n  \"questions\": {\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Does this message convey urgency?\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.venice.ai/api/v1/decisions")

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\": \"Help! My payouts have been failing for 3 days.\",\n  \"model\": \"jev-latest\",\n  \"questions\": {\n    \"is_urgent\": {\n      \"type\": \"noul\",\n      \"instructions\": \"Does this message convey urgency?\"\n    }\n  }\n}"

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

{
  "model": "jev-latest",
  "answers": {
    "is_urgent": {
      "type": "noul",
      "noul": 0.92
    }
  },
  "usage": {
    "input_tokens": 312,
    "output_tokens": 48
  }
}

{
  "error": "<string>",
  "details": {
    "_errors": [],
    "field": {
      "_errors": [
        "Field is required"
      ]
    }
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}