Інтеграція та використання Nano Banana Tasks API

Основна функція Nano Banana Tasks API полягає в тому, щоб за допомогою введеного ID завдання, згенерованого 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 API, будь ласка, зверніться до документації Nano Banana Images API. Ми візьмемо ID завдання, повернутого сервісом Nano Banana Images API, як приклад, щоб продемонструвати, як використовувати цей API. Припустимо, у нас є ID завдання: 4d320ead-4af4-4a55-8f3e-f2afebdf4fd0, далі демонструємо, як передати цей ID завдання.

Приклад зображення завдання

Налаштування заголовків запиту та тіла запиту

Request Headers включає:

accept: вказує на прийняття відповіді у форматі JSON, тут вказується application/json.
authorization: ключ для виклику API, який можна вибрати після подачі заявки.

Request Body включає:

id: ID завдання, яке потрібно завантажити.
action: спосіб виконання завдання.

Налаштування, як показано на малюнку нижче:

Приклад коду

Можна помітити, що на правій стороні сторінки автоматично згенеровано код на різних мовах, як показано на малюнку:

Деякі приклади коду наведені нижче:

CURL

curl -X POST 'https://api.acedata.cloud/nano-banana/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
  "action": "retrieve"
}'

Python

import requests

url = "https://api.acedata.cloud/nano-banana/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Приклад відповіді

Після успішного запиту API поверне детальну інформацію про це завдання. Наприклад:

{
  "_id": "68bc7c3c550a4144a53d0e24",
  "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
  "api_id": "9d8a117e-31ca-4322-a0fd-1771296ec610",
  "application_id": "8afd681a-2a4e-4265-aecb-43970094c019",
  "created_at": 1757183036.787,
  "started_at": 1757183036.847,
  "finished_at": 1757183048.147,
  "elapsed": 11.3,
  "credential_id": "097b2987-62f4-4ac0-b0cc-aed41e372a07",
  "request": {
    "action": "generate",
    "prompt": "a white siamese cat"
  },
  "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
  "type": "images",
  "user_id": "b87f67c1-b04f-4332-99a1-7a5e651331c6",
  "response": {
    "success": true,
    "task_id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
    "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
    "data": [
      {
        "prompt": "a white siamese cat",
        "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
      }
    ]
  }
}

Повернене значення містить кілька полів, поле request є тими даними, які були надіслані під час створення завдання, а поле response є тими даними, які повертаються після завершення завдання. Ось опис полів.

id, ID, що генерує це завдання, використовується для унікальної ідентифікації цього завдання.
request, інформація про запит у завданні.
response, інформація про відповідь у завданні.
created_at, час створення завдання, Unix-час (секунди, з плаваючою комою).
started_at, час початку виконання завдання, Unix-час (секунди, з плаваючою комою).
finished_at, час завершення завдання, Unix-час (секунди, з плаваючою комою). Це поле не повертається, якщо завдання не завершено.
elapsed, час виконання завдання, в секундах (з плаваючою комою, з 3 знаками після коми). Це поле не повертається, якщо завдання не завершено.

Пакетний запит

Це запит для перевірки деталей кількох ID завдань, на відміну від попереднього, потрібно вибрати action як retrieve_batch. Request Body включає:

ids: масив ID завдань, які потрібно завантажити.
action: спосіб виконання завдання.

Приклад наведено нижче:

curl -X POST 'https://api.acedata.cloud/nano-banana/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed","1ebe4f2b-59ba-4385-a4ea-0ce8a3fe12ed"],
  "action": "retrieve_batch"
}'

Приклад відповіді

Після успішного запиту API поверне детальну інформацію про всі пакетні завдання. Наприклад:

{
  "items": [
    {
      "_id": "68bc7c3c550a4144a53d0e24",
      "id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
      "api_id": "9d8a117e-31ca-4322-a0fd-1771296ec610",
      "application_id": "8afd681a-2a4e-4265-aecb-43970094c019",
      "created_at": 1757183036.787,
      "started_at": 1757183036.847,
      "finished_at": 1757183048.147,
      "elapsed": 11.3,
      "credential_id": "097b2987-62f4-4ac0-b0cc-aed41e372a07",
      "request": {
        "action": "generate",
        "prompt": "білий сіамський кіт"
      },
      "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
      "type": "images",
      "user_id": "b87f67c1-b04f-4332-99a1-7a5e651331c6",
      "response": {
        "success": true,
        "task_id": "4d320ead-4af4-4a55-8f3e-f2afebdf4fd0",
        "trace_id": "7ba1f1e8-0ef8-450d-8bb2-b5c3bf1ea319",
        "data": [
          {
            "prompt": "білий сіамський кіт",
            "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
          }
        ]
      }
    }
  ],
  "count": 1
}

Повернення результату містить кілька полів, де items містить конкретну інформацію про пакетні завдання, кожне завдання має таку ж інформацію, як і в попередньому запиті на одиничне завдання. Поля інформації такі:

items, вся конкретна інформація про пакетні завдання. Це масив, кожен елемент масиву має таку ж структуру, як і результат запиту на одиничне завдання.
count, кількість пакетних запитів.

Обробка помилок

При виклику API, якщо виникає помилка, API повертає відповідний код помилки та інформацію. Наприклад:

400 token_mismatched: Неправильний запит, можливо, через відсутні або недійсні параметри.
400 api_not_implemented: Неправильний запит, можливо, через відсутні або недійсні параметри.
401 invalid_token: Неавторизовано, недійсний або відсутній токен авторизації.
429 too_many_requests: Занадто багато запитів, ви перевищили ліміт запитів.
403 forbidden: Відмова запиту або генерації результату через безпекову політику постачальника; якщо всі виклики генерації були відхилені, завдання зберігається в стані невдачі, не містить зображень і не підлягає оплаті. У запитах на кілька зображень інші успішні виклики все ще можуть повертатися та оплачуватися відповідно до фактичної кількості.
500 api_error: Внутрішня помилка сервера, щось пішло не так на сервері.

Приклад відповіді на помилку

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "не вдалося отримати"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Висновок

Завдяки цьому документу ви дізналися, як використовувати API Nano Banana Tasks для запиту всієї конкретної інформації про одиничні або пакетні завдання. Сподіваємося, цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

Ідентичність

Проксі

Advanced

Coding

Інтеграція та використання Nano Banana Tasks API

Приклад запиту

Приклад зображення завдання

Налаштування заголовків запиту та тіла запиту

Приклад коду

CURL

Python

Приклад відповіді

Пакетний запит

Приклад відповіді

Обробка помилок

Приклад відповіді на помилку

Висновок

​Приклад запиту

​Приклад зображення завдання

​Налаштування заголовків запиту та тіла запиту

​Приклад коду

​CURL

​Python

​Приклад відповіді

​Пакетний запит

​Приклад відповіді

​Обробка помилок

​Приклад відповіді на помилку

​Висновок

Приклад запиту

Приклад зображення завдання

Налаштування заголовків запиту та тіла запиту

Приклад коду

CURL

Python

Приклад відповіді

Пакетний запит

Приклад відповіді

Обробка помилок

Приклад відповіді на помилку

Висновок