Skip to content
API Reference
Audio
Translations

Create translation

client.Audio.Translations.New(ctx, body) (*Translation, error)
POST/audio/translations

Translates audio into English.

ParametersExpand Collapse
body AudioTranslationNewParams
File param.Field[Reader]

The audio file object (not file name) translate, in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.

Model param.Field[AudioModel]

ID of the model to use. Only whisper-1 (which is powered by our open source Whisper V2 model) is currently available.

string
type AudioModel string
Accepts one of the following:
const AudioModelWhisper1 AudioModel = "whisper-1"
const AudioModelGPT4oTranscribe AudioModel = "gpt-4o-transcribe"
const AudioModelGPT4oMiniTranscribe AudioModel = "gpt-4o-mini-transcribe"
const AudioModelGPT4oMiniTranscribe2025_12_15 AudioModel = "gpt-4o-mini-transcribe-2025-12-15"
const AudioModelGPT4oTranscribeDiarize AudioModel = "gpt-4o-transcribe-diarize"
Prompt param.Field[string]optional

An optional text to guide the model's style or continue a previous audio segment. The prompt should be in English.

ResponseFormat param.Field[AudioTranslationNewParamsResponseFormat]optional

The format of the output, in one of these options: json, text, srt, verbose_json, or vtt.

const AudioTranslationNewParamsResponseFormatJSON AudioTranslationNewParamsResponseFormat = "json"
const AudioTranslationNewParamsResponseFormatText AudioTranslationNewParamsResponseFormat = "text"
const AudioTranslationNewParamsResponseFormatSRT AudioTranslationNewParamsResponseFormat = "srt"
const AudioTranslationNewParamsResponseFormatVerboseJSON AudioTranslationNewParamsResponseFormat = "verbose_json"
const AudioTranslationNewParamsResponseFormatVTT AudioTranslationNewParamsResponseFormat = "vtt"
Temperature param.Field[float64]optional

The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.

ReturnsExpand Collapse
type AudioTranslationNewResponse interface{…}
Accepts one of the following:
type Translation struct{…}
Text string

Create translation

package main

import (
  "bytes"
  "context"
  "fmt"
  "io"

  "github.com/openai/openai-go"
  "github.com/openai/openai-go/option"
)

func main() {
  client := openai.NewClient(
    option.WithAPIKey("My API Key"),
  )
  translation, err := client.Audio.Translations.New(context.TODO(), openai.AudioTranslationNewParams{
    File: io.Reader(bytes.NewBuffer([]byte("some file contents"))),
    Model: openai.AudioModelWhisper1,
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", translation)
}

{
  "text": "text"
}
Returns Examples
{
  "text": "text"
}