Skip to main content
Основная функция API Nano Banana Tasks заключается в том, чтобы запрашивать статус выполнения задачи, используя идентификатор задачи, сгенерированный API Nano Banana Images. В этом документе подробно описывается интеграция API Nano Banana Tasks, чтобы помочь вам легко интегрировать и в полной мере использовать мощные возможности этого API. С помощью API Nano Banana Tasks вы можете легко запрашивать статус выполнения задач API Nano Banana Images.

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

API Nano Banana Tasks можно использовать для запроса результатов API Nano Banana Images. Для получения информации о том, как использовать API Nano Banana Images, обратитесь к документации Nano Banana Images API. Мы возьмем в качестве примера идентификатор задачи, возвращаемый службой API Nano Banana Images, и продемонстрируем, как использовать этот API. Предположим, у нас есть идентификатор задачи: 4d320ead-4af4-4a55-8f3e-f2afebdf4fd0, далее мы покажем, как передать этот идентификатор задачи.

​
Пример изображения задачи

​
Установка заголовков запроса и тела запроса

Request Headers включает:
  • accept: указывает на прием ответа в формате JSON, здесь указывается application/json.
  • authorization: ключ для вызова API, который можно выбрать из выпадающего списка после запроса.
Request Body включает:
  • id: загруженный идентификатор задачи.
  • action: способ выполнения операции над задачей.
Настройка, как показано на следующем изображении:

​
Пример кода

Можно заметить, что на правой стороне страницы автоматически сгенерирован код на различных языках, как показано на изображении:

Некоторые примеры кода приведены ниже:

​
CURL

​
Python

​
Пример ответа

После успешного запроса API вернет информацию о деталях этой задачи. Например:
Возвращаемый результат содержит несколько полей, поле request — это тело запроса, отправленное при создании задачи, в то время как поле response — это тело ответа, возвращенное после завершения задачи. Описание полей следующее.
  • id: идентификатор, сгенерированный для этой задачи, используется для уникальной идентификации данной задачи.
  • request: информация о запросе в задаче.
  • response: информация о возвращаемом ответе в задаче.
  • created_at: время создания задачи, Unix временная метка (секунды, с плавающей точкой).
  • started_at: время начала выполнения задачи, Unix временная метка (секунды, с плавающей точкой).
  • finished_at: время завершения задачи, Unix временная метка (секунды, с плавающей точкой). Это поле не возвращается, если задача не завершена.
  • elapsed: время выполнения задачи, в секундах (с плавающей точкой, с 3 знаками после запятой). Это поле не возвращается, если задача не завершена.

​
Пакетный запрос

Это запрос для получения деталей нескольких идентификаторов задач, в отличие от вышеуказанного, необходимо выбрать action как retrieve_batch. Request Body включает:
  • ids: массив загруженных идентификаторов задач.
  • action: способ выполнения операции над задачей.
Пример приведен ниже:

​
Пример ответа

После успешного запроса API вернет конкретные детали всех пакетных задач. Например:
Возвращаемый результат содержит несколько полей, среди которых items включает в себя конкретные детали пакетных задач, каждая задача имеет такую же структуру полей, как и вышеупомянутое возвращаемое значение для одиночной задачи.
  • items, все конкретные детали пакетной задачи. Это массив, каждый элемент массива имеет такую же структуру, как и возвращаемый результат для одиночной задачи.
  • count, количество задач в данной пакетной выборке.

​
Обработка ошибок

При вызове API, если возникает ошибка, API возвращает соответствующий код ошибки и информацию. Например:
  • 400 token_mismatched：Неверный запрос, возможно, из-за отсутствия или недействительных параметров.
  • 400 api_not_implemented：Неверный запрос, возможно, из-за отсутствия или недействительных параметров.
  • 401 invalid_token：Неавторизован, недействительный или отсутствующий токен авторизации.
  • 429 too_many_requests：Слишком много запросов, вы превысили лимит частоты.
  • 403 forbidden：Запрос или результат генерации отклонены исходной политикой безопасности поставщика; если все вызовы генерации отклонены, задача сохраняется в состоянии неудачи, не содержит изображений и не подлежит оплате. В многокартинных запросах остальные успешные вызовы могут быть возвращены и оплачены по факту.
  • 500 api_error：Внутренняя ошибка сервера, что-то пошло не так на сервере.

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

​
Заключение

С помощью этого документа вы узнали, как использовать API Nano Banana Tasks для запроса всех конкретных деталей одиночных или пакетных задач. Надеемся, что этот документ поможет вам лучше интегрировать и использовать данный API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.