> ## Documentation Index > Fetch the complete documentation index at: https://aircaps.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Transcribe (one request) > Send the audio and get the finished transcript back in one request: the upload, [Create a transcript](/api-reference/create-transcript) and the wait in one call. The body is the raw audio (any audio or video format) with the options as query parameters, or a `multipart/form-data` form whose `file` field is the audio and whose other fields are the options. Options are those of Create a transcript except `audio_url` and `file_id`; `keyterms` may repeat, `metadata` and `speaker_identification` are JSON. If the transcript is not finished within `wait`, the answer is `202` with the transcript so far: fetch it with [Get a transcript](/api-reference/get-transcript), optionally with `wait`. ## OpenAPI ````yaml POST /v1/transcribe openapi: 3.1.0 info: title: AirCaps AI API version: 1.0.0 description: >- Speech-to-text: A5S Async v1 (REST; English, Spanish, French, German, Portuguese, Hindi, Japanese, Korean and Chinese) and A5S Small V2 Streaming (WebSocket; English). Speaker diarization: AirCaps Diarization-v1 (REST). Speaker identification: AirCaps Speaker ID-v1 (REST, synchronous). servers: - url: https://api.aircaps.com security: - bearerAuth: [] tags: - name: Transcripts - name: Diarizations - name: Speakers - name: Files - name: Account paths: /v1/transcribe: post: tags: - Transcripts summary: Transcribe (one request) description: >- Send the audio and get the finished transcript back in one request: the upload, [Create a transcript](/api-reference/create-transcript) and the wait in one call. The body is the raw audio (any audio or video format) with the options as query parameters, or a `multipart/form-data` form whose `file` field is the audio and whose other fields are the options. Options are those of Create a transcript except `audio_url` and `file_id`; `keyterms` may repeat, `metadata` and `speaker_identification` are JSON. If the transcript is not finished within `wait`, the answer is `202` with the transcript so far: fetch it with [Get a transcript](/api-reference/get-transcript), optionally with `wait`. operationId: transcribe parameters: - name: model in: query required: true schema: type: string example: a5s-async-v1 - name: language_code in: query required: false description: >- Language of the audio: `en` (or a regional English code such as `en-US`, `en-GB` or `en-IN`; for best results use the one that matches the speakers' locale or accent), `es`, `fr`, `de`, `pt`, `hi`, `ja`, `ko` or `zh`, or `auto` to detect it. A region on another language's code is accepted (`es-MX` is `es`). The transcript reports the code without its region. Any other value returns `400 unsupported_language`. schema: type: string default: en - name: wait in: query required: false description: Seconds to wait for the transcript (0 to 120). schema: type: number minimum: 0 maximum: 120 default: 120 - name: Idempotency-Key in: header required: false description: >- Up to 255 characters. Makes retries safe: the same key and options return the original job. schema: type: string maxLength: 255 requestBody: required: true description: The raw audio bytes, or a multipart form with `file`. content: application/octet-stream: schema: type: string format: binary multipart/form-data: schema: type: object required: - file properties: file: type: string format: binary model: type: string language_code: type: string responses: '200': description: The finished transcript (as Get a transcript). content: application/json: schema: $ref: '#/components/schemas/Transcript' example: id: tr_01k6z3m4q8w7e5r2t1y0u9i8o7 object: transcript status: completed created_at: '2026-10-06T18:01:02.123Z' started_at: '2026-10-06T18:01:02.456Z' completed_at: '2026-10-06T18:01:31.789Z' audio_url: null file_id: file_01k6z3m4q8w7e5r2t1y0u9i8o7 language_code: en model: a5s-async-v1 audio_duration: 3600.512 metadata: meeting_id: 42 webhook_url: https://example.com/hooks/aircaps webhook_status: delivered webhook_status_code: 200 error: null timing_mode: phrase text: hey good afternoon everybody ... speakers: - id: speaker_0 speaking_time: 1402.11 - id: speaker_1 speaking_time: 988.4 utterances: - speaker: speaker_0 start: 0.48 end: 6.12 text: hey good afternoon everybody ... words: - text: hey start: 0.48 end: 0.71 speaker: speaker_0 words: - text: hey start: 0.48 end: 0.71 speaker: speaker_0 headers: Location: description: URL of the transcript. schema: type: string '202': description: 'Not finished within `wait`: the transcript so far.' content: application/json: schema: $ref: '#/components/schemas/Transcript' example: 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 headers: Location: description: URL of the transcript. schema: type: string '400': description: >- Invalid request. Codes: `invalid_request`, `unsupported_language`, `unsupported_model`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request_error code: invalid_request message: empty request body; send the audio bytes as the body param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 '401': description: 'Missing or invalid API key. Codes: `unauthorized`.' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication_error code: unauthorized message: invalid API key param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 '403': description: >- The account may not do this. Codes: `account_suspended`, `account_disabled`, `usage_limit_reached`, `model_access_denied`. content: application/json: schema: $ref: '#/components/schemas/Error' example: 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 '409': description: >- Idempotency key reused with a different body. Codes: `idempotency_conflict`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request_error code: idempotency_conflict message: Idempotency-Key was used with a different request param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 '413': description: 'Larger than 1 GB. Codes: `file_too_large`.' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request_error code: file_too_large message: >- direct uploads are limited to 1 GB; use /v1/files/upload-url for larger files (up to 5 GB) param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 '429': description: 'Rate or queue limit reached. Codes: `rate_limited`, `queue_full`.' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: rate_limit_error code: rate_limited message: too many requests; retry after the Retry-After interval param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer '500': description: >- Server error. Safe to retry (use the same Idempotency-Key). Codes: `internal_error`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: api_error code: internal_error message: internal error param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 '503': description: >- Temporarily unavailable. Retry after the Retry-After interval. Codes: `service_unavailable`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: api_error code: service_unavailable message: temporarily unavailable; please retry param: null request_id: req_01k6z3m4q8w7e5r2t1y0u9i8o7 headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer components: schemas: Transcript: type: object required: - id - object - status - created_at - started_at - completed_at - audio_url - file_id - language_code - model - audio_duration - metadata - webhook_url - webhook_status - webhook_status_code - error properties: id: type: string description: Transcript ID. example: tr_01k6z3m4q8w7e5r2t1y0u9i8o7 object: type: string enum: - transcript example: transcript status: type: string enum: - queued - processing - completed - error description: >- `queued`: waiting for a processing slot. `processing`: being transcribed. `completed`: result fields present. `error`: see `error`. created_at: type: string format: date-time description: When the transcript was created (UTC). started_at: type: - string - 'null' format: date-time description: When processing started. completed_at: type: - string - 'null' format: date-time description: When the job finished (completed or error). audio_url: type: - string - 'null' description: The submitted `audio_url`, if any. file_id: type: - string - 'null' description: The submitted `file_id`, if any. language_code: type: string enum: - en - es - fr - de - pt - hi - ja - ko - zh - auto description: >- Language of the transcript: the code sent, without its region (`en-GB` is `en`), or `auto`. model: type: string enum: - a5s-async-v1 audio_duration: type: - number - 'null' description: Audio duration in seconds, once known. example: 3600.512 metadata: type: - object - 'null' description: Your `metadata`, echoed back. webhook_url: type: - string - 'null' description: Webhook target, if any. webhook_status: type: - string - 'null' enum: - pending - delivered - failed - null description: Webhook delivery state, if `webhook_url` was set. webhook_status_code: type: - integer - 'null' description: HTTP status of the last webhook delivery. error: oneOf: - $ref: '#/components/schemas/JobError' - type: 'null' description: Set when `status` is `error`. text: type: string description: >- Completed only. Full transcript: verbatim, lowercase, no punctuation. speakers: type: array items: $ref: '#/components/schemas/TranscriptSpeaker' description: >- Completed only. With `speaker_identification`, each speaker also has `speaker_id`, `name`, `score`, `matches` and `compared_duration`. utterances: type: array items: $ref: '#/components/schemas/Utterance' description: >- Completed only. Speaker turns, in time order; overlapping speech overlaps. words: type: array items: $ref: '#/components/schemas/Word' description: Completed only. Every word, in time order. timing_mode: type: string enum: - phrase - region description: The `timing_mode` used. keyterms: type: array items: type: string description: >- Only when the transcript was created with `keyterms`: the list used (duplicates removed). large_meeting: type: boolean description: 'Only when the transcript was created with `large_meeting: true`.' speaker_identification: $ref: '#/components/schemas/TranscriptSpeakerIdentification' description: >- Only when the transcript was created with `speaker_identification`: its settings and outcome. Error: type: object required: - error properties: error: type: object required: - type - code - message - request_id properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - rate_limit_error - api_error code: type: string description: Machine-readable code; see [Errors](/errors). message: type: string param: type: - string - 'null' description: The request field at fault, if any. request_id: type: - string - 'null' description: >- Also in the `x-request-id` header. Include it when contacting support. `null` on 502/504 from the edge. JobError: type: object required: - code - message properties: code: type: string enum: - invalid_audio - audio_too_long - file_too_large - download_failed - file_not_found - usage_limit_reached - internal_error - canceled description: Why the job failed. Failed jobs never count toward usage. message: type: string description: Human-readable detail. TranscriptSpeaker: type: object required: - id - speaking_time properties: id: type: string example: speaker_0 speaking_time: type: number description: Seconds this speaker talks. example: 1402.11 speaker_id: type: - string - 'null' description: >- Only with `speaker_identification`: the enrolled speaker matched with this speaker (its best score reached `threshold`), or `null`. Two speakers can match the same enrolled speaker when one person was split in two. example: spk_01k73a9x8w7v6u5t4s3r2q1p0n name: type: - string - 'null' description: >- Only with `speaker_identification`: the matched enrolled speaker's name. example: Ana García score: type: - number - 'null' description: >- Only with `speaker_identification`: the matched enrolled speaker's score, or `null`. example: 0.781 matches: type: array items: $ref: '#/components/schemas/SpeakerMatch' description: >- Only with `speaker_identification`: the 3 best-scoring enrolled speakers, best first, whether or not they reached `threshold`. Empty when the speaker had too little speech to compare. compared_duration: type: number description: >- Only with `speaker_identification`: seconds of this speaker's audio that were compared. example: 60 Utterance: type: object required: - speaker - start - end - text - words properties: speaker: type: string description: >- Speaker label (`speaker_0`, `speaker_1`, … in order of first speech). example: speaker_0 speaker_name: type: - string - 'null' description: >- Only with `speaker_identification`: the name of the enrolled speaker this speaker was matched with, or `null`. example: Ana García start: type: number description: Start time in seconds. example: 0.48 end: type: number description: End time in seconds. example: 6.12 text: type: string description: Text of the utterance. example: hey good afternoon everybody words: type: array items: $ref: '#/components/schemas/Word' description: Words of the utterance. Word: type: object required: - text - start - end - speaker properties: text: type: string description: The word. example: hey start: type: number description: Start time in seconds. example: 0.48 end: type: number description: End time in seconds. example: 0.71 speaker: type: string description: Speaker label. example: speaker_0 TranscriptSpeakerIdentification: type: object required: - model - status - threshold - speaker_ids - speakers_compared - speakers_identified - error properties: model: type: string enum: - aircaps-speaker-id-v1 status: type: string enum: - pending - completed - failed - skipped description: >- `pending`: the transcript is not finished. `completed`: matched (possibly nobody). `failed`: speaker identification was unavailable; the transcript is complete without names (see `error`). `skipped`: the transcript failed. threshold: type: number example: 0.6 speaker_ids: type: - array - 'null' items: type: string description: The requested `speaker_ids`, or `null` for every enrolled speaker. speakers_compared: type: - integer - 'null' description: >- Enrolled speakers compared (those that existed and had enrollments when the transcript was processed). example: 12 speakers_identified: type: - integer - 'null' description: Transcript speakers that got a name. example: 2 error: type: - object - 'null' properties: code: type: string enum: - speaker_identification_failed message: type: string SpeakerMatch: type: object required: - speaker_id - name - score properties: speaker_id: type: string description: Enrolled speaker ID. example: spk_01k73a9x8w7v6u5t4s3r2q1p0n name: type: - string - 'null' description: The enrolled speaker's name. example: Ana García score: type: number description: >- Similarity of this speaker's voice to the enrolled speaker (-1 to 1). example: 0.781 securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your API key: `Authorization: Bearer aircaps_sk_...`' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.