Chat
Crea decisioni
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?"
}
},
"images": [
"data:image/png;base64,iVBORw0KGgo="
]
}
'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?"
} },
"images": ["data:image/png;base64,iVBORw0KGgo="]
}
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?'}},
images: ['data:image/png;base64,iVBORw0KGgo=']
})
};
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?'
]
],
'images' => [
'data:image/png;base64,iVBORw0KGgo='
]
]),
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 \"images\": [\n \"data:image/png;base64,iVBORw0KGgo=\"\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 \"images\": [\n \"data:image/png;base64,iVBORw0KGgo=\"\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 \"images\": [\n \"data:image/png;base64,iVBORw0KGgo=\"\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": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Autorizzazioni
BearerAuthsiwx
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Intestazioni
Supported compression encodings (gzip, br)
Esempio:
"gzip, br"
Corpo
application/json
Evaluate a state against a map of typed questions and get back structured answers, one per question.
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:
1Esempio:
"Help! My payouts have been failing for 3 days."
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.
Esempio:
"jev-latest"
Map of typed questions, keyed by an id you choose. At least one question is required. 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
Show child attributes
Esempio:
{
"is_urgent": {
"type": "noul",
"instructions": "Does this message convey urgency?"
}
}
Up to 4 images the model should look at. Each entry is a data: URI or { content_type, base64 }. Remote URLs are not fetched.
Required array length:
1 - 4 elementsA data: URI for a PNG or JPEG. Remote URLs are not fetched.
Required string length:
1 - 13631488Pattern:
^data:image\/(?:png|jpeg|jpg);base64,[A-Za-z0-9+/]+=*$Esempio:
"data:image/png;base64,iVBORw0KGgo="
Questa pagina è stata utile?
⌘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?"
}
},
"images": [
"data:image/png;base64,iVBORw0KGgo="
]
}
'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?"
} },
"images": ["data:image/png;base64,iVBORw0KGgo="]
}
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?'}},
images: ['data:image/png;base64,iVBORw0KGgo=']
})
};
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?'
]
],
'images' => [
'data:image/png;base64,iVBORw0KGgo='
]
]),
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 \"images\": [\n \"data:image/png;base64,iVBORw0KGgo=\"\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 \"images\": [\n \"data:image/png;base64,iVBORw0KGgo=\"\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 \"images\": [\n \"data:image/png;base64,iVBORw0KGgo=\"\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": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}