Задачи и результаты

Любая генерация — это задача. POST на создание возвращает задачу с кодом 202 Accepted. Дальше статус меняется: pending → queued → processing → succeeded / failed.

Объект задачи

{
  "id": "cmg4k9x2a0003kz0f1n2m3p4q",
  "object": "task",
  "type": "image",
  "model": "nanobanana-pro",
  "mode": null,
  "status": "succeeded",
  "created_at": "2026-09-28T15:05:02.114Z",
  "started_at": "2026-09-28T15:05:03.020Z",
  "finished_at": "2026-09-28T15:05:41.870Z",
  "prompt": "Уютная кофейня в дождливом Петербурге",
  "input": { "resolution": "2K", "aspect_ratio": "16:9", "images": [] },
  "metadata": { "order_id": "A-1024" },
  "cost": { "credits": 20, "refunded": 0 },
  "result": {
    "files": [
      {
        "type": "image",
        "url": "https://neuronovo.ru/api/v1/content/eyJhIjoi…",
        "url_expires_at": "2026-09-29T15:10:00.000Z",
        "content_type": "image/png",
        "width": 2752,
        "height": 1536,
        "bytes": 5213440
      }
    ],
    "file_expires_at": "2026-10-05T15:05:41.000Z",
    "deleted": false
  },
  "error": null,
  "refund": null,
  "queue": null,
  "callback_url": null
}

Параметр	Тип	Описание
status	string	pending, queued, processing, succeeded, failed, cancelled
cost.credits	integer	Списано Мыслей при создании
cost.refunded	integer	Возвращено Мыслей (при ошибке или отмене)
result.files[]	array	Файлы результата. Для видео дополнительно есть превью (type: preview).
result.files[].url	string	Подписанная ссылка на файл без авторизации. Действует 24 ч (url_expires_at).
result.file_expires_at	string	Когда файл будет удалён из хранилища (по сроку хранения вашего тарифа)
error	object	code и message на русском, если задача не удалась
queue.position	integer	Позиция в очереди аккаунта (только для pending)
metadata	object	Ваши данные из запроса — вернутся без изменений

Ссылка на файл временная, а сам файл хранится дольше. Если ссылка истекла, запросите задачу ещё раз — в ответе будет новая ссылка. Скачивайте результаты к себе, если они нужны дольше срока хранения.

Список задач

GET /v1/tasks?limit=20&status=succeeded&type=image — последние задачи API. Для следующей страницы передайте cursor из поля next_cursor.

Отмена

DELETE /v1/tasks/{id} отменяет задачу в статусе pending и возвращает Мысли полностью. Задачу, которая уже передана в работу, отменить нельзя (409 task_not_cancellable).

Где видны результаты

Работы, созданные через API, не попадают в общую ленту студии. Их можно посмотреть в студии на вкладке «Создано через API» — она появляется после первой API-генерации.