---
title: "Convert Audio to Text"
method: POST
path: "/audio-to-text"
tags: ["Audio"]
---

# Convert Audio to Text

`POST /audio-to-text`

**Available for**: Chatflow, Workflow, New Agent, Chatbot, Agent, Text Generator apps.

Transcribes an uploaded audio file to text using the workspace's default speech-to-text model.

## Response `200`

Successfully converted audio to text.

- AudioToTextResponse
  - `text` string — Output text from speech recognition.

## Other responses

- `400` — - `no_audio_uploaded` : No audio file was provided in the `file` field. - `speech_to_text_disabled` : Speech-to-text is disabled for this app. - `provider_not_support_speech_to_text` : The model provider does not support speech-to-text. - `provider_not_initialize` : No valid model provider credentials are configured. - `completion_request_error` : The speech recognition request failed.
- `413` — `audio_too_large` : The audio file exceeds the `30 MB` size limit.
- `415` — `unsupported_audio_type` : The file's MIME type is not one of the accepted audio types (see the `file` field).
- `500` — `internal_server_error` : Internal server error.

---

[API](https://skmtc.net/langgenius/apis/dify-service-api.md) · [All operations](https://skmtc.net/langgenius/apis/dify-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langgenius/dify-service-api/revisions/e49b3db72bad/schema)