---
title: "POST /api/v1/ai:transcribe"
method: POST
path: "/api/v1/ai:transcribe"
tags: ["AIService"]
---

# POST /api/v1/ai:transcribe

`POST /api/v1/ai:transcribe`

Transcribe transcribes an audio file using an instance AI provider.

## Request body

- TranscribeRequest
  - `audio` TranscriptionAudio, required
    - `content` string, bytes — Inline audio bytes.
    - `uri` string — URI for audio content. Reserved for future use.
    - `filename` string — Optional. The uploaded filename.
    - `contentType` string — Optional. The MIME type of the input audio.

## Response `200`

OK

- TranscribeResponse
  - `text` string — The transcribed text.

## Other responses

- `default` — Default error response

## Changes

- **2026-05-02** `d322a6ec7173` — 2 warning
  - removed the request property `config`
  - removed the request property `providerId`
- **2026-04-13** `8364301c6561` — 1 warning
  - removed the request property `config/allOf[#/components/schemas/TranscriptionConfig]/model`
- **2026-04-12** `be8db2a74ac8` — 1 info
  - endpoint added
- **2025-12-15** `d740073f088f` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/usememos/apis/untitled-api/changes/api/v1/ai:transcribe/post.md)

---

[API](https://skmtc.dev/usememos/apis/untitled-api.md) · [All operations](https://skmtc.dev/usememos/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usememos/untitled-api/revisions/a77a8e6d70bb/schema)