Quickstart

1. Create an API key

The full key (tazo_sk_...) is shown once and can never be recovered. Copy it into a secret manager or environment variable right away.

export TAZO_API_KEY="tazo_sk_..."

You can also create keys with the API using a sign-in access token.

2. Check the connection

curl https://api.tazolabs.com/v1/models \
  -H "Authorization: Bearer $TAZO_API_KEY"

You should see tazo-large and tazo-small, each with a ready flag. See Models for what each one supports.

3. Make a decision

Send multipart/form-data with a request field (JSON) and an audio file.

REQUEST='{
  "model": "tazo-large",
  "state": {"context": "Choose the tool matching the spoken request."},
  "questions": {
    "action": {
      "type": "choice",
      "instructions": "Which action should be taken?",
      "criteria": {
        "NO_TOOL": "Respond directly without calling a tool.",
        "get_weather": "Get weather for a city."
      }
    }
  }
}'

curl https://api.tazolabs.com/v1/decisions \
  -H "Authorization: Bearer $TAZO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "request=${REQUEST};type=application/json" \
  -F "audio=@./request.wav;type=audio/wav"

Response

{
  "id": "dec_example",
  "model": "tazo-large",
  "answers": {
    "action": {
      "type": "choice",
      "choice": "get_weather",
      "probabilities": { "NO_TOOL": 0.08, "get_weather": 0.92 },
      "confidence": 0.92
    }
  },
  "usage": { "audio_seconds": 2.4 },
  "elapsed_ms": 52.0
}

The Idempotency-Key header is optional, but it makes retries safe. Read Idempotency before you build a retry loop.

Getting started

Guides

1. Create an API key

2. Check the connection

3. Make a decision

Next steps

Design your questions

Handle errors

​1. Create an API key

​2. Check the connection

​3. Make a decision

​Next steps

Design your questions

Handle errors

1. Create an API key

2. Check the connection

3. Make a decision

Next steps