Suno · Media API

API Suno v4.5

Suno v4.5 — первый доступный музыкальный маршрут на OmniaKey: опишите стиль и позвольте модели написать текст или отправьте свой текст вместе со стилем, и готовая песня вернётся через тот же асинхронный media API, что и изображения с видео.

Получить API-ключ Документация

ID модели: suno-v4.5
Провайдер: Suno
Тип: AI Аудио
За успешный вызов: $0,30
Проверено: 2026-09-15

Для чего подходит

Используйте Suno v4.5 для демо, фоновых треков, джинглов и черновиков текста по $0.30 за генерацию. Каждая генерация возвращает одну готовую песню и списывается один раз, независимо от того, отправляете вы текст или нет.

Что умеет

Текст в музыку

suno-v4.5

Превращает описание стиля и необязательный текст песни в готовую композицию.

Как вызывать

Медиамодели работают асинхронно: создайте задачу, опрашивайте её до завершения, затем скачайте подписанный URL результата.

Создать, опросить, скачать

# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: suno-v4.5-001" \
  -d '{
    "model": "suno-v4.5",
    "type": "audio",
    "operation": "generate",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"title": "Paper Boats"}
  }'

# 2. Description mode sends input.prompt alone and lets the model write
#    the words. Custom lyrics mode adds input.lyrics plus the style:
#    {"prompt": "indie folk", "lyrics": "[Verse] ..."} —
#    parameters.style (or .tags) overrides the style, and
#    parameters.instrumental: true drops the vocal entirely.

# 3. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 4. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp3 "$(jq -r '.assets[0].url' result.json)"

Стоимость

Музыкальные задачи оплачиваются за успешную генерацию, а не за токены. Неудачные или отменённые задачи возвращаются автоматически.

За успешный вызов

$0,30за вызов

Частые вопросы

Как вызвать Suno v4.5 в OmniaKey?

Отправьте POST на /v1/media/tasks с id модели, type "audio" и operation "generate". В режиме описания достаточно input.prompt; чтобы использовать свой текст, добавьте input.lyrics. При повторах используйте тот же Idempotency-Key, чтобы таймаут не запустил вторую платную задачу.

Сколько стоит Suno v4.5?

Suno v4.5 списывает $0,30 за вызов за успешную генерацию. При создании эта сумма удерживается из предоплаченного баланса, а неудачные или отменённые задачи возвращаются автоматически.

Почему API возвращает id задачи, а не песню?

Генерация музыки занимает от тридцати секунд до нескольких минут, поэтому все аудиомаршруты работают через один асинхронный цикл. Опрашивайте GET /v1/media/tasks/{id} до статуса succeeded, затем читайте подписанный URL ресурса.