Skip to main content
A principal função da API Nano Banana Tasks é consultar o status de execução de tarefas através do ID da tarefa gerado pela API Nano Banana Images. Este documento irá detalhar as instruções de integração da API Nano Banana Tasks, ajudando você a integrar facilmente e aproveitar ao máximo o poderoso recurso dessa API. Com a API Nano Banana Tasks, você pode consultar facilmente o status de execução das tarefas da API Nano Banana Images.

​
Exemplo de Requisição

A API Nano Banana Tasks pode ser usada para consultar os resultados da API Nano Banana Images. Para saber como usar a API Nano Banana Images, consulte o documento API Nano Banana Images. Usaremos um exemplo de ID de tarefa retornado pelo serviço da API Nano Banana Images. Suponha que temos um ID de tarefa: 4d320ead-4af4-4a55-8f3e-f2afebdf4fd0, a seguir, demonstraremos como passar um ID de tarefa.

​
Exemplo de Tarefa

​
Configurando Cabeçalhos e Corpo da Requisição

Cabeçalhos da Requisição incluem:
  • accept: especifica que a resposta deve ser no formato JSON, preenchido como application/json.
  • authorization: chave para chamar a API, que pode ser selecionada diretamente após a solicitação.
Corpo da Requisição inclui:
  • id: ID da tarefa enviada.
  • action: modo de operação da tarefa.
Configuração conforme mostrado na imagem abaixo:

​
Exemplo de Código

Pode-se notar que, no lado direito da página, foram gerados automaticamente códigos em várias linguagens, conforme mostrado na imagem:

Alguns exemplos de código são os seguintes:

​
CURL

​
Python

​
Exemplo de Resposta

Após uma requisição bem-sucedida, a API retornará as informações detalhadas da tarefa aqui. Por exemplo:
O resultado retornado contém vários campos, o campo request é o corpo da requisição ao iniciar a tarefa, enquanto o campo response é o corpo da resposta retornada após a conclusão da tarefa. A descrição dos campos é a seguinte.
  • id, ID gerado para esta tarefa, usado para identificar exclusivamente esta tarefa gerada.
  • request, informações da requisição na consulta da tarefa.
  • response, informações da resposta na consulta da tarefa.
  • created_at, data de criação da tarefa, timestamp Unix (segundos, ponto flutuante).
  • started_at, data de início da execução da tarefa, timestamp Unix (segundos, ponto flutuante).
  • finished_at, data de conclusão da tarefa, timestamp Unix (segundos, ponto flutuante). Este campo não é retornado se a tarefa não estiver concluída.
  • elapsed, tempo gasto na execução da tarefa, em segundos (ponto flutuante, com 3 casas decimais). Este campo não é retornado se a tarefa não estiver concluída.

​
Operação de Consulta em Lote

Esta operação é para consultar detalhes de várias IDs de tarefas, diferentemente do anterior, onde a ação deve ser selecionada como retrieve_batch. Corpo da Requisição inclui:
  • ids: array de IDs de tarefas enviadas.
  • action: modo de operação da tarefa.
Exemplo abaixo:

​
Exemplo de Resposta

Após uma requisição bem-sucedida, a API retornará as informações detalhadas de todas as tarefas em lote. Por exemplo:
返回结果一共有多个字段，其中 items 是包含了批量任务的具体详情信息，每个任务的具体信息与上文的字段一样，字段信息如下。
  • items，批量任务的所有具体详情信息。Ele é um array, cada elemento do array tem o mesmo formato do resultado da consulta de uma única tarefa.
  • count，此处批量查询任务的个数。

​
错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：
  • 400 token_mismatched：Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
  • 400 api_not_implemented：Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
  • 401 invalid_token：Não autorizado, token de autorização inválido ou ausente.
  • 429 too_many_requests：Muitas solicitações, você excedeu o limite de taxa.
  • 403 forbidden：A política de segurança nativa do provedor negou a solicitação ou a geração de resultados; se todas as chamadas de geração forem negadas, a tarefa será salva em estado de falha, não conterá imagens e não será cobrada. Em solicitações de várias imagens, as outras chamadas bem-sucedidas ainda podem retornar e serão cobradas de acordo com o número real.
  • 500 api_error：Erro interno do servidor, algo deu errado no servidor.

​
错误响应示例

​
结论

通过本文档，您已经了解了如何使用 Nano Banana Tasks API 进行查询单个或批量任务的所有具体详情信息。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。