> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maxapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 音频与音乐

> 浏览语音合成、转录、音效和音乐生成接口。

音频接口既包含同步返回的音频流，也包含需要查询任务状态的音乐生成接口。请先确认响应内容类型。

## 接口分类

| 场景    | 常见接口                                                | 响应            |
| ----- | --------------------------------------------------- | ------------- |
| 语音转文字 | `POST /v1/audio/transcriptions`、`POST /fish/v1/asr` | JSON 文本和分段时间戳 |
| 翻译音频  | `POST /v1/audio/translations`                       | JSON 文本       |
| 文本转语音 | `POST /v1/audio/speech`、`POST /fish/v1/tts`         | 音频二进制流        |
| 音效与口型 | `/ent/v2/text2audio`、`/ent/v2/lip-sync`             | 异步任务          |
| 音乐与歌词 | `/suno/*`                                           | 任务 ID、歌曲或歌词数据 |

<Info>
  TTS 响应不是 JSON。请按 `Content-Type` 和请求中的输出格式直接保存为 MP3、WAV、PCM 或 Opus 文件。
</Info>

## 音乐任务

Suno 接口包含提交音乐、上传音频、生成歌词和查询结果等不同流程。创建和查询接口必须使用同一版本和路径族。

<Card title="异步任务处理" icon="clock" href="/guides/async-tasks">
  为音乐和音效任务实现轮询、超时和重试。
</Card>
