Suno

Шаг 1. Создание задачи

POST https://gptunnel.ru/v1/media/create

Асинхронный запрос вернет задачу и её идентификатор — сохраните его для последующего получения ссылки на результат.

Headers

Параметр	Тип	Описание
`Authorization`*	`string`	API ключ

Request Body (basic mode)

Параметр	Тип	Описание
`model`*	`"suno"`	Уникальный ID модели
`prompt`*	`string`	Промпт запроса (для basic mode максимально 400 знаков)
`version`	`enum`	Версия, допустимые значения 'chirp-v3-5', 'chirp-v4', 'chirp-v4-5'

Пример запроса /create

import axios from 'axios'

const request = axios({
  method: 'POST',
  url: 'https://gptunnel.ru/v1/media/create',
  headers: {
    Authorization: 'YOUR_API_KEY',
  },
  data: {
    model: 'suno',
    prompt: 'Джингл про AI интегратора GPTunneL',
  },
})

request
  .then((result) => {
    console.log(result)
  })
  .catch((error) => {
    console.error(error)
  })

import requests

response = requests.post(
    'https://gptunnel.ru/v1/media/create',
    headers={
        'Authorization': 'YOUR_API_KEY',
    },
    json={
        'model': 'suno',
        'prompt': 'Джингл про AI интегратора GPTunneL',
    },
)

print(response.json())

curl --request POST \
  --url https://gptunnel.ru/v1/media/create \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model":"suno",
    "prompt": "Джингл про AI интегратора GPTunneL"
  }'

Пример ответа /create

{
  "code": 0,
  "id": "6880c0c4e606050001881b51",
  "model": "suno",
  "created_at": 1753268420,
  "status": "idle",
  "result": null,
  "input": {
    "model": "suno",
    "prompt": "Джингл про AI интегратора GPTunneL"
  }
}

Шаг 2. Получение результата

После получения 24-значного идентификатора задачи вы можете вызвать метод для получения результата.

POST https://gptunnel.ru/v1/media/result

Запрос можно вызвать как POST так и GET методом передав task_id в query либо в body. Результатом выполнения запроса будет JSON объект с данными по генерациям.

Пример запроса /result

import axios from 'axios'

const request = axios({
  method: 'POST',
  url: 'https://gptunnel.ru/v1/media/result',
  headers: {
    Authorization: 'YOUR_API_KEY',
  },
  data: {
    task_id: '6880c0c4e606050001881b51',
  },
})

request
  .then((result) => {
    console.log(result)
  })
  .catch((error) => {
    console.error(error)
  })

import requests

response = requests.post(
    'https://gptunnel.ru/v1/media/result',
    headers={
        'Authorization': 'YOUR_API_KEY',
    },
    json={
        'task_id': '6880c0c4e606050001881b51',
    },
)

print(response.json())

curl --request POST \
  --url https://gptunnel.ru/v1/media/result \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id":"6880c0c4e606050001881b51"
  }'

Пример ответа /result

{
  "code": 0,
  "id": "6880c0c4e606050001881b51",
  "model": "suno",
  "created_at": 1753268420,
  "status": "done",
  "input": {
    "model": "suno",
    "prompt": "Джингл про AI интегратора GPTunneL"
  },
  "result": [
    {
      "id": "c158f164-1028-447c-9333-2d4cdfc94581",
      "image_url": "https://gptunnel.ru/v1/lab/suno/6880c0c4e606050001881b51/c158f164-1028-447c-9333-2d4cdfc94581/image.jpeg",
      "audio_url": "https://gptunnel.ru/v1/lab/suno/6880c0c4e606050001881b51/c158f164-1028-447c-9333-2d4cdfc94581/audio.mp3",
      "lyric": "[Verse]\nВ мире цифр\nГде хаос живет\nGPTunneL порядок найдет\n...",
      "tags": "catchy with synth leads and dynamic rhythm, electronic",
      "duration": 148.44,
      "status": "succeeded"
    },
    {
      "id": "0c26644b-9eed-4d27-9685-c7593a084cbd",
      "image_url": "https://gptunnel.ru/v1/lab/suno/6880c0c4e606050001881b51/0c26644b-9eed-4d27-9685-c7593a084cbd/image.jpeg",
      "audio_url": "https://gptunnel.ru/v1/lab/suno/6880c0c4e606050001881b51/0c26644b-9eed-4d27-9685-c7593a084cbd/audio.mp3",
      "lyric": "[Verse]\nВ мире цифр\nГде хаос живет\nGPTunneL порядок найдет\n...",
      "tags": "catchy with synth leads and dynamic rhythm, electronic",
      "duration": 223.48,
      "status": "succeeded"
    }
  ]
}

Скачать файл

Режим custom

В этом режиме можно создавать песни с текстом песни и указанием стиля.

Параметры запроса (custom)

Параметр	Тип	Описание
`model`*	`string`	Модель -- значение "suno"
`mode`*	`string`	Режим -- значение "custom"
`title`*	`string`	Название трека -- до 80 знаков
`lyric`*	`string`	Текст песни -- до 3000 знаков в режиме custom
`tags`*	`string`	Стиль песни, тэги -- до 200 знаков
`version`	`string`	Версия модели, доступные значения: 'chirp-v3-5', 'chirp-v3', 'chirp-v4-5'

Режим instrumental

В этом режиме можно создавать песни без вокала с указанием стиля.

Параметры запроса (instrumental)

Параметр	Тип	Описание
`model`*	`string`	Модель -- значение "suno"
`mode`*	`string`	Режим -- значение "instrumental"
`title`*	`string`	Название трека -- до 80 знаков
`tags`*	`string`	Стиль песни, тэги -- до 200 знаков
`version`	`string`	Версия модели, доступные значения: 'chirp-v3-5', 'chirp-v3', 'chirp-v4-5'