Guia Técnico da API Nano Banana 2

Documentação técnica detalhada para o Serviço de Produção Visual Nano Banana 2 utilizando capacidades avançadas de inteligência artificial

Ver PreçosExplore as opções de assinatura do Nano Banana 2

Introdução da API Nano Banana 2

A API de Produção Visual Nano Banana 2 permite integração com sistemas avançados de inteligência artificial para criar visuais premium a partir de descrições textuais e gráficos de exemplo. Nossa plataforma Nano Banana 2 oferece uma arquitetura REST simples com amplas capacidades de coordenação de tarefas e notificações.

Capacidades Principais do Nano Banana 2

• Transformação texto-para-visual do Nano Banana 2 usando sistemas de inteligência artificial de ponta
• Compatibilidade do Nano Banana 2 com gráficos de exemplo (máximo 4 imagens)
• Execução não-bloqueante de tarefas do Nano Banana 2 com monitoramento de progresso
• Integração webhook do Nano Banana 2 para atualizações instantâneas de status
• Arquitetura REST do Nano Banana 2 fornecendo respostas em formato JSON
• Sistema de verificação de credenciais Bearer do Nano Banana 2

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Guia de Implementação do Nano Banana 2

1. Registre-se para obter credenciais da API Nano Banana 2 através da nossa plataforma principal
2. Inclua seu token de acesso Nano Banana 2 no parâmetro Authorization
3. Envie uma solicitação POST para o terminal de criação visual Nano Banana 2
4. Use o identificador de tarefa Nano Banana 2 fornecido para verificação de status
5. Obtenha seus visuais fabricados Nano Banana 2 após a conclusão da tarefa

Verificação de Identidade

Toda submissão de API requer autenticação através de verificação de token Bearer. Inclua suas credenciais de acesso no parâmetro Authorization para cada transmissão.

Método de Verificação

Implemente a validação de token HTTP Bearer incorporando suas credenciais de acesso no parâmetro Authorization:

Authorization: Bearer <your-api-key>

Estrutura de Exemplo da Chave de Acesso

Authorization: Bearer dk-1234567890abcdef

Demonstração de Submissão

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

Verificação Bem-sucedida

✅ Credenciais de acesso permanecem atuais
✅ Registro do cliente mantém status ativo
✅ Créditos de serviço adequados persistem

Problemas Frequentes

❌ Credenciais de acesso ausentes
❌ Configuração incorreta da chave de acesso
❌ Registro desativado ou suspenso

API de Produção Visual Nano Banana 2

Crie imagens utilizando Nano Banana 2 com sistemas de inteligência artificial sofisticados e instruções textuais adaptáveis mais imagens de amostra.

Terminal de Conexão

POST /api/image/gen

Variáveis de Submissão

Parameter	Type	Required	Description
model	string	Yes	Model identifier (e.g., "google/gempix2")
prompt	string	Yes	Text prompt describing the image
images	array	No	Reference image URLs (max 4)
callback_url	string	No	Webhook URL for completion notifications

Ilustrações de Implementação

Criação Visual Fundamental do Nano Banana 2

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

Produção Baseada em Referência do Nano Banana 2 com Gráficos de Amostra

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

Estrutura de Saída

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

Gerenciamento de Problemas

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

API de Status de Trabalho Nano Banana 2

Investigar o progresso e resultados de trabalhos de produção visual Nano Banana 2 utilizando o identificador de tarefa fornecido pelo terminal de criação visual Nano Banana 2.

Terminal de Conexão

GET /api/task/query?task_id=<task_id>

Variáveis de Investigação

Parameter	Type	Required	Description
task_id	string	Yes	Unique task identifier returned from generation endpoint

Ilustração de Submissão

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

Categorias de Status de Trabalho Nano Banana 2

pending - Inicialização do trabalho Nano Banana 2 concluída aguardando início do processamento

submitted - Trabalho Nano Banana 2 inserido na sequência de produção

in_progress - Trabalho Nano Banana 2 atualmente em processamento ativo

success - Trabalho Nano Banana 2 finalizado com sucesso com visuais fabricados

failed - Trabalho Nano Banana 2 terminado devido a complicações técnicas

Respostas de Problema

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

Estruturas de Informação Nano Banana 2

Documentação abrangente para todas as configurações e modelos de informação Nano Banana 2 utilizados nas comunicações e submissões da API.

ImageGenResult

Represents a generated image result.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}

Field	Type	Description
image	string	Image URL or base64 data URI

CallbackPayload

Payload sent to the callback_url when task status changes to final states.

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}

Field	Type	Description
result	array	Array of ImageGenResult objects (null if failed)
status	string	Final task status (success/failed)
task_id	string	Unique task identifier
consumed	string	Credits consumed by the task
status_reason	object	Status details including error message if failed

Configurações Suportadas Nano Banana 2

google/gempix2Nano Banana image generation model

google/gemini-2.5-flash-imageGemini 2.5 Flash image model

Gestão de Problemas

Manual completo para gerenciar complicações e interpretar indicadores de resposta da API. Todas as notificações de problemas seguem formatação padronizada permitindo metodologias eficientes de resolução.

Indicadores de Resposta HTTP

200

OK

Request was successful

400

Bad Request

Invalid request parameters or malformed JSON

401

Unauthorized

Invalid, missing, or expired API key

404

Not Found

Task not found or endpoint doesn't exist

500

Internal Server Error

Server-side error occurred

Abordagens Recomendadas para Resolução de Problemas

Sempre verificar indicadores de resposta HTTP antes de analisar o conteúdo de saída
Implementar algoritmos de atraso progressivo para mecanismos de repetição durante complicações 500
Documentar notificações de problemas com detalhes completos para fins de solução de problemas
Confirmar validade da entrada antes do envio da solicitação para prevenir complicações 400
Resolver problemas de verificação solicitando atualizações de credenciais da API dos clientes
Acompanhar progresso do trabalho em intervalos razoáveis em vez de consultas excessivas de status
Empregar integração de webhook sempre que possível para eliminar monitoramento constante de conclusão

Gestão de Problemas Ilustrativa (JavaScript)

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}