> ## 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 API на TTAPI: аутентификация, первый запрос, асинхронный опрос, обработка webhook и лучшие практики для продакшена.

# Быстрый старт Suno API

Это руководство — самый быстрый путь к рабочей интеграции **Suno API** на TTAPI.

Полную документацию см. в [обзоре Suno API](/api/ru/suno).

## Что включено

* Получение `TT-API-KEY`
* Выбор первого эндпоинта
* Создание текста песни или прямая генерация
* Получение асинхронных результатов
* Продолжение рабочего процесса с помощью кавера, продления, разделения дорожек и других операций

## 1. Подготовка аккаунта

Перед вызовом Suno API убедитесь, что у вас есть:

* Действующий `TT-API-KEY`
* Доступ к шлюзу TTAPI, описанному в [Аутентификация](/grids/ru/development/authentication)
* Достаточно квоты на нужные эндпоинты, см. [Цены на аудио](/grids/ru/start/pricing/audio)

## 2. Выберите начальный эндпоинт

| Сценарий | Рекомендуемый эндпоинт |
| :- | :- |
| Есть только промпт или идея | [Генерация музыки](/api/ru/suno/suno_music) |
| Нужно сначала написать текст | [Генерация текста песни](/api/ru/suno/suno_lyrics) |
| Есть аудиореференс | [Загрузка аудио](/api/ru/suno/suno_upload) |
| Переиспользование структуры песни | [Продление](/api/ru/suno/suno_extend) или [Кавер](/api/ru/suno/suno_cover) |

## 3. Отправьте первый запрос

```bash theme={null}
curl --request POST 'https://api.ttapi.io/suno/v1/music' \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: YOUR_TTAPI_KEY' \
  --data-raw '{
    "custom": true,
    "instrumental": false,
    "mv": "chirp-v6",
    "title": "Midnight Drive",
    "tags": "synthwave, female vocal, cinematic",
    "prompt": "[Verse] Neon headlights on a rainy street"
  }'
```

После успешного запроса сохраните `data.jobId` — он понадобится для [Fetch V2](/api/ru/suno/suno_fetch_v2).

## 4. Получите результат

```bash theme={null}
curl --request GET 'https://api.ttapi.io/suno/v2/fetch?jobId=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'TT-API-KEY: YOUR_TTAPI_KEY'
```

## 5. Опрос или Webhook

* **Опрос**: периодически вызывайте [Fetch V2](/api/ru/suno/suno_fetch_v2) — проще для первой интеграции
* **Webhook**: передайте `hookUrl` при отправке — лучше для стабильных бэкендов

Подробности см. в [руководстве по асинхронным процессам Suno](/grids/ru/start/suno-api-async-workflow).

## 6. Полезные эндпоинты для дальнейшей работы

* [Продление](/api/ru/suno/suno_extend) — продолжение трека
* [Кавер](/api/ru/suno/suno_cover) — переаранжировка
* [Разделение дорожек](/api/ru/suno/suno_stems) — отделение вокала от аккомпанемента
* [Загрузка аудио](/api/ru/suno/suno_upload) — старт из существующего аудио
* [Скачивание файлов](/api/ru/suno/suno_download) — загрузка готовых файлов

## Связанные страницы

* [Обзор Suno API](/api/ru/suno)
* [Suno — генерация музыки](/api/ru/suno/suno_music)
* [Suno Fetch V2](/api/ru/suno/suno_fetch_v2)
* [Цены на аудио](/grids/ru/start/pricing/audio)
* [Руководство по рабочим процессам Suno](/grids/ru/start/suno-api-workflows)


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