Começando com a Nano Banana Pro API

A Nano Banana Pro API é uma interface prática e pronta para produção para gerar imagens com os modelos mais recentes baseados no Gemini. Este guia da Nano Banana Pro API foca no uso no mundo real: como criar prompts, estruturar solicitações, interpretar respostas e construir um fluxo de trabalho no qual seu produto possa confiar.

Se você deseja a visão geral oficial, demonstrações e contexto do produto do Nano Banana 2, comece pelo hub do Nano Banana 2.

O que é a Nano Banana Pro API?

A Nano Banana Pro API oferece uma interface REST simples para geração de imagens de alta qualidade. Você envia um prompt e referências opcionais, e recebe saídas de imagem que pode armazenar e entregar em seu aplicativo. Ela foi projetada para equipes que precisam de resultados consistentes, fluxos de trabalho repetíveis e padrões de integração previsíveis.

Quando usar a Nano Banana Pro API

Use a Nano Banana Pro API quando quiser visuais rápidos e sob demanda sem construir um pipeline de modelo interno:

• Conteúdo de marketing para anúncios e landing pages
• Imagens de produtos para catálogos e listagens de e-commerce
• Rascunhos criativos para conceitos iniciais e mood boards

Capacidades Principais

A API é construída em torno de alguns pontos fortes principais que importam na produção:

• Geração de texto para imagem para transformar linguagem natural em visuais
• Criação de imagem para imagem para remixar ou construir sobre fotos existentes
• Saídas conscientes de referência para manter o estilo e o assunto consistentes
• Desempenho escalável para alimentar trabalhos em lote e fluxos de trabalho automatizados

Início Rápido da Nano Banana Pro API

1. Obter Acesso

Crie uma conta no painel da EvoLink, depois gere uma chave de API para o seu projeto. Mantenha a chave em um armazenamento de segredos seguro e nunca a exponha no código do lado do cliente.

2. Faça Sua Primeira Solicitação

Aqui está um exemplo mínimo de cURL. Substitua os espaços reservados pelos seus valores reais.

curl -X POST "API_BASE/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "prompt": "A beautiful sunset over mountains, digital art style",
    "size": "ASPECT_RATIO",
    "quality": "RESOLUTION_TIER"
  }'

3. Manipular a Resposta

A resposta geralmente inclui metadados e uma lista de URLs ou IDs de imagem. Persista os resultados rapidamente e armazene-os em sua própria camada de armazenamento para acesso de longo prazo.

{
  "created": 1737014400,
  "data": [
    {
      "url": "IMAGE_URL"
    }
  ]
}

Parâmetros Principais Que Você Deve Conhecer

Estes são os parâmetros que você usará com mais frequência ao chamar a Nano Banana Pro API:

• model: Use o modelo habilitado para sua conta. Escolha uma camada econômica para rascunhos e uma camada premium para ativos finais.
• prompt: Seu texto de instrução. Seja explícito sobre o assunto, estilo e humor.
• size: A proporção ou predefinição de tamanho que se ajusta ao seu posicionamento (quadrado, retrato ou paisagem).
• quality: O nível de resolução que você precisa para a saída final.
• image_urls: Imagens de referência opcionais se você quiser manter a consistência do assunto ou estilo.

Trabalhos Assíncronos e URLs de Imagem

Muitas equipes executam a API de forma assíncrona: envie um trabalho, consulte a tarefa até que ela termine, depois baixe e armazene a imagem. URLs podem ter tempo limitado, então trate-os como efêmeros e mova-os para seu próprio armazenamento assim que estiverem prontos.

Manual de Prompts

A maneira mais rápida de melhorar os resultados é usar uma estrutura de prompt clara. Uma fórmula simples funciona bem:

Assunto + Contexto + Estilo + Iluminação + Composição + Qualidade

Aqui estão mais dicas práticas de prompt:

1. Seja específico - Nomeie o assunto e descreva os detalhes principais.
2. Defina o estilo - Fotorrealista, aquarela, cinematográfico, editorial.
3. Controle a composição - Close-up, plano aberto, vista de cima ou centralizado.

Prompts de Exemplo

Controle de Qualidade e Iteração

Trate a geração como um ciclo de design rápido. Comece com um prompt amplo, depois itere:

• Adicione ou remova detalhes com base na primeira saída.
• Bloqueie um estilo antes de refinar um assunto.
• Salve os melhores prompts para que sua equipe possa reutilizá-los mais tarde.
• Use imagens de referência quando a consistência for importante em uma série.

Lista de Verificação de Produção

Use esta lista de verificação antes de lançar a Nano Banana Pro API em seu fluxo de trabalho:

• Chave de API armazenada em um armazenamento de segredos seguro no lado do servidor
• Prompts base documentados para seus principais casos de uso
• Imagens de saída salvas em armazenamento permanente

Resumo

A Nano Banana Pro API é uma maneira confiável de gerar visuais de alta qualidade com uma interface REST limpa. Comece com prompts claros, itere rapidamente e documente seus melhores resultados. Para equipes que lançam rápido, isso mantém o fluxo criativo em movimento sem ferramentas pesadas.