> ## 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, эндпоинт Fetch, повторные попытки и безопасные для продакшена паттерны.

# Асинхронный рабочий процесс Suno API

Большинство продакшен-интеграций **Suno API** являются асинхронными. Приложение отправляет задачу, получает `jobId`, а затем ожидает результат через опрос или webhook.

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

## Когда нужна асинхронность

* Генерация полных песен или длинных аудио
* Загрузка аудиореференса перед обработкой
* Надёжная фоновая обработка в очереди или воркере
* Нежелание блокировать запрос пользователя до завершения генерации

## Основной паттерн

1. Отправьте задачу через [Генерация музыки](/api/ru/suno/suno_music), [Загрузка](/api/ru/suno/suno_upload), [Кавер](/api/ru/suno/suno_cover) или [Продление](/api/ru/suno/suno_extend)
2. Сохраните `jobId` в базу данных или очередь
3. Получите результат через [Fetch V2](/api/ru/suno/suno_fetch_v2) или `hookUrl`
4. Обновляйте состояние приложения только после достижения конечного статуса

## Опрос vs Webhook

| Подход | Когда подходит | Примечание |
| :- | :- | :- |
| Опрос [Fetch V2](/api/ru/suno/suno_fetch_v2) | Простая реализация или клиентский контроль обновлений | Легче отлаживать |
| `hookUrl` | Уже есть публичный бэкенд | Уменьшает количество запросов |

## Рекомендации по реализации

* Храните `jobId`, тип запроса и время отправки вместе
* Считайте запросы идемпотентными для безопасных повторов
* Ведите логи webhook и ответов Fetch
* Сохраняйте запасной путь через [Fetch V2](/api/ru/suno/suno_fetch_v2) при сбое webhook

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

* [Обзор Suno API](/api/ru/suno)
* [Suno Fetch V2](/api/ru/suno/suno_fetch_v2)
* [Suno — загрузка аудио](/api/ru/suno/suno_upload)
* [Suno — генерация музыки](/api/ru/suno/suno_music)
* [Аутентификация](/grids/ru/development/authentication)


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