curl --request POST \
  --url https://api.aircaps.com/v1/speakers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Ana García",
  "metadata": {
    "employee_id": "E-1042"
  }
}
'

import requests

url = "https://api.aircaps.com/v1/speakers"

payload = {
    "name": "Ana García",
    "metadata": { "employee_id": "E-1042" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Ana García', metadata: {employee_id: 'E-1042'}})
};

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

{
  "id": "spk_01k73a9x8w7v6u5t4s3r2q1p0n",
  "object": "speaker",
  "name": "Ana García",
  "metadata": {
    "employee_id": "E-1042"
  },
  "model": "aircaps-speaker-id-v1",
  "num_enrollments": 0,
  "enrolled_duration": 0,
  "enrollments": [],
  "created_at": "2026-10-08T18:02:40.118Z",
  "updated_at": "2026-10-08T18:02:40.118Z"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_request",
    "message": "metadata exceeds 16 KB",
    "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_limit_reached",
    "message": "an account can have at most 1000 speakers; delete one first, or talk to sales at https://aircaps.ai/contact for more",
    "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"
  }
}