Quickstart

Create a key and send your first request.

1. Create an API key

Sign in to the blnkd console. Open API keys, enter a name, and select Create key. Copy the key — you can only see the full secret once.

2. Set your credentials

Use the API URL below. Keep your key in an environment variable on your server.

bash

export BLNKD_URL="https://api.blnkd.dev"
export BLNKD_API_KEY="YOUR_BLNKD_API_KEY"

3. Send a request

bash

curl -sS "$BLNKD_URL/v1/systemone" \
  -H "Authorization: Bearer $BLNKD_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "blink-1.0-experimental",
    "state": {
      "ticket": "My card has two pending charges for order 1042.",
      "policy": "Billing owns payment issues. Check that both charges have settled before a refund review."
    },
    "questions": {
      "team": {
        "type": "choice",
        "instructions": "Which team owns the ticket?",
        "criteria": {"billing":"Payment issues","shipping":"Delivery issues","other":"No matching team"}
      },
      "ready": {
        "type": "noul",
        "instructions": "Does the ticket establish that two charges have settled?",
        "criteria": {"true":"Two settled charges are evidenced","false":"Settlement is not established"}
      }
    }
  }'

Read answers.team.probabilities before you choose an action. A high model score is not proof that an answer is correct. Check results on your own labeled cases.

For Python, use the TypeSafe SDK guide — it covers typed requests, async calls, and images.

Next: Choice, Noul, Score, and Images.

Add a video

Send one MP4 in the videos field alongside your state and questions. See Video inputs for a complete Python request, clip limits, and the Big Buck Bunny examples.