curl -X POST https://api.trellis.sh/v1/audio/transcribe \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@recording.m4a;type=audio/m4a"

import requests

with open("recording.m4a", "rb") as audio:
    response = requests.post(
        "https://api.trellis.sh/v1/audio/transcribe",
        headers={"Authorization": "Bearer YOUR_TOKEN"},
        files={"file": ("recording.m4a", audio, "audio/m4a")},
    )
text = response.json()["text"]

const form = new FormData();
form.append("file", audioBlob, "recording.m4a");

const response = await fetch("https://api.trellis.sh/v1/audio/transcribe", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_TOKEN" },
  body: form,
});
const { text } = await response.json();

{
  "text": "What is the handover status for Saadiyat Lagoons?"
}

{
  "detail": "Unsupported audio format: audio/wav. Accepted: audio/m4a, audio/x-m4a, audio/mp4 (AAC in .m4a container; 16 kHz mono ~32 kbps recommended)."
}

{
  "detail": "File too large. Maximum size is 25MB, got 31.4MB"
}

{
  "detail": "Empty audio file"
}

{
  "detail": "Invalid or expired token"
}

{
  "code": "RATE_LIMIT",
  "retry_after_seconds": 12
}

{
  "detail": "Failed to transcribe audio"
}