الدردشة

إنشاء القرارات

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

التفويضات

Authorization

string

header

مطلوب

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

الترويسات

Accept-Encoding

string

Supported compression encodings (gzip, br)

مثال:

"gzip, br"

الجسم

application/json

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

state

مطلوب

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

مثال:

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

model

مطلوب

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.

مثال:

"jev-latest"

questions

object

مطلوب

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

مثال:

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

الاستجابة

model

string

مطلوب

The model that performed the evaluation.

answers

object

مطلوب

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

Show child attributes

usage

object

مطلوب

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