Suno: общие соглашения и запрос задачи

curl --request GET \
  --url https://api.apimart.ai/v1/music/tasks/{task_id}

import requests

url = "https://api.apimart.ai/v1/music/tasks/{task_id}"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.apimart.ai/v1/music/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apimart.ai/v1/music/tasks/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apimart.ai/v1/music/tasks/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.apimart.ai/v1/music/tasks/{task_id}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apimart.ai/v1/music/tasks/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "task_id": "task_01ABC...",
  "status": "completed",
  "progress": 100,
  "data": {
    "result": {
      "music": [
        {
          "audio_id": "<track id, used with audio_index to locate it for subsequent operations>",
          "title": "Summer Breeze",
          "duration": 128.5,
          "lyrics": "……",
          "tags": "electronic, upbeat",
          "audio_url": "https://.../xxx.mp3",
          "image_url": "https://.../cover.png",
          "image_large_url": "https://.../cover_large.png",
          "video_url": "https://.../mv.mp4"
        }
      ]
    }
  }
}

{
  "task_id": "task_01ABC...",
  "status": "failed",
  "progress": 100,
  "data": {
    "error": {
      "message": "generation failed"
    }
  }
}

Suno

Suno: общие соглашения и запрос задачи

Общее описание музыкальных интерфейсов Suno: аутентификация, жизненный цикл асинхронной задачи, model / version, ссылка на исходную аудиодорожку
Запрос задачи: GET /v1/music/tasks/:task_id, опрос до completed / failed

GET

music

tasks

{task_id}

Suno: общие соглашения и запрос задачи

curl --request GET \
  --url https://api.apimart.ai/v1/music/tasks/{task_id}

import requests

url = "https://api.apimart.ai/v1/music/tasks/{task_id}"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.apimart.ai/v1/music/tasks/{task_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apimart.ai/v1/music/tasks/{task_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apimart.ai/v1/music/tasks/{task_id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.apimart.ai/v1/music/tasks/{task_id}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apimart.ai/v1/music/tasks/{task_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "task_id": "task_01ABC...",
  "status": "completed",
  "progress": 100,
  "data": {
    "result": {
      "music": [
        {
          "audio_id": "<track id, used with audio_index to locate it for subsequent operations>",
          "title": "Summer Breeze",
          "duration": 128.5,
          "lyrics": "……",
          "tags": "electronic, upbeat",
          "audio_url": "https://.../xxx.mp3",
          "image_url": "https://.../cover.png",
          "image_large_url": "https://.../cover_large.png",
          "video_url": "https://.../mv.mp4"
        }
      ]
    }
  }
}

{
  "task_id": "task_01ABC...",
  "status": "failed",
  "progress": 100,
  "data": {
    "error": {
      "message": "generation failed"
    }
  }
}

Эта страница описывает общие соглашения для всех музыкальных интерфейсов Suno и используется вместе с отдельной документацией по каждому эндпоинту. Все интерфейсы генерации / редактирования являются асинхронными задачами: при отправке вы получаете task_id, а затем опрашиваете интерфейс запроса с этой страницы, чтобы получить результат.

Аутентификация

Все запросы должны содержать в заголовках:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Перейдите на страницу управления API Key, чтобы получить API Key.

Жизненный цикл задачи (все интерфейсы асинхронные)

Отправка

POST /v1/music/generations/<операция> → сразу возвращает наш task_id:

{ "code": 200, "data": [ { "status": "submitted", "task_id": "task_xxx" } ] }

Опрос

GET /v1/music/tasks/:task_id до тех пор, пока status не станет completed или failed. Во время генерации status равен pending, а progress проходит: в очереди 10 → готово 50 → завершено 100. Рекомендуемый интервал опроса 3–5 с; генерация музыки обычно занимает 30–120 с.

Получение результата

После завершения возьмите audio_url / image_url / video_url и др. из data.result.music[].

Переходы состояний задачи: submitted → pending → completed / failed. При неудаче data.error.message содержит причину, а предварительно списанная квота возвращается автоматически.

Версия version

v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, влияет на качество звука и тарификацию; если не передавать, используется значение по умолчанию. Доступные версии и значения по умолчанию различаются в зависимости от эндпоинта — некоторые поддерживают лишь часть версий, а у некоторых измерение версии отсутствует вовсе; см. документацию каждого эндпоинта.

Ссылка на исходную аудиодорожку: task_id + audio_index

Операции на основе уже существующей песни (продолжение / кавер / разделение дорожек / добавление вокала / обрезка…) не требуют запоминать какие-либо вышестоящие id, передаётся только:

task_id: наш task_id той задачи, которая создала исходную аудиодорожку
audio_index: номер песни в результате music[] этой задачи (нумерация с 1, по умолчанию 1; за одну генерацию обычно создаётся 2 песни: 1 и 2)

Если исходную дорожку не удаётся разрешить (задача не завершена / индекс вне диапазона / task_id не найден), при отправке возвращается 400.

Запрос задачи: GET /v1/music/tasks/:task_id

task_id

string

обязательно

Наш task_id, возвращённый интерфейсом отправки.

Опрашивайте этот интерфейс, пока status не станет completed или failed. После завершения возьмите результат из data.result.music[].

Response

task_id

string

Уникальный идентификатор задачи

status

string

Состояние задачи: submitted / pending / completed / failed

progress

integer

Прогресс: в очереди 10 → готово 50 → завершено 100

data

object

Данные результата

Показать Свойства

result

object

Присутствует, когда status равен completed

Показать Свойства result

music

array

Список результатов (за одну генерацию обычно 2 песни)

Показать Свойства music[]

audio_id

string

id аудиодорожки, используется для последующих операций через audio_index

title

string

Заголовок

duration

number

Длительность (секунды)

lyrics

string

Текст песни

Обзор

Текстовая серия

Серия изображений

Видеосерия

Аудиосерия

Серия модерации

Управление загрузками

Управление задачами

Управление аккаунтом

Suno: общие соглашения и запрос задачи

Аутентификация

Жизненный цикл задачи (все интерфейсы асинхронные)

Версия version

Ссылка на исходную аудиодорожку: task_id + audio_index

Запрос задачи: GET /v1/music/tasks/:task_id

Response

​Аутентификация

​Жизненный цикл задачи (все интерфейсы асинхронные)

​Версия version

​Ссылка на исходную аудиодорожку: task_id + audio_index

​Запрос задачи: GET /v1/music/tasks/:task_id

​Response

Аутентификация

Жизненный цикл задачи (все интерфейсы асинхронные)

Версия version

Ссылка на исходную аудиодорожку: task_id + audio_index

Запрос задачи: GET /v1/music/tasks/:task_id

Response