SpyBara
Go Premium

go/resources/audio/subresources/translations/index.md 2026-07-07 08:02 UTC to 2026-07-09 20:58 UTC

171 added, 0 removed.

2026
Fri 31 21:03 Thu 30 23:58 Wed 29 15:02 Sat 25 05:59 Thu 23 18:00 Wed 22 20:02 Mon 20 20:00 Fri 17 17:00 Thu 16 20:57 Wed 15 02:58 Tue 14 06:58 Mon 13 15:59 Sun 12 06:58 Fri 10 23:02 Thu 9 20:58 Tue 7 08:02

Translations

Create translation

client.Audio.Translations.New(ctx, body) (*Translation, error)

post /audio/translations

Create translation

Parameters

  • 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

        • 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]

      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]

      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]

      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.

Returns

  • type AudioTranslationNewResponse interface{…}

    • type Translation struct{…}

      • Text string

Example

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("Example data"))),
    Model: openai.AudioModelWhisper1,
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", translation)
}

Response

{
  "text": "text"
}

Domain Types

Translation

  • type Translation struct{…}

    • Text string

Translation Verbose

  • type TranslationVerbose struct{…}

    • Duration float64

      The duration of the input audio.

    • Language string

      The language of the output translation (always english).

    • Text string

      The translated text.

    • Segments []TranscriptionSegment

      Segments of the translated text and their corresponding details.

      • ID int64

        Unique identifier of the segment.

      • AvgLogprob float64

        Average logprob of the segment. If the value is lower than -1, consider the logprobs failed.

      • CompressionRatio float64

        Compression ratio of the segment. If the value is greater than 2.4, consider the compression failed.

      • End float64

        End time of the segment in seconds.

      • NoSpeechProb float64

        Probability of no speech in the segment. If the value is higher than 1.0 and the avg_logprob is below -1, consider this segment silent.

      • Seek int64

        Seek offset of the segment.

      • Start float64

        Start time of the segment in seconds.

      • Temperature float64

        Temperature parameter used for generating the segment.

      • Text string

        Text content of the segment.

      • Tokens []int64

        Array of token IDs for the text content.