curl --request POST \
  --url https://api.aircaps.com/v1/diarizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "aircaps-diarization-v1",
  "audio_url": "https://example.com/meeting.mp3",
  "webhook_url": "https://example.com/hooks/aircaps",
  "metadata": {
    "meeting_id": 42
  }
}
'

import requests

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

payload = {
    "model": "aircaps-diarization-v1",
    "audio_url": "https://example.com/meeting.mp3",
    "webhook_url": "https://example.com/hooks/aircaps",
    "metadata": { "meeting_id": 42 }
}
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({
    model: 'aircaps-diarization-v1',
    audio_url: 'https://example.com/meeting.mp3',
    webhook_url: 'https://example.com/hooks/aircaps',
    metadata: {meeting_id: 42}
  })
};

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

{
  "id": "dia_01k72p0x9h6t3b8r1n4m7q2w5e",
  "object": "diarization",
  "status": "queued",
  "created_at": "2026-10-08T18:01:02.123Z",
  "started_at": null,
  "completed_at": null,
  "audio_url": "https://example.com/meeting.mp3",
  "file_id": null,
  "model": "aircaps-diarization-v1",
  "audio_duration": null,
  "metadata": {
    "meeting_id": 42
  },
  "webhook_url": "https://example.com/hooks/aircaps",
  "webhook_status": null,
  "webhook_status_code": null,
  "error": null
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "unsupported_model",
    "message": "model 'a5s-async-v1' is not available for diarization; use \"aircaps-diarization-v1\"",
    "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 Diarization-v1. To get access, talk to sales at https://aircaps.ai/contact.",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "file_not_found",
    "message": "file_id not found or expired",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "idempotency_conflict",
    "message": "Idempotency-Key was used with a different request",
    "param": null,
    "request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "too many requests; retry after the Retry-After interval",
    "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"
  }
}