audio.go

// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

package openai

import (
	"github.com/openai/openai-go/v3/option"
)

// AudioService contains methods and other services that help with interacting with
// the openai API.
//
// Note, unlike clients, this service does not read variables from the environment
// automatically. You should not instantiate this service directly, and instead use
// the [NewAudioService] method instead.
type AudioService struct {
	Options []option.RequestOption
	// Turn audio into text or text into audio.
	Transcriptions AudioTranscriptionService
	// Turn audio into text or text into audio.
	Translations AudioTranslationService
	// Turn audio into text or text into audio.
	Speech AudioSpeechService
}

// NewAudioService generates a new service that applies the given options to each
// request. These options are applied after the parent client's options (if there
// is one), and before any request-specific options.
func NewAudioService(opts ...option.RequestOption) (r AudioService) {
	r = AudioService{}
	r.Options = opts
	r.Transcriptions = NewAudioTranscriptionService(opts...)
	r.Translations = NewAudioTranslationService(opts...)
	r.Speech = NewAudioSpeechService(opts...)
	return
}

type AudioModel = string

const (
	AudioModelWhisper1                      AudioModel = "whisper-1"
	AudioModelGPT4oTranscribe               AudioModel = "gpt-4o-transcribe"
	AudioModelGPT4oMiniTranscribe           AudioModel = "gpt-4o-mini-transcribe"
	AudioModelGPT4oMiniTranscribe2025_12_15 AudioModel = "gpt-4o-mini-transcribe-2025-12-15"
	AudioModelGPT4oTranscribeDiarize        AudioModel = "gpt-4o-transcribe-diarize"
)

// The format of the output, in one of these options: `json`, `text`, `srt`,
// `verbose_json`, `vtt`, or `diarized_json`. For `gpt-4o-transcribe` and
// `gpt-4o-mini-transcribe`, the only supported format is `json`. For
// `gpt-4o-transcribe-diarize`, the supported formats are `json`, `text`, and
// `diarized_json`, with `diarized_json` required to receive speaker annotations.
type AudioResponseFormat string

const (
	AudioResponseFormatJSON         AudioResponseFormat = "json"
	AudioResponseFormatText         AudioResponseFormat = "text"
	AudioResponseFormatSRT          AudioResponseFormat = "srt"
	AudioResponseFormatVerboseJSON  AudioResponseFormat = "verbose_json"
	AudioResponseFormatVTT          AudioResponseFormat = "vtt"
	AudioResponseFormatDiarizedJSON AudioResponseFormat = "diarized_json"
)