Документация
Руководство по разработке API Suno V5.5
Текущий статус Suno V5.5: «Активно». Это руководство содержит ID моделей, снимок цен и готовые примеры для интеграции. Страница модели Suno V5.5
Обзор
- Поставщик: Suno
- Тип: Аудио
- Количество тарифов: 1
- Метки эндпоинтов: audio-task
Доступные тарифы и цены
В запросах параметр model должен содержать ID модели из таблицы ниже с учетом регистра.
| Тариф | ID модели | Цена за запрос | Выход | Контекст |
|---|---|---|---|---|
| Suno V5.5 | suno-v5.5 | $0.0600 / 次 | — | — |
Цены являются снимком на момент сборки; актуальные цены смотрите на странице тарифов и в консоли.
Base URL и аутентификация
Base URL: https://api.rokoapi.com/v1. Все запросы должны содержать заголовок Authorization: Bearer $OPENAI_API_KEY.
Быстрый старт
curl https://api.rokoapi.com/v1/audios/tasks \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5.5",
"prompt": "Бодрая летняя поп-песня с женским вокалом и яркой гитарой"
}'Основные параметры
| Параметр | Описание |
|---|---|
model | Используйте публичный ID модели из таблицы выше. |
prompt / messages | Введите промпт, сообщения диалога или инструкции для генерации; формат зависит от эндпоинта. |
metadata.custom | Для генеративных моделей можно передавать размер, качество, длительность, соотношение сторон или URL референсов в зависимости от возможностей модели. |
prompt | Для генеративных моделей можно передавать размер, качество, длительность, соотношение сторон или URL референсов в зависимости от возможностей модели. |
metadata.title | Для генеративных моделей можно передавать размер, качество, длительность, соотношение сторон или URL референсов в зависимости от возможностей модели. |
metadata.tags | Для генеративных моделей можно передавать размер, качество, длительность, соотношение сторон или URL референсов в зависимости от возможностей модели. |
metadata.instrumental | Для генеративных моделей можно передавать размер, качество, длительность, соотношение сторон или URL референсов в зависимости от возможностей модели. |
duration | Для генеративных моделей можно передавать размер, качество, длительность, соотношение сторон или URL референсов в зависимости от возможностей модели. |
metadata.negative_tags | Для генеративных моделей можно передавать размер, качество, длительность, соотношение сторон или URL референсов в зависимости от возможностей модели. |
После успешной отправки асинхронной задачи генерации возвращается ID задачи. Выполняйте запросы GET /v1/tasks/{task_id}, пока статус не станет completed или failed.
Примечания
- Используйте только ID моделей, перечисленные на этой странице; недоступные или снятые с поддержки имена вернут ошибку о недоступности модели.
- При ошибке 403 проверьте баланс счета, группу ключей и права доступа к модели.
- Мультимодальность, вызов инструментов, кэширование и потоковая обработка зависят от исходной модели и конфигурации канала; ориентируйтесь на фактический ответ.