Перейти до основного вмісту
Основна функція 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. Припустимо, у нас є 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,
  "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, інформація про відповідь у завданні.

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

Це запит для перевірки деталей кількох 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,
      "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"
          }
        ]
      }
    }
  ],
  "count": 1
}
Повернене значення містить кілька полів, де items містить детальну інформацію про пакетні завдання, а конкретна інформація про кожне завдання є такою ж, як у попередньому запиті для одного завдання. Інформація про поля наведена нижче.
  • items, всі деталі пакетних завдань. Це масив, кожен елемент якого має таку ж структуру, як і повернене значення для запиту одного завдання.
  • count, кількість пакетних запитів у цьому запиті.

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

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

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

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Висновок

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