메인 콘텐츠로 건너뛰기
Nano Banana Tasks API의 주요 기능은 Nano Banana Images API에서 생성된 작업 ID를 입력하여 해당 작업의 실행 상태를 조회하는 것입니다. 본 문서는 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를 참조하십시오. Nano Banana Images API 서비스에서 반환된 작업 ID를 예로 들어, 이 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 필드는 작업을 시작할 때의 request body이고, response 필드는 작업 완료 후 반환된 response body입니다. 필드 설명은 다음과 같습니다.
  • 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를 더 잘 연동하고 사용하는 데 도움이 되기를 바랍니다. 질문이 있으시면 언제든지 기술 지원 팀에 문의해 주십시오.