Transcribe an audio file or URI | Makimoto

curl -X POST https://https//https/transcribe \
     -H "apikey: {{apikey}}" \
     -H "Content-Type: application/json" \
     -d '{
  "uri": "s3://your-bucket/recording.wav",
  "call_uuid": "call-abc123",
  "callback_url": "https://https//hooks.example.com/callback"
}'

{
  "status": "S001",
  "call_uuid": "call-abc123",
  "data": {
    "id": "29051cac-89b5-49ec-a932-006c8cc57-0febd3.wav",
    "metadata": {
      "sample_rate": 16000,
      "mode": "POST",
      "timestamp": 1780635349,
      "lang": "en",
      "codec": "",
      "transcribed_mode": "POST",
      "num_of_channels": 2,
      "audio_duration": 571.66
    },
    "transcript": [
      {
        "text": "Hello, how can I help you today?",
        "time_start": 0,
        "time_end": 2.5,
        "speaker_id": 0,
        "speaker_alias": "Agent"
      },
      {
        "text": "I'd like to check my account balance.",
        "time_start": 1,
        "time_end": 5.1,
        "speaker_id": 1,
        "speaker_alias": "User"
      }
    ]
  }
}

Submit a file upload OR a URI for batched, server-side transcription.

Inline mode — omit callback_url: returns 200 OK with the transcript in data.

Async mode — set callback_url: returns 202 Accepted and POSTs the transcript to your callback_url when ready. See the transcriptDelivered operation under Webhooks for the payload shape, retry policy, and correlation contract.

Request

This endpoint expects an object.

uristringRequired

call_uuidstringRequired

callback_urlstringRequiredformat: "uri"

Response

Inline mode (no callback_url)

statusstring

call_uuidstring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

413

Content Too Large Error

500

Internal Server Error

502

Bad Gateway Error

503

Service Unavailable Error

504

Gateway Timeout Error

Headers

Request

Response

Errors