curl "https://api.aircaps.com/v1/speakers/identify" \
  -H "Authorization: Bearer $AIRCAPS_API_KEY" \
  -H "Content-Type: audio/wav" \
  --data-binary @clip.wav

import os, requests

with open("clip.wav", "rb") as f:
    r = requests.post("https://api.aircaps.com/v1/speakers/identify",
                      headers={"Authorization": f"Bearer {os.environ['AIRCAPS_API_KEY']}", "Content-Type": "audio/wav"},
                      data=f)
print(r.json()["results"][0])

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/octet-stream'},
  body: '<string>'
};

fetch('https://api.aircaps.com/v1/speakers/identify', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "sid_01k73c0q9w8e7r6t5y4u3i2o1p",
  "object": "speaker_identification",
  "model": "aircaps-speaker-id-v1",
  "created_at": "2026-10-08T18:06:30.551Z",
  "audio_duration": 4.21,
  "speakers_compared": 3,
  "margin": 0.476,
  "results": [
    {
      "speaker_id": "spk_01k73a9x8w7v6u5t4s3r2q1p0n",
      "name": "Ana García",
      "score": 0.684,
      "enrollment_scores": [
        {
          "enrollment_id": "enr_01k73b2c4d5e6f7g8h9j0k1m2n",
          "score": 0.661
        },
        {
          "enrollment_id": "enr_01k73b5f1h2j3k4m5n6p7q8r9s",
          "score": 0.648
        }
      ]
    },
    {
      "speaker_id": "spk_01k73a7m6n5b4v3c2x1z0l9k8j",
      "name": "Ben Ito",
      "score": 0.208,
      "enrollment_scores": [
        {
          "enrollment_id": "enr_01k73a8h7g6f5d4s3a2p1o0i9u",
          "score": 0.208
        }
      ]
    },
    {
      "speaker_id": "spk_01k73a5q4w3e2r1t0y9u8i7o6p",
      "name": null,
      "score": 0.031,
      "enrollment_scores": [
        {
          "enrollment_id": "enr_01k73a6z5x4c3v2b1n0m9l8k7j",
          "score": 0.031
        }
      ]
    }
  ]
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "audio_too_short",
    "message": "the clip is 0.62 s long; it must be at least 1 s",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "unauthorized",
    "message": "invalid API key",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}

{
  "error": {
    "type": "permission_error",
    "code": "model_access_denied",
    "message": "This account does not have access to AirCaps Speaker ID-v1. To get access, talk to sales at https://aircaps.ai/contact.",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "speaker_not_found",
    "message": "speaker 'spk_01k73a9x8w7v6u5t4s3r2q1p0n' not found",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "file_too_large",
    "message": "clips are limited to 100 MB",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "more than 600 requests in the last minute",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "internal error",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "service_unavailable",
    "message": "temporarily unavailable; please retry",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}