UnderSky Docs

Audio Transcriptions API

Reference for POST /v1/audio/transcriptions, including multipart fields, supported transcription models, token pricing, minimum billing, and error responses.

Endpoint

POST https://api.undersky.ai/v1/audio/transcriptions

Authenticate with a model API key in the Authorization header. Send the request as multipart/form-data.

Form fields

FieldTypeRequiredDescription
filefileYesAudio file with a filename.
modelstringNowhisper-1, gpt-4o-mini-transcribe, gpt-4o-transcribe, or gpt-4o-transcribe-diarize. Defaults to gpt-4o-mini-transcribe.
response_formatstringNoResponse format supported by the configured upstream.
languagestringNoISO-639-1 language hint.
promptstringNoVocabulary or context hint for the transcription.
temperaturenumberNoSampling temperature supported by the upstream.

Other multipart fields are forwarded to the configured transcription provider.

Request

curl -sS https://api.undersky.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "[email protected]" \
  -F "model=gpt-4o-mini-transcribe" \
  -F "language=en" \
  -F "response_format=json"

Models and pricing

ModelInput priceOutput price
whisper-1fixed request pricingfixed request pricing
gpt-4o-mini-transcribe$1 / 1M tokens$4 / 1M tokens
gpt-4o-transcribe$84 / 1M tokens$140 / 1M tokens
gpt-4o-transcribe-diarize$84 / 1M tokens$140 / 1M tokens

Successful requests have a $0.10 credit minimum. Failed requests release the billing hold.

Responses

The gateway returns the successful JSON or text response from the configured provider and preserves its content type. Keep response parsing compatible with the selected model and format.

Errors

StatusCodeMeaning
400invalid_multipart or unsupported_modelThe form body, file, or model is invalid.
401authentication errorThe API key is missing or invalid.
402billing errorThe account cannot reserve the minimum credit amount.
429rate limitRetry with bounded exponential backoff.
502upstream_unreachableThe configured provider did not respond.

See the transcription guide for a complete workflow and the media API overview for related endpoints.

On this page