Translation

Translate hosted audio to English through Groq and Together AI batch endpoints with Batchwork's text and segment results.

Audio translation batches are supported through Groq (whisper-large-v3) and Together AI (openai/whisper-large-v3) via /v1/audio/translations. Translation mirrors transcription minus the language field: English is the only target. audio_url values must be hosted URLs the provider can fetch during processing.

CLI

Use batchwork submit translations to return after registration or batchwork run translations for the complete lifecycle. JSON, JSONL, CSV, and text sources map to BatchTranslationRequest; each line of text input is one audio_url.

batchwork --json run translations audio-urls.txt \
  --model together/openai/whisper-large-v3 \
  --timestamp-granularity segment

CSV columns are custom_id and required audio_url. --timestamp-granularity repeats for segment and word values; there is no --language flag.

Providers

from batchwork import BatchTranslationRequest, Batchwork

async with Batchwork() as client:
    job = await client.batch_translations(
        model="groq/whisper-large-v3",
        requests=[
            BatchTranslationRequest(
                custom_id="call-1",
                audio_url="https://example.com/call-1.mp3",
                timestamp_granularities=["segment"],
            )
        ],
    )
    await job.wait(timeout=3600)
    result = (await job.collect())[0]

Groq bodies carry url; Together bodies carry file plus the method: "FILE" line marker. Both set response_format: "verbose_json" when timestamp_granularities is requested.

Result shape

result.text      # str | None — English text
result.segments  # list[BatchTranscriptionSegment] | None

Unsupported providers

Mistral batches transcriptions but not translations:

batchwork: provider "mistral" does not offer batch translation. Translations are supported for: groq, together.

Anthropic, Azure, Google Gemini, OpenAI, and xAI translation submissions also fail locally.

See Transcription, Provider overview, and Results.