Получение задачи

GET https://gptunnel.ru/api/v2/media/tasks/:id

Возвращает объект задачи по её идентификатору. Опрашивайте этот метод, пока статус не станет done или failed (либо получайте результат через webhook).

Path-параметры

Параметр	Тип	Описание
`id`*	`string`	24-значный идентификатор задачи из ответа на создание

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

curl --request GET \
  --url 'https://gptunnel.ru/api/v2/media/tasks/6a61e021a6e77553a989c41d' \
  --header 'Authorization: YOUR_API_KEY'

import axios from 'axios'

const id = '6a61e021a6e77553a989c41d'
const { data } = await axios.get(
  `https://gptunnel.ru/api/v2/media/tasks/${id}`,
  { headers: { Authorization: 'YOUR_API_KEY' } },
)

console.log(data.status, data.result)

import requests

task_id = '6a61e021a6e77553a989c41d'
response = requests.get(
    f'https://gptunnel.ru/api/v2/media/tasks/{task_id}',
    headers={'Authorization': 'YOUR_API_KEY'},
)

print(response.json())

Пример ответа (готово)

{
  "code": 0,
  "id": "6a61e021a6e77553a989c41d",
  "model": "kling-v3",
  "status": "done",
  "prompt": "a red fox running through snow, cinematic",
  "params": { "resolution": "1080p", "duration": 5, "aspect_ratio": "16:9" },
  "price": 210,
  "result": [
    { "url": "https://timenote.storage.yandexcloud.net/predication/6a61e021a6e77553a989c41d_result.mp4" }
  ],
  "created_at": 1784799265
}

Пример ответа (музыка, несколько дорожек)

{
  "code": 0,
  "id": "6a61e021a6e77553a989c41e",
  "model": "suno",
  "status": "done",
  "prompt": "lo-fi beat for late night coding",
  "price": 16.8,
  "result": [
    {
      "url": "https://timenote.storage.yandexcloud.net/suno/..._1.mp3",
      "id": "9f2c1b7a-...",
      "cover_url": "https://timenote.storage.yandexcloud.net/suno/..._1.jpg",
      "duration": 128,
      "title": "Late Night Compile",
      "lyric": "[Verse]\n...",
      "tags": "lo-fi, mellow, rainy"
    },
    {
      "url": "https://timenote.storage.yandexcloud.net/suno/..._2.mp3",
      "id": "4d81ea03-...",
      "cover_url": "https://timenote.storage.yandexcloud.net/suno/..._2.jpg",
      "duration": 131,
      "title": "Late Night Compile",
      "tags": "lo-fi, mellow, rainy"
    }
  ],
  "created_at": 1784799265
}

Suno на одну задачу отдаёт две дорожки — обе приходят в result. Поле id идентифицирует конкретную дорожку у провайдера.

Пример ответа (ошибка)

{
  "code": 0,
  "id": "6a61e021a6e77553a989c41d",
  "model": "kling-v3",
  "status": "failed",
  "error": { "code": 1001, "title": "SENSITIVE_CONTENT", "message": "Sensitive content has been detected in your request or uploaded files. Please check the text and media and try again." },
  "refunded": true,
  "created_at": 1784799265
}

Поля объекта задачи

Параметр	Тип	Описание
`id`*	`string`	Идентификатор задачи
`model`	`string`	Идентификатор запрошенной модели. При подмене снятой модели аналогом здесь остаётся то, что вы прислали; какая модель выполнила задачу, видно по заголовку x-model-served в ответе на создание
`status`*	`string`	queued \| running \| done \| failed
`params`	`object`	Применённые параметры генерации
`price`	`number`	Списанная стоимость в рублях
`result`*	`array`	Массив результатов при status: done, иначе пустой. У каждого элемента есть url. Модели, генерирующие несколько файлов за раз, возвращают несколько элементов в порядке готовности; музыкальные дополняют элемент полями id, cover_url, duration, title, lyric, tags
`error`	`object`	Причина отказа при status: failed. code — стабильный код для ветвления в коде, title — точный машиночитаемый код причины (может быть детальнее кода), message — человекочитаемое описание
`refunded`	`boolean`	Был ли возврат средств за неуспешную задачу
`created_at`	`number`	Время создания (Unix, секунды)