Saltar al contenido principal
La principal función de la API de Tareas de Nano Banana es consultar el estado de ejecución de una tarea mediante el ID de tarea generado por la API de Imágenes de Nano Banana. Este documento detallará las instrucciones de integración de la API de Tareas de Nano Banana, ayudándole a integrar y aprovechar al máximo las potentes funciones de esta API. A través de la API de Tareas de Nano Banana, puede consultar fácilmente el estado de ejecución de las tareas de la API de Imágenes de Nano Banana.

​
Ejemplo de solicitud

La API de Tareas de Nano Banana se puede utilizar para consultar los resultados de la API de Imágenes de Nano Banana. Para saber cómo usar la API de Imágenes de Nano Banana, consulte el documento API de Imágenes de Nano Banana. Tomaremos como ejemplo un ID de tarea devuelto por el servicio de la API de Imágenes de Nano Banana, y demostraremos cómo usar esta API. Supongamos que tenemos un ID de tarea: 4d320ead-4af4-4a55-8f3e-f2afebdf4fd0, a continuación, demostraremos cómo pasar un ID de tarea.

​
Ejemplo de tarea

​
Configuración de encabezados de solicitud y cuerpo de solicitud

Encabezados de solicitud incluyen:
  • accept: especifica que se aceptan respuestas en formato JSON, aquí se debe llenar como application/json.
  • authorization: clave para llamar a la API, que se puede seleccionar directamente después de solicitarla.
Cuerpo de solicitud incluye:
  • id: ID de tarea cargado.
  • action: forma de operar sobre la tarea.
Configuración como se muestra en la siguiente imagen:

​
Ejemplo de código

Se puede observar que en el lado derecho de la página se han generado automáticamente códigos en varios lenguajes, como se muestra en la imagen:

Algunos ejemplos de código son los siguientes:

​
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)

​
Ejemplo de respuesta

Después de una solicitud exitosa, la API devolverá la información detallada de la tarea aquí. Por ejemplo: 
{
  "_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": "un gato siamés blanco"
  },
  "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": "un gato siamés blanco",
        "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
      }
    ]
  }
}
El resultado devuelto tiene varios campos, el campo request es el cuerpo de la solicitud al iniciar la tarea, mientras que el campo response es el cuerpo de respuesta devuelto después de completar la tarea. La descripción de los campos es la siguiente.
  • id, ID que generó esta tarea, utilizado para identificar de manera única esta tarea generada.
  • request, información de solicitud en la tarea consultada.
  • response, información de respuesta en la tarea consultada.

​
Operación de consulta por lotes

Esto es para consultar los detalles de varias tareas ID, a diferencia de lo anterior, se debe seleccionar la acción como retrieve_batch. Cuerpo de solicitud incluye:
  • ids: arreglo de IDs de tareas cargadas.
  • action: forma de operar sobre la tarea.
Ejemplo a continuación: 
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"
}'

​
Ejemplo de respuesta

Después de una solicitud exitosa, la API devolverá la información detallada de todas las tareas en lote. Por ejemplo: 
{
  "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": "un gato siamés blanco"
      },
      "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": "un gato siamés blanco",
            "image_url": "https://platform.cdn.acedata.cloud/nanobanana/7e7bd000-698a-4e14-bb2d-3db61237e4bb.png"
          }
        ]
      }
    }
  ],
  "count": 1
}
El resultado devuelto tiene varios campos, donde items contiene la información detallada de las tareas en lote, la información específica de cada tarea es igual a la del resultado de la consulta de una sola tarea, la información de los campos es la siguiente.
  • items, toda la información detallada de las tareas en lote. Es un arreglo, cada elemento del arreglo tiene el mismo formato que el resultado de la consulta de una sola tarea.
  • count, el número de tareas consultadas en este lote.

​
Manejo de Errores

Al llamar a la API, si se encuentra con un error, la API devolverá el código de error y la información correspondiente. Por ejemplo:
  • 400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 401 invalid_token: No autorizado, token de autorización inválido o faltante.
  • 429 too_many_requests: Demasiadas solicitudes, ha superado el límite de tasa.
  • 500 api_error: Error interno del servidor, algo salió mal en el servidor.

​
Ejemplo de Respuesta de Error

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "la recuperación falló"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Conclusión

A través de este documento, ha comprendido cómo utilizar la API de Nano Banana Tasks para consultar información detallada sobre tareas individuales o en lote. Esperamos que este documento le ayude a integrar y utilizar mejor esta API. Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de soporte técnico.