Reference¶
Exact response fields and hard limits. The contract your code branches on.
Response Shape Reference¶
Exact fields per primitive (from docs and the DDDS walkthrough):
| Primitive | Fields | Notes |
|---|---|---|
noul |
noul (0.0-1.0) |
probability the statement is true; nothing else |
choice |
choice, probabilities (per option), confidence |
confidence summarizes how close the race was — a 0.52 winner with 0.46 runner-up yields low confidence |
score |
score (fractional), legend (levels), probabilities (per level), confidence |
fractional scores come from the level distribution |
Worked noul example from the DDDS ticket-routing walkthrough — urgent returns {"noul": 0.92} while owner returns the choice shape above; the calling code pages on-call only when urgent > 0.9 AND the winning team matches, and sends to human review when confidence < 0.6. The response also carries the model version ID that answered it — treat it as part of the audit record.
Limits¶
| Limit | Value |
|---|---|
| Shared budget (state + all questions) | ~64,000 tokens |
| State + longest single question | ~32,000 tokens (~150K chars English) |
| Choice cardinality | up to 255 options (2-stage scoring at the top of the range) |
| Score levels | 2-10 |
| Input modality | text only (string / JSON / JSON array of text) |
| Latency | 70-500ms end-to-end |
| Price | $0.042/MTok input, output free |