Transcribe speech to text

//native

type Telnyx = {

	apiKey: string

}

type Base64 = string

/**

 * Transcribe speech to text

 * Transcribe speech to text. This endpoint is consistent with the [OpenAI Transcription API](https://platform.openai.com/docs/api-reference/audio/createTranscription) and may be used with the OpenAI JS or Python SDK.

 */

export async function main(

	auth: Telnyx,

	body: {

		file?: {

			base64: Base64

			type:

				| 'image/png'

				| 'image/jpeg'

				| 'image/gif'

				| 'application/pdf'

				| 'appication/json'

				| 'text/csv'

				| 'text/plain'

				| 'audio/mpeg'

				| 'audio/wav'

				| 'video/mp4'

			name: string

		}

		file_url?: string

		model: 'distil-whisper/distil-large-v2' | 'openai/whisper-large-v3-turbo'

		response_format?: 'json' | 'verbose_json'

		'timestamp_granularities[]'?: 'segment'

	}

) {

	const url = new URL(`https://api.telnyx.com/v2/ai/audio/transcriptions`)

	const formData = new FormData()

	for (const [k, v] of Object.entries(body)) {

		if (v !== undefined && v !== '') {

			if (['file'].includes(k)) {

				const { base64, type, name } = v as {

					base64: Base64

					type: string

					name: string

				}

				formData.append(

					k,

					new Blob([Uint8Array.from(atob(base64), (m) => m.codePointAt(0)!)], {

						type

					}),

					name

				)

			} else {

				formData.append(k, String(v))

			}

		}

	}

	const response = await fetch(url, {

		method: 'POST',

		headers: {

			Authorization: 'Bearer ' + auth.apiKey

		},

		body: formData

	})

	if (!response.ok) {

		const text = await response.text()

		throw new Error(`${response.status} ${text}`)

	}

	return await response.json()

}