Статус запроса

Проверка статуса запроса

GEThttps://api.aisetup.ru/v1/requests/{id}

Header:Authorization: Bearer YOUR_KEY

Параметры

Параметр	Тип	Описание
id	string	ID запроса (execution id) из ответа 202 Accepted. Передаётся в пути.

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

curl -s "https://api.aisetup.ru/v1/requests/REQUEST_ID" \
  -H "Authorization: Bearer YOUR_KEY"

Ответы API

Структура ответа

Поле	Тип	Описание
id	string	ID запроса.
status	string	pending \| running \| success \| failed.
model	string	apiName модели.
createdAt	string	Дата создания (ISO).
updatedAt	string	Дата обновления (ISO).
completedAt	string\|null	Дата завершения или null.
result	object	Результат при status=success. Тип зависит от модели: image_generation / audio_generation / describe.
error	object	Ошибка при status=failed.

Пример тела ответа (JSON)

{
  "id": "REQUEST_ID",
  "error": null,
  "model": "suno-v5-5",
  "result": {
    "type": "audio_generation",
    "tracks": [
      {
        "mp3": "https://cdn.aisetup.ru/.../track_0.mp3",
        "wav": "https://cdn.aisetup.ru/.../track_0.wav",
        "title": "Ocean Drive",
        "audioId": "abc123"
      },
      {
        "mp3": "https://cdn.aisetup.ru/.../track_1.mp3",
        "title": "Ocean Drive",
        "audioId": "def456"
      }
    ]
  },
  "status": "success",
  "createdAt": "2026-06-17T09:00:00.000Z",
  "updatedAt": "2026-06-17T09:01:30.000Z",
  "completedAt": "2026-06-17T09:01:30.000Z"
}

Webhook

Ответы API

Структура ответа

Поле	Тип	Описание
id	string	ID запроса (execution id).
status	string	success \| failed.
request_id	string	ID исходного Request (только в webhook, отсутствует в polling).
model	string	apiName модели.
result	object	Результат при success. Структура идентична polling — зависит от модели: image_generation / audio_generation / describe.
error	object	Ошибка при failed.

Пример тела ответа (JSON)

{
  "id": "REQUEST_ID",
  "model": "suno-v5-5",
  "result": {
    "type": "audio_generation",
    "tracks": [
      {
        "mp3": "https://cdn.aisetup.ru/.../track_0.mp3",
        "wav": "https://cdn.aisetup.ru/.../track_0.wav",
        "title": "Ocean Drive",
        "audioId": "abc123"
      },
      {
        "mp3": "https://cdn.aisetup.ru/.../track_1.mp3",
        "title": "Ocean Drive",
        "audioId": "def456"
      }
    ]
  },
  "status": "success",
  "request_id": "REQUEST_ID"
}