# Suno V6 — аудио, Suno, через API СОЮЗа

> Идентификатор для поля `model`: `suno-v6`. Страница: https://souz.ai/models/suno-v6. Текст, звук → Аудио. Выпущена 9 сентября 2026.

СОЮЗ — единый API к нейросетям разных вендоров: один ключ, общий баланс в рублях, списание только за успешный запрос. Эта модель вызывается по контракту ниже.

Suno V6 — создаёт музыку и звуковые эффекты. Продлевает треки, делает каверы, добавляет вокал и смешивает аудио.

## Цены

Неуспешный запрос не тарифицируется. В ответах API итог — `price` у задачи и `usage.cost` у чата — целые микроединицы валюты платформы (1 единица = 1 000 000 микро), а сама валюта приезжает рядом полем `currency` (сейчас `RUB`). У незавершённой задачи `price: null`.

- Действие Создать музыку — от 8,169 ₽ за запрос

Цены и типичное время пресетов роутинга — поле `routing`: `cheap` «Дешевле», `balanced` «Баланс» (по умолчанию), `fast` «Быстрее». Пресет задаёт порядок каналов; где пресеты начинают с одного канала, цена у них общая. Потолок `max_price_multiplier` (`1.5`, `2`, `3`, `5`, `10`) не даёт пробовать каналы дороже цены пресета больше чем во столько раз.

- Действие Создать музыку: Красный (`red`) — 8,169 ₽ за запрос; Жёлтый (`yellow`) — 16,017648 ₽ за запрос.

Цена «от» — у самого дешёвого канала; цены и скорость каждого — в блоке «Каналы». При авто-роутинге цена может меняться.

## Каналы

Канал — постоянный цвет внутри модели: у каждого свои ставки, задержка, скорость и стабильность. Цвет не означает «дешёвый» или «быстрый», одинаковый цвет у другой модели — другой канал. Задержка и скорость — медиана за последний час, стабильность — доля успешных вызовов за 7 дней; «нет данных» — замеров пока мало, а не ноль.

Каналов: 3. Данные на момент сборки страницы; свежие — `GET https://api.souz.ai/v1/models/suno-v6/channels` без ключа (там же HEX цвета, пределы входа и p90).

| Канал (`id`) | Название | Доступен | Ставки | Время ответа, p50 за сутки | Стабильность, 7 дней |
| --- | --- | --- | --- | --- | --- |
| `red` | Красный | да | 8,169 ₽ за запрос с параметрами по умолчанию | 39 с | нет данных |
| `yellow` | Жёлтый | да | 16,017648 ₽ за запрос с параметрами по умолчанию | нет данных | нет данных |
| `green` | Зелёный | да | 16,017648 ₽ за запрос с параметрами по умолчанию | нет данных | нет данных |

Как выбрать канал:

- По умолчанию канал выбирает Авто-роутинг: пресет `routing` (`cheap`, `balanced`, `fast`) задаёт порядок каналов, при отказе запрос переходит к следующему.
- На один запрос — поле `routing_options`: `{"only": ["red"]}` — только этот канал, без запасных; `{"order": ["red"]}` — сначала он, затем остальные; `"allow_fallbacks": false` — только каналы из `order`; `{"ignore": [...]}` — исключить; `{"sort": "price"}` (`latency`) — порядок по критерию вместо пресета; `max_price` — пределы ставок. SDK OpenAI — через `extra_body`.
- Бесплатная проверка без запуска: `POST https://api.souz.ai/v1/models/suno-v6/routing/preview` с теми же `routing`, `routing_options` и `params` — каналы в порядке попыток (`channels`) и оценка `estimated_price`; пустой `channels` — с такими условиями запрос не выполнить.
- Закрепить по умолчанию для всех запросов аккаунта к модели: `PATCH https://api.souz.ai/v1/settings` ключом управления с `{"routing_options": {"suno-v6": {"only": ["red"]}}}`. PATCH заменяет всю карту — сначала прочитайте `GET https://api.souz.ai/v1/settings` и сохраните настройки других моделей. Запрос без `routing_options` наследует настройку; `{}` в запросе — автоматический выбор на один вызов.
- MCP: https://api.souz.ai/mcp — инструменты `list_channels`, `compare_channels`, `preview_routing`, `pin_channel`, `unpin_channel`. Подключение в Claude Code: `claude mcp add --transport http souz https://api.souz.ai/mcp --header "Authorization: Bearer $SOUZ_API_KEY"`.
- Каким каналом выполнен запрос — поле `channel` в ответе (у чата — и в каждом чанке потока), в задаче, вебхуке и истории запросов; `attempt_count` — сколько было попыток.

## Подключение по API

- Адрес: `POST https://api.souz.ai/v1/audio/generations`
- Авторизация: заголовок `Authorization: Bearer <ключ>`. Ключ создаётся в кабинете: https://souz.ai/keys.
- Тело запроса — JSON, `Content-Type: application/json`, поле `model` — `suno-v6`.
- Ответ — объект задачи (`object: "job"`) со звуком в `data[]` (`type: "audio"`, MP3) и итогом в `price`. Модель, которая за запрос делает два варианта трека (так сказано в её описании), отдаёт оба — `data[0]` и `data[1]`, цена запроса — за оба. Не успела за 9 минут — `202` с задачей в работе, её дочитывают `GET https://api.souz.ai/v1/jobs/{id}`; `Prefer: respond-async` — сразу `202`. Файлы живут 1 день по подписанной ссылке: нужен дольше — скачайте.
- Ошибки — JSON вида `{ "error": { "type", "code", "message", "detail" } }` с кодом HTTP 4xx/5xx; ветвиться — по `type` и `code`. `401` — неверный ключ; `402` с кодом `insufficient_balance` — не хватает средств на балансе, `key_spend_limit_exceeded` или `member_spend_limit_exceeded` — исчерпан лимит трат ключа или участника, повтор не поможет; `400` с кодом `capability_mismatch` или `invalid_request` — запрос не подходит модели, в `error.detail[]` — поле (`path`), причина (`reason`) и что подойдёт (`allowed`); `503 model_unavailable` — модель сейчас недоступна, повторите после `Retry-After`.
- Руководство по API целиком: https://souz.ai/docs, спецификация OpenAPI: https://api.souz.ai/openapi.json.

## Параметры запроса

Отправляются поля из этой таблицы. Кроме них — общие поля задач `routing`, `routing_options`, `max_price_multiplier`, `store`, `callback_url` и `user`. Незнакомое поле — `400 invalid_request` с `detail[].reason: unsupported_field`; значение, которое у модели ничего не меняет, принимается молча. Вся схема тела машинно — `input_schema` в карточке `GET /v1/models/suno-v6` (JSON Schema).

| Поле | Тип | Обязательное | Значения | По умолчанию | Описание |
| --- | --- | --- | --- | --- | --- |
| `action` | перечисление | да | generate, sounds, cover, extend, add_vocals, add_instrumental, mashup, replace_section, separate_vocals, split_stems, isolate_stem, wav, midi, video, cover_image, lyrics, boost_style, timestamps, persona | `generate` | Действие |
| `version` | перечисление | да | v6, v6-mini, v6-wild | `v6` | Версия |
| `prompt` | строка | нет | текст, до 5 000 символов | — | Описание музыки. Опишите настроение, жанр и инструменты. В режиме своего текста это музыкальный стиль. |
| `custom_mode` | флаг | нет | да или нет | — | Свой текст и стиль |
| `lyrics` | строка | нет | текст, до 5 000 символов | — | Текст песни. Модель споёт текст как написан. Разделы можно обозначить [Verse] и [Chorus]. |
| `instrumental` | флаг | нет | да или нет | — | Без вокала |
| `reference_audio` | звук | нет | ссылки https на звук, до 2 | — | Исходное аудио. Один трек для переработки, два для смешивания. Каждый — до 8 минут и 15 МБ. |
| `title` | строка | нет | текст, до 100 символов | — | Название. Необязательно: без названия используем первую строку текста или описания. |
| `negative_tags` | строка | нет | текст, до 200 символов | — | Что исключить. Например: тяжёлые ударные, искажённый звук. |
| `vocal_gender` | перечисление | нет | m, f | — | Вокал |
| `duration_seconds` | целое | нет | целое, от 10 до 360 | — | Длительность, с. Желаемая длительность в режиме своего текста и стиля. Без значения её выбирает модель. |
| `continue_at` | число | нет | число, от 0,01 до 480, шаг 0,01 | — | Продолжить с секунды. Момент должен быть короче исходного трека. |
| `sound_loop` | флаг | нет | да или нет | — | Зациклить |
| `sound_tempo` | целое | нет | целое, от 1 до 300 | — | Темп, BPM |
| `sound_key` | перечисление | нет | Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B | — | Тональность |
| `style_weight` | число | нет | число, от 0 до 1, шаг 0,01 | — | Следование стилю. Выше значение — точнее следование выбранному стилю. |
| `weirdness` | число | нет | число, от 0 до 1, шаг 0,01 | — | Экспериментальность. Выше значение — смелее отклонения от привычного звучания. |
| `audio_weight` | число | нет | число, от 0 до 1, шаг 0,01 | — | Влияние исходного аудио. Влияние аудиоэлементов на результат. |
| `source_job` | строка | нет | текст, до 100 символов | — | Исходная задача |
| `source_file` | строка | нет | текст, до 100 символов | — | Исходный трек |
| `persona_id` | строка | нет | текст, до 100 символов | — | Персона. ID задачи, создавшей персону. Принадлежит вашему аккаунту. |
| `persona_model` | перечисление | нет | style_persona, voice_persona | — | Тип персоны |
| `grab_lyrics` | флаг | нет | да или нет | — | Сохранить текст звука |
| `stem_name` | перечисление | нет | 808, Lead Vocal, Drum Kit, Kick, Snare, Risers, Bass, Backing Vocals, Piano, Electric Guitar, Percussion, String Section, Synth, Acoustic Guitar, Sound Effects, Synth Pad, Synth Bass, Guitar, Brass Section, Organ, Electronic Drum Kit, Lead Electric Guitar, Synth Keys, Rhythm Electric Guitar, Electric Piano, Upright Bass, Keyboards, Distorted Electric Guitar, Synth Strings, Synth Lead, Woodwinds, Rhythm Acoustic Guitar, Flute, Harp, Tambourine, Trumpet, Arpeggiator, Accordion, Fiddle, Pedal Steel Guitar, Synth Voice, Violin, Digital Piano, Synth Brass, Mandolin, Choir, Banjo, Bells, Clarinet, Tenor Saxophone, Trombone, Shaker, French Horn, Glockenspiel, Electric Bass, Cello, Timpani, Harmonica, Marimba, Vibraphone, Lap Steel Guitar, Saxophone, Orchestra, Horns, Cymbals, Hand Clap, Oboe, Celesta, Congas, Drone, Alto Saxophone, Double Bass, Ukulele, Harpsichord, Baritone Saxophone, Xylophone, Tuba, Bass Guitar, Whistle, Lead Guitar, Rhodes, Bongos, Bassoon, Cowbell, Viola, Sitar, Steel Drums, Piccolo, Theremin, Bagpipes, Hi-Hat, Music Box, Melodica, Tabla, Koto, Djembe, Taiko, Didgeridoo | — | Дорожка или инструмент |
| `start_seconds` | число | нет | число, от 0, шаг 0,01 | — | Начало фрагмента |
| `end_seconds` | число | нет | число, от 0, шаг 0,01 | — | Конец фрагмента |
| `full_lyrics` | строка | нет | текст | — | Полный текст после замены |
| `name` | строка | нет | текст | — | Имя |
| `description` | строка | нет | текст | — | Описание |
| `author` | строка | нет | текст, до 50 символов | — | Автор |
| `domain_name` | строка | нет | текст, до 50 символов | — | Подпись сайта |
| `language` | перечисление | нет | en, zh, es, fr, pt, de, ja, ko, hi, ru | — | Язык проверки голоса |
| `singer_skill_level` | перечисление | нет | beginner, intermediate, advanced, professional | — | Уровень вокала |

## Примеры запроса

### cURL

```bash
curl https://api.souz.ai/v1/audio/generations \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "action": "generate",
    "version": "v6",
    "prompt": "Бодрый инди-поп о солнечном утре в городе, женский вокал"
  }'
```

### Python

```python
import os
import requests

SOUZ_API_KEY = os.environ["SOUZ_API_KEY"]

response = requests.post(
    "https://api.souz.ai/v1/audio/generations",
    headers={"Authorization": f"Bearer {SOUZ_API_KEY}"},
    json={
      "model": "suno-v6",
      "action": "generate",
      "version": "v6",
      "prompt": "Бодрый инди-поп о солнечном утре в городе, женский вокал"
    },
)
print(response.json())
```

### TypeScript

```typescript
const response = await fetch("https://api.souz.ai/v1/audio/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOUZ_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "suno-v6",
    "action": "generate",
    "version": "v6",
    "prompt": "Бодрый инди-поп о солнечном утре в городе, женский вокал"
  }),
});
console.log(await response.json());
```

### Канал

```bash
curl https://api.souz.ai/v1/audio/generations \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "action": "generate",
    "version": "v6",
    "prompt": "Бодрый инди-поп о солнечном утре в городе, женский вокал",
    "routing_options": {
      "only": [
        "red"
      ]
    }
  }'
```

## Примеры ответа

### Ответ

```json
{
  "id": "job_01k9m2",
  "object": "job",
  "created": 1774170000,
  "created_at": "2026-03-22T09:00:00Z",
  "completed_at": "2026-03-22T09:00:09Z",
  "model": "suno-v6",
  "modality": "music",
  "status": "completed",
  "routing": "cheap",
  "max_price_multiplier": null,
  "routing_options": null,
  "attempt_count": 1,
  "channel": "red",
  "price": 8169000,
  "currency": "RUB",
  "usage": null,
  "data": [
    {
      "id": "file_01track",
      "object": "file",
      "kind": "result",
      "type": "audio",
      "role": "result",
      "url": "https://media.souz.ai/v1/files/file_01track/souz_suno-v6_01track.mp3?exp=1774774809&sig=…",
      "content_type": "audio/mpeg",
      "filename": "souz_suno-v6_01track.mp3",
      "bytes": 3622053,
      "created_at": "2026-03-22T09:00:09Z",
      "expires_at": "2026-03-29T09:00:09Z",
      "expired": false
    }
  ],
  "error": null
}
```

## Вопросы и ответы

**Что такое Suno V6?**

Suno V6 — создаёт музыку и звуковые эффекты. Продлевает треки, делает каверы, добавляет вокал и смешивает аудио. Доступна в СОЮЗе по единому API и в плейграунде на этой странице.

**Сколько стоит Suno V6?**

Suno V6 стоит от 8,169 ₽ за запрос. Цена «от» — у самого дешёвого канала; цены и скорость каждого — в блоке «Каналы». При авто-роутинге цена может меняться. Списывается только успешный запрос, неудачный не стоит ничего.

**Что Suno V6 принимает на вход и что отдаёт?**

Suno V6 принимает текст и звук и отдаёт музыку. В одном запросе: исходное аудио — до 2 ссылок https на звук. Описание музыки — до 5 000 символов; можно передать текст песни до 5 000 символов, название до 100 символов, что исключить до 200 символов, исходная задача до 100 символов, исходный трек до 100 символов, персона до 100 символов, полный текст после замены, имя, описание, автор до 50 символов и подпись сайта до 50 символов или включить «Свой текст и стиль», «Без вокала», «Зациклить» и «Сохранить текст звука».

**Какие форматы поддерживает Suno V6?**

Suno V6 поддерживает: действие — Создать музыку, Звуковые эффекты, Создать кавер, Продлить, Добавить вокал, Добавить инструментал, Смешать два трека, Заменить фрагмент, Вокал и инструментал, Все дорожки, Выделить инструмент, Скачать WAV, Ноты MIDI, Создать видеоклип, Создать обложку, Написать текст песни, Улучшить стиль, Текст с таймкодами или Создать персону, по умолчанию Создать музыку; версия — V6, V6 Mini или V6 Wild, по умолчанию V6; вокал — Мужской или Женский; длительность, с — от 10 до 360; продолжить с секунды — от 0,01 до 480; темп, BPM — от 1 до 300; тональность — Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A# или B; следование стилю — от 0 до 1; экспериментальность — от 0 до 1; влияние исходного аудио — от 0 до 1; тип персоны — style_persona или voice_persona; дорожка или инструмент — 808, Lead Vocal, Drum Kit, Kick, Snare, Risers, Bass, Backing Vocals, Piano, Electric Guitar, Percussion, String Section, Synth, Acoustic Guitar, Sound Effects, Synth Pad, Synth Bass, Guitar, Brass Section, Organ, Electronic Drum Kit, Lead Electric Guitar, Synth Keys, Rhythm Electric Guitar, Electric Piano, Upright Bass, Keyboards, Distorted Electric Guitar, Synth Strings, Synth Lead, Woodwinds, Rhythm Acoustic Guitar, Flute, Harp, Tambourine, Trumpet, Arpeggiator, Accordion, Fiddle, Pedal Steel Guitar, Synth Voice, Violin, Digital Piano, Synth Brass, Mandolin, Choir, Banjo, Bells, Clarinet, Tenor Saxophone, Trombone, Shaker, French Horn, Glockenspiel, Electric Bass, Cello, Timpani, Harmonica, Marimba, Vibraphone, Lap Steel Guitar, Saxophone, Orchestra, Horns, Cymbals, Hand Clap, Oboe, Celesta, Congas, Drone, Alto Saxophone, Double Bass, Ukulele, Harpsichord, Baritone Saxophone, Xylophone, Tuba, Bass Guitar, Whistle, Lead Guitar, Rhodes, Bongos, Bassoon, Cowbell, Viola, Sitar, Steel Drums, Piccolo, Theremin, Bagpipes, Hi-Hat, Music Box, Melodica, Tabla, Koto, Djembe, Taiko или Didgeridoo; начало фрагмента — от 0; конец фрагмента — от 0; язык проверки голоса — en, zh, es, fr, pt, de, ja, ko, hi или ru; уровень вокала — beginner, intermediate, advanced или professional.

**Как вызвать Suno V6 через API?**

Запросом POST https://api.souz.ai/v1/audio/generations с полем model: "suno-v6" и ключом СОЮЗа в заголовке Authorization: Bearer. Ответ — объект задачи со звуком MP3 в data[] и итоговой ценой; если результат не успел за 9 минут, приходит 202, и он забирается из GET /v1/jobs/{id}. Примеры на cURL, Python и TypeScript — в разделе «Подключение по API».

**Что такое каналы Suno V6 и как выбрать конкретный?**

Suno V6 выполняется через 3 канала: «Красный» (red), «Жёлтый» (yellow) и «Зелёный» (green). У каждого канала свои ставки, задержка, скорость и стабильность за 7 дней — они в блоке «Каналы» на этой странице и в GET https://api.souz.ai/v1/models/suno-v6/channels. Цвет не означает «дешёвый» или «быстрый», а одинаковый цвет у другой модели — другой канал. По умолчанию канал выбирает Авто-роутинг по пресету «Дешевле», «Баланс» или «Быстрее». Конкретный канал задаёт поле routing_options: {"only": ["red"]} — только этот канал, {"order": ["red"]} — сначала он, затем остальные. Чтобы закрепить канал для всех запросов к модели, сохраните ту же настройку в аккаунте: PATCH https://api.souz.ai/v1/settings ключом управления или в кабинете. Каким каналом выполнен запрос, видно в поле channel ответа и в истории.

**Можно ли попробовать Suno V6 без кода?**

Да: плейграунд на этой странице запускает Suno V6 с теми же параметрами, что и API. Нужен аккаунт СОЮЗа. Цена выбранного пресета видна на кнопке запуска: объём запроса известен до запуска. Итог появляется после готового трека. Пока запрос выполняется, в истории вместо цены стоит прочерк; итог появляется только после завершения.

**Когда вышла Suno V6?**

Suno V6 выпущена Suno 9 сентября 2026.

## Ссылки

- Страница модели: https://souz.ai/models/suno-v6
- Каталог моделей: https://souz.ai/models
- Все модели одним файлом: https://souz.ai/llms.txt
- Кабинет (ключи, баланс, история запросов): https://souz.ai/overview