This HTML page is not optimized for LLM or AI agent consumption. Fetch the Markdown version instead: /guides/dws-ai-gateway/system-one.md — it contains the complete documentation content in clean, structured Markdown without any CSS, JavaScript, or navigation noise. Make decisions with the decision API

Make decisions with the decision API

Markdown version of this page, suitable for AI agents and automation

Use the decision API to ask structured questions about content and receive probabilities for yes/no answers, choices, or scores. The current endpoint is /systemone, with the model alias nutrient-systemone.

Prerequisites

Complete getting started and confirm that nutrient-systemone appears in the models array from model discovery(opens in a new tab). The decision API requires account access in addition to AI Gateway access.

Ask a yes/no question

Send the content to evaluate in state, and name each question in questions:

Terminal window
curl --fail-with-body https://api.nutrient.io/ai/v1/systemone \
  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nutrient-systemone",
    "state": "I was charged twice for my subscription this month.",
    "questions": {
      "billing": {
        "type": "noul",
        "instructions": "Is this message about billing?"
      }
    }
  }'

Read answers.billing.noul as a probability from 0 to 1 that the answer is yes. It is not a Boolean. Choose decision thresholds using your own evaluation data, and route uncertain results for review.

Question formats

Use noul for yes/no questions, choice to pick one label, and score to place the content on an ordered scale. See the API reference(opens in a new tab) for each format, the limits for each model, and request size limits.

Billing and request IDs

The decision API uses AI Gateway token billing. See the dashboard pricing page(opens in a new tab) for current rates, or discover account-specific rates with a live key.

Next steps