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

import os, requests

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

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

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

{
  "id": "enr_01k73b5f1h2j3k4m5n6p7q8r9s",
  "object": "speaker_enrollment",
  "speaker_id": "spk_01k73a9x8w7v6u5t4s3r2q1p0n",
  "audio_duration": 15.42,
  "consistency": 0.712,
  "created_at": "2026-10-08T18:04:52.015Z",
  "speaker": {
    "id": "spk_01k73a9x8w7v6u5t4s3r2q1p0n",
    "object": "speaker",
    "name": "Ana García",
    "metadata": {
      "employee_id": "E-1042"
    },
    "model": "aircaps-speaker-id-v1",
    "num_enrollments": 2,
    "enrolled_duration": 27.9,
    "enrollments": [
      {
        "id": "enr_01k73b2c4d5e6f7g8h9j0k1m2n",
        "object": "speaker_enrollment",
        "speaker_id": "spk_01k73a9x8w7v6u5t4s3r2q1p0n",
        "audio_duration": 12.48,
        "consistency": 0.712,
        "created_at": "2026-10-08T18:03:11.402Z"
      },
      {
        "id": "enr_01k73b5f1h2j3k4m5n6p7q8r9s",
        "object": "speaker_enrollment",
        "speaker_id": "spk_01k73a9x8w7v6u5t4s3r2q1p0n",
        "audio_duration": 15.42,
        "consistency": 0.712,
        "created_at": "2026-10-08T18:04:52.015Z"
      }
    ],
    "created_at": "2026-10-08T18:02:40.118Z",
    "updated_at": "2026-10-08T18:04:52.015Z"
  }
}

{
  "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": "enrollment_limit_reached",
    "message": "a speaker can have at most 20 enrollments; delete one first",
    "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"
  }
}