Transcribe an uploaded recording or live microphone audio

Default mode is fast. WAV PCM16 mono 16 kHz, minimum 0.5 seconds; Batch maximum 60 seconds, Fast and uploaded-recording Streaming maximum 12 hours. Batch costs zero credits; Fast 4000 and Streaming 8000 credits per input audio hour, rounded up per request. Binary uploads allow 1,382,400,000 audio bytes plus 1 MiB headers/metadata; complete within 30 minutes without a 60-second idle gap. Legacy JSON data URLs are limited to 40 MiB. For live input send JSON mode=streaming, microphone=true, no source or explicit language. Wait for microphone_ready, then POST ordered frames to /api/generations/{generationUuid}/stt-input. Live sessions accept 0.5–30 seconds, eight sessions per controller, reserve 67 credits and refund the difference from actual-duration billing on successful completion. Closing live SSE cancels unfinished work.

post/v1/audio/transcriptions

Request

  • Base URL: https://giggy.ai
  • URL: https://giggy.ai/v1/audio/transcriptions
  • Auth: API key in header xi-api-key

Query parameters

mode'batch' | 'fast' | 'streaming'

Binary WAV uploads only; JSON requests use the body field.

language'Arabic' | 'Cantonese' | 'Chinese' | 'Czech' | 'Dutch' | 'English' | 'Filipino' | 'French' | 'German' | 'Greek' | 'Hindi' | 'Hungarian' | 'Indonesian' | 'Italian' | 'Japanese' | 'Korean' | 'Malay' | 'Persian' | 'Polish' | 'Portuguese' | 'Romanian' | 'Russian' | 'Spanish' | 'Swedish' | 'Thai' | 'Turkish' | 'Vietnamese'

Binary WAV uploads only. Omit for automatic language detection.

client_request_idstring uuid

Optional operation UUID for identical-request replay; binary uploads only.

Request body

mode'batch' | 'fast' | 'streaming'
languagestring nullable

Omit or use null for automatic detection; live input cannot set a language.

source_audio_data_urlstring

Base64 WAV data URL for a completed recording; mutually exclusive with microphone.

client_request_idstring uuid
microphoneunknown

Response

Streaming SSE: generation_created, microphone_ready for live input, cumulative transcript_chunk (replace=true), generation_updated and terminal status. Early transcript text can be revised.

Changes

No recorded changes to this operation across all 1 revision of this API.