API do Nano Banana 2.1

Referência completa da API para os modelos de geração de imagens a partir de texto e edição de imagens Nano Banana 2.1.

Variantes do modelo

Esta API oferece suporte a duas variantes do modelo:

Comparação rápida

Proporções compatíveis

Ambos os modelos oferecem suporte a 14 proporções:

• 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1

Informe a proporção como valores numéricos separados de width e height; por exemplo, width: 16 e height: 9 selecionam 16:9. Esses valores descrevem uma proporção, não as dimensões de saída em pixels.

Nano Banana 2.1 (Geração de imagens a partir de texto)

Ponto de acesso

POST /api/v1/image/task

Autenticação

Authorization: Bearer YOUR_API_KEY

Parâmetros da requisição

Obrigatórios

Nota: A proporção width:height deve ser uma das seguintes: 16:9, 9:16, 1:1, 3:2, 2:3, 3:4, 4:3, 5:4, 4:5, 21:9, 1:4, 4:1, 1:8, 8:1.

Opcionais

Exemplo de requisição

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'nano-banana-2.1',
    prompt: 'A serene mountain landscape at sunset',
    width: 16,
    height: 9,
    resolution: '2k',
    enable_web_search: true,
    enable_image_search: false
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Nano Banana 2.1 Edit (Edição de imagens)

Ponto de acesso

POST /api/v1/image/task

Parâmetros da requisição

Obrigatórios

Nota: A proporção width:height deve ser uma das 14 proporções compatíveis listadas acima.

Opcionais

Exemplo de edição de uma única imagem

javascriptCopiar
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Change the sky to sunset colors',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image.jpg'],
  enable_web_search: false,
  enable_image_search: true
}

Exemplo de composição com múltiplas imagens

javascriptCopiar
{
  model_name: 'nano-banana-2.1-edit',
  prompt: 'Combine these images into a cohesive landscape',
  width: 16,
  height: 9,
  resolution: '2k',
  image_url_list: ['https://example.com/image1.jpg', 'https://example.com/image2.jpg', 'https://example.com/image3.jpg'],
  enable_web_search: false,
  enable_image_search: false
}

Nota sobre cobrança: As imagens de referência são cobradas por imagem desde a primeira. Cada opção de pesquisa ativada acrescenta uma cobrança fixa separada por geração, independentemente do número de imagens. Consulte os preços atuais para verificar as tarifas.

Formato da resposta

Resposta inicial

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "submitted"
  }
}

Resposta à consulta periódica

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "processing",
    "task_status_msg": null,
    "task_result": null
  }
}

Resposta bem-sucedida

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.074,
      "images": [
        {
          "url": "https://example.com/generated-image.png"
        }
      ]
    }
  }
}

Valores de status

• submitted: Tarefa aceita
• processing: Tarefa em execução
• succeed: Tarefa concluída com sucesso
• failed: Falha na tarefa

Boas práticas

Dicas para geração de imagens a partir de texto

1. Descreva a imagem: Inclua o assunto, a iluminação e a composição no prompt.
2. Escolha uma resolução: Envie 1k, 2k ou 4k em cada requisição.
3. Selecione uma proporção: Envie os valores de width e height correspondentes a uma das 14 proporções compatíveis.
4. Escolha as opções de pesquisa: Omita qualquer um dos parâmetros de pesquisa para usar seu valor padrão false; defina-o como true quando necessário.

Dicas para edição de imagens

1. Forneça imagens de referência: Inclua de uma a 14 URLs de imagens acessíveis em image_url_list.
2. Descreva a edição: Indique no prompt o que deve ser alterado ou preservado.
3. Selecione as configurações de saída: Forneça os valores obrigatórios de resolution, width e height.
4. Escolha as opções de pesquisa: A pesquisa na web e a pesquisa de imagens podem ser ativadas independentemente.