Create Transcription

Turn speech into text: voice notes, clips and call recordings, with the spoken language detected.

Synchronous. Send the audio as a multipart file (OpenAI SDK compatible) or as JSON with a public https url. Formats: wav, mp3, m4a and mp4, ogg and opus, flac, webm and more; up to 10 MB and 5 minutes per request. The audio is sent for recognition inline and never stored.

Billed by the second of audio at $0.0042 per minute on spicy-transcribe-1 (minimum $0.0001 per request), settled to the length the recognizer measured. Nothing is generated, so there is no content block; a file that cannot be decoded is a 400 and nothing is charged. When recognition is unavailable the call returns 503, nothing charged: retry in a few seconds. Sandbox keys get a fixture transcript and pay nothing.

curl --request POST \
  --url https://api.spicyapi.com/v1/audio/transcriptions \
  --header 'Authorization: Bearer $SPICYAPI_KEY' \
  --form 'file=@voice-note.m4a' \
  --form 'model=spicy-transcribe-1'

# or from a public URL
curl --request POST \
  --url https://api.spicyapi.com/v1/audio/transcriptions \
  --header 'Authorization: Bearer $SPICYAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "url": "https://example.com/voice-note.mp3", "language": "English" }'

{
  "id": "sj_4b8e21d7c3a9f0e1b2d4c6a8",
  "object": "audio.transcription",
  "model": "spicy-transcribe-1",
  "text": "Hey, it's me. I just got home, call me when you're free tonight.",
  "language": "en",
  "duration_s": 6,
  "cost_usd": 0.00042
}