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

import requests

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

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

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

{
  "id": "tr_01k6z3m4q8w7e5r2t1y0u9i8o7",
  "object": "transcript",
  "status": "queued",
  "created_at": "2026-10-06T18:01:02.123Z",
  "started_at": null,
  "completed_at": null,
  "audio_url": null,
  "file_id": "file_01k6z3m4q8w7e5r2t1y0u9i8o7",
  "language_code": "en",
  "model": "a5s-async-v1",
  "audio_duration": null,
  "metadata": {
    "meeting_id": 42
  },
  "webhook_url": "https://example.com/hooks/aircaps",
  "webhook_status": null,
  "webhook_status_code": null,
  "error": null,
  "timing_mode": "phrase"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "unsupported_language",
    "message": "language 'de' is not supported; only English (\"en\", \"en-US\", ...) is available today. Multilingual support is planned.",
    "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 A5S Async 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"
  }
}