Find entities | decision-machine-1 documentation

curl -X POST https://api.milliseconds.ai/v1/decision-machine-1/entities \
     -H "Content-Type: application/json" \
     -d '{
  "types": {
    "location": "a city or place",
    "money": "a money amount",
    "person": "a human name",
    "product": "a commercial product"
  },
  "text": "Tim Cook announced the iPhone 17 in Cupertino on Tuesday. Pre-orders start Friday at $999."
}'

{
  "entities": [
    {
      "end": 8,
      "probability": 0.998,
      "start": 0,
      "text": "Tim Cook",
      "type": "person"
    },
    {
      "end": 32,
      "probability": 0.997,
      "start": 23,
      "text": "iPhone 17",
      "type": "product"
    },
    {
      "end": 45,
      "probability": 0.98,
      "start": 36,
      "text": "Cupertino",
      "type": "location"
    },
    {
      "end": 89,
      "probability": 0.99,
      "start": 85,
      "text": "$999",
      "type": "money"
    }
  ]
}

Finds every span matching each entity type, with positions.

Send text for one result, or texts for a batch wrapped as { results: [...] }. The response carries x-input-chars (input characters) and x-input-tokens (input tokens billed for this call) headers.

Request

This endpoint expects an object.

typeslist of strings or map from strings to stringsRequired

Entity types, or type -> description.

textstringOptional1-20000 characters

The text to decide about.

textslist of stringsOptional

Batch form: one result per text.

Response

Result, or { results } for a batch

EntitiesResultobject

object

Errors

400

Bad Request Error

502

Bad Gateway Error