---
title: "POST /transcribe"
method: POST
path: "/transcribe"
---

# POST /transcribe

`POST /transcribe`

Transcribe a remote file

## Request body

- object
  - `url` string, required
  - `callbackUrl` string — Optional callback URL to receive subtitling status
  - `externalId` string — Optional external ID for tracking the subtitling job
  - `language` string
  - `prompt` string — Optional prompt to guide the transcription process. This can be used to provide context or specific instructions for the transcription.
  - `format` 'srt' | 'vtt'
  - `model` 'whisper-1' | 'gpt-4o-transcribe' | 'gpt-4o-mini-transcribe' | 'gpt-4o-mini-transcribe-2025-12-15' | 'gpt-4o-transcribe-diarize' — Transcription model to use. Default: whisper-1. Note: gpt-4o-transcribe-diarize supports speaker identification.
  - `speakerNames` string[] — Known speaker names for diarization (max 4). Only used with gpt-4o-transcribe-diarize model.

## Response `200`

Default Response

## Other responses

- `400` — Validation Error
- `500` — Default Response

---

[API](https://skmtc.net/eyevinn/apis/eyevinn-auto-subtitles.md) · [All operations](https://skmtc.net/eyevinn/apis/eyevinn-auto-subtitles/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eyevinn/eyevinn-auto-subtitles/versions/022664e97a99/schema)