# gpt-transcribe

> OpenAI gpt-transcribe speech-to-text through the LLM gateway with the OpenAI SDK (POST /llm/openai/v1/audio/transcriptions, multipart) - json with detected languages, no timestamps. Successor to whisper-1. Billed per second of audio (0.13935 credits/s).

- **Provider**: openai
- **Model ID**: gpt-transcribe
- **Category**: speech_to_text
- **Pricing Type**: token_based
- **Billing**: per second of input audio — see Pricing

## API Endpoint

Base URL: https://api.core.today

### Audio Transcription
POST /llm/openai/v1/audio/transcriptions

## Authentication

Header: `Authorization: Bearer YOUR_API_KEY`

Note: Your Core.Today API key (`cdt_xxx`) works as Bearer token.

## Input Parameters

- Send `multipart/form-data` (the OpenAI SDK's `client.audio.transcriptions.create`), not JSON
- `file` (file, **required**): The audio file — mp3, mp4, mpeg, mpga, m4a, wav or webm, max 25MB
- `model` (string, **required**): Model identifier. Use `gpt-transcribe`
- `response_format` (string, optional): `json` only (Default). `verbose_json`, `text`, `srt` and `vtt` are rejected with 400 — this model returns no timestamps
- `languages[]` (array, optional): Language codes of the audio (e.g. `ko`, `en`); omit to auto-detect
- `keywords[]` (array, optional): Names and terms to spell correctly, one per entry
- `prompt` (string, optional): Free-form context about the audio

## Example Request

Multipart form fields:

```json
{
  "file": "@meeting.mp3",
  "model": "gpt-transcribe",
  "languages[]": "ko"
}
```

```bash
curl https://api.core.today/llm/openai/v1/audio/transcriptions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F file=@meeting.mp3 \
  -F model=gpt-transcribe \
  -F "languages[]=ko"
```

OpenAI SDK: `OpenAI(base_url="https://api.core.today/llm/openai/v1", api_key="cdt_...")` then `client.audio.transcriptions.create(...)` with the same fields.

## Response Format

```json
{
  "text": "The little tales they tell are false. ...",
  "languages": [
    {
      "code": "en"
    }
  ],
  "usage": {
    "type": "duration",
    "seconds": 53
  }
}
```

## Usage Flow

1. POST /llm/openai/v1/audio/transcriptions with a multipart/form-data upload of file and model
2. The transcript is returned synchronously as `text`, with detected `languages` and the billed `usage`
3. Credits are deducted per second of audio, on the length OpenAI reports (`usage.seconds` / `duration`)

Credits in the response (opt-in): send the header `X-Coredot-Include-Cost: true` and the response reports the credits that call is billed — `usage.coredot.credits` in the body (Gemini: `usageMetadata.coredot`; streaming: in the final usage event) and, for non-streaming responses, the `X-Coredot-Credits` header. Guide: https://console.core.today/llms/api.txt (section "Credits in the response").

## Pricing

- Audio: 0.13935 credits per second (≈ 8.361 credits per minute)

## Tags

openai, speech_to_text