Файлы и медиа URL

Медиа передаются в полях объекта input. Используйте публичные HTTPS URL, которые внешний провайдер может открыть без cookie, заголовков авторизации и интерактивного входа.


{
  "model": "nano-banana-2",
  "input": {
    "prompt": "Replace the background with a clean studio wall",
    "imageUrls": ["https://cdn.example.com/source.png"]
  }
}

Точное название поля и максимальное количество файлов зависят от модели. Сверяйтесь с таблицей параметров выбранной модели: универсального поля для медиа нет.

Контрольный список ввода

Возвращайте тело файла напрямую, а не страницу предварительного просмотра HTML.
Держите URL доступным на протяжении всей генерации.
Используйте тип медиа и размер, принятые выбранной моделью.
Избегайте временных подписанных URL, если срок их действия меньше времени обработки.

Сгенерированные файлы

Успешные медиазадачи возвращают URL-адреса хранения API Hubs в data.files:


{
  "files": [
    {
      "fileUrl": "https://s3.apihubs.ru/generated/result.png",
      "fileType": "image"
    }
  ]
}

Скачайте результаты после того, как задание станет finished, и скопируйте постоянные ресурсы в хранилище, которым вы управляете. Рассматривайте их как URL доставки, а не как архивный контракт.