Decisions

POST /v1/pick

A simpler single-choice form of systemone.

Example

curl https://platform.parseclab.ai/v1/pick \
  -H "Authorization: Bearer $PARSEC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "Which screenshot shows the checkout error?",
    "options": ["first", "second"],
    "images": [{"image": "data:image/png;base64,iVBORw0…"}, {"image": "data:image/png;base64,iVBORw0…"}]
  }'

Request body

FieldType
statestring, object, or listAs in systemone. Required.
optionslist or object2 or more: a list of labels, or label → description. Required.
questionstring or objectOptional: what is being asked about the state.
imageslistOptional, up to 8, in the same forms as systemone.

Response

{
  "id": "req_…",
  "model": "utod-picker-12b-v1",
  "choice": "second",
  "probs": {"first": 0.08, "second": 0.92},
  "usage": {"input_tokens": 1630, "cost_usd": 0.000163},
  "truncated": false,
  "latency_ms": 240.7
}

choice is the most likely option and probs gives every option’s probability. A pick counts as one decision.

Validation errors on this endpoint use {"detail": "…"} rather than the {"error": …} envelope. See errors.