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

> ## Agent Instructions
> Send API requests to https://api.ttapi.io with the TT-API-KEY header. Midjourney account hosting uses https://hold.ttapi.io. Claude Code uses https://cc.ttapi.io.
> Most generation endpoints are asynchronous. The submit response returns a job id. Poll that product's fetch endpoint, or pass a webhook on the submit request. A fetch call does not start a new generation.
> 1 USD = 100 quota. Check the pricing page for that product before estimating cost.
> This file lists the English docs. Follow every /_llms/ link recursively for the API reference, Chinese, and Russian. Open a page's .md URL for the endpoint schema.

# Suno API 工作流指南 | 选择合适的 Suno 接口

> 了解如何在 TTAPI 上选择合适的 Suno API 工作流，包括文生曲、歌词优先流程、上传、翻唱、延伸、词曲分离及导出。

# Suno API 工作流指南

使用 **Suno API** 开发时，核心问题通常不是「能不能生成歌曲」，而是「应该先调用哪个接口，接下来该做什么」。

本文档梳理了 TTAPI 上的主要 **Suno API 工作流**，帮助你选择适合产品的路径。

完整接口文档请参考 [Suno API 文档总览](/api/cn/suno)。

## 选择合适的起始接口

| 目标 | 推荐起始接口 |
| :- | :- |
| 根据提示词生成完整歌曲 | [Suno 生成音乐](/api/cn/suno/suno_music) |
| 先写歌词再生成 | [Suno 生成歌词](/api/cn/suno/suno_lyrics) |
| 从参考文件或源音频开始 | [Suno 上传音频](/api/cn/suno/suno_upload) |
| 延续已有曲目 | [Suno 延伸](/api/cn/suno/suno_extend) |
| 重新演绎或改变风格 | [Suno 翻唱](/api/cn/suno/suno_cover) |
| 分离人声与伴奏 | [Suno 词曲分离](/api/cn/suno/suno_stems) |
| 查询异步任务状态和结果 | [Suno Fetch V2](/api/cn/suno/suno_fetch_v2) |

## 主要工作流

### 提示词生曲

这是从创意或主题出发的标准流程：

1. （可选）通过 [Suno 生成歌词](/api/cn/suno/suno_lyrics) 先创建歌词
2. 通过 [Suno 生成音乐](/api/cn/suno/suno_music) 提交歌曲
3. 通过 [Fetch V2](/api/cn/suno/suno_fetch_v2) 轮询或接收 `hookUrl` 回调
4. 使用 [延伸](/api/cn/suno/suno_extend)、[翻唱](/api/cn/suno/suno_cover)、[文件下载](/api/cn/suno/suno_download) 或 [词曲分离](/api/cn/suno/suno_stems) 继续工作流

### 上传后处理

当工作流从已有人声、Demo 或参考音频开始时使用：

1. 通过 [Suno 上传音频](/api/cn/suno/suno_upload) 上传源文件
2. 将上传的资源传入下一个 Suno 工作流
3. 通过 [Suno Fetch V2](/api/cn/suno/suno_fetch_v2) 获取结果

此路径常用于翻唱、基于人声的工作流和音频转换。

### 延伸与后处理

当第一版歌曲质量不错，需要改进或扩展时：

* 使用 [Suno 延伸](/api/cn/suno/suno_extend) 延续曲目
* 使用 [Suno 翻唱](/api/cn/suno/suno_cover) 重新演绎
* 使用 [Suno 词曲分离](/api/cn/suno/suno_stems) 或 [全轨道分离](/api/cn/suno/suno_stems_all) 进行分离
* 使用 [Suno 文件下载](/api/cn/suno/suno_download) 获取高质量音频

## 常见工作流错误

* 已有上传音频时仍使用 [生成音乐](/api/cn/suno/suno_music) 起步
* 将提交接口当作同步接口，期望直接返回最终音频
* 新集成仍使用旧版 [Fetch](/api/cn/suno/suno_fetch) 而非 [Fetch V2](/api/cn/suno/suno_fetch_v2)
* 忘记保存 `jobId` 导致无法轮询或重试
* 歌曲未完成处理时就调用了词曲分离接口

## 相关页面

* [Suno API 文档总览](/api/cn/suno)
* [Suno 快速开始](/grids/cn/start/suno-api-quickstart)
* [Suno 异步工作流](/grids/cn/start/suno-api-async-workflow)
* [音频定价](/grids/cn/start/pricing/audio)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.