Conceitos de produto e lifestyle
Crie cenas relacionadas a produtos a partir de prompts ou modifique uma única foto de produto para tratamentos visuais alternativos.
Nano Banana API. Geração e edição de imagens.
Leve a geração e edição de imagens Nano Banana para o seu produto com a Topview API. Gere imagens em cinco proporções compatíveis, edite uma única imagem de entrada e use preços claros por imagem, sem um nível de resolução selecionável.
Mais baixo que a tarifa oficial5 proporçõesUm tamanho de saída padrãoEdição de imagem única
TESTE a Nano Banana API DE GRAÇA
Configurações
Text to Image
As configurações aqui são uma prévia. Gerar copia seu prompt e abre o Platform Playground correspondente, onde você confirma as configurações finais.
ESPECIFICAÇÕES DO MODELO
Conheça as configurações antes de construir.
Referência rápida das configurações do Nano Banana listadas na documentação da Topview API Platform. Cada modo tem seus próprios requisitos de entrada.
| Parâmetro | Valor |
|---|---|
| Provedor / Modelo | Google / Nano Banana |
| Rota da API | google/nano-banana |
| Modos de geração | Text to Image · Image Editing |
| Resolução | Standard output (no resolution parameter) |
| Proporções | 1:1 · 16:9 · 9:16 · 4:3 · 3:4 |
| Entradas de Image Editing | 1 image |
| Comprimento do prompt | Up to 4,000 characters |
| Padrão de tarefa | Async submission + polling + output retrieval |
| Preços | Per generated image; settlement follows actual usage |
QUICKSTART PARA DESENVOLVEDORES
Da chave de API à sua primeira imagem.
Envie uma previsão assíncrona com sua chave de API da Platform e consulte o ID da tarefa retornado para obter a saída.
# Set TOPVIEW_API_PLATFORM_KEY once. Preserve REQUEST_KEY and input for uncertain retries.
# For a NEW task only, unset REQUEST_KEY first. Save data.id to resume GET only.
: "${TOPVIEW_API_PLATFORM_KEY:?Set TOPVIEW_API_PLATFORM_KEY first}"
export REQUEST_KEY="${REQUEST_KEY:-$(uuidgen)}"
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/models/google/nano-banana/text-to-image/predictions' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY" \
-H "Idempotency-Key: $REQUEST_KEY" \
-H 'Content-Type: application/json' \
--data '{
"prompt": "A blue ceramic cup on a wooden table",
"aspect_ratio": "1:1"
}'
# Poll data.id until completed or failed.
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/predictions/REQUEST_ID' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY"O exemplo corresponde à solicitação text-to-image do Nano Banana na documentação da Platform. Mantenha TOPVIEW_API_PLATFORM_KEY apenas no servidor.
Etapa 1
Obtenha sua chave de API
Entre na Topview API Platform e crie uma chave de API com as permissões de modelo necessárias. Mantenha a chave segura e use-a para autenticar solicitações de API.
Etapa 2
Gerar ou editar uma imagem
Envie um prompt de texto ou faça upload de imagens de referência para edição. Configure as definições de imagem compatíveis, envie a solicitação de API e salve o ID da tarefa retornado.
Etapa 3
Recupere sua imagem
Verifique o status da tarefa até a geração concluir. Recupere as URLs das imagens, revise o custo final de uso e salve as imagens geradas.
FEITO PARA FLUXOS DE PRODUÇÃO
Adicione criação e edição de imagens simples a apps do dia a dia
A Nano Banana API original oferece tarefas comuns de geração de imagens com um tamanho de saída padrão e um conjunto focado de controles de edição por referência.
Gráficos sociais em cinco proporções
Gere conceitos quadrados, paisagem ou retrato nas cinco proporções compatíveis, incluindo 4:3 e 3:4.
Edições criativas de uma imagem
Permita que os usuários reestilizem uma foto, mudem o entorno ou explorem novas composições com uma única entrada de edição.
Recursos de imagem iniciais
Adicione geração text-to-image básica e edição de uma imagem a ferramentas para criadores, fluxos internos ou pequenos apps de marketing.
POR QUE TOPVIEW API
Um ponto de entrada simples para a Nano Banana API original
A Topview fornece os modos e opções de formato documentados para equipes que querem o modelo original em vez de uma variante Nano Banana mais recente.
Um modelo de preços em tamanho padrão
Revise a tarifa atual por imagem sem adicionar seletores de resolução 2K ou 4K não suportados.
Cinco proporções compatíveis
Teste 1:1, 16:9, 9:16, 4:3 e 3:4 antes de mapear as configurações de saída do seu produto.
Testar edição de uma imagem
Explore edições baseadas em prompt com uma única foto de origem usando a rota de edição dedicada e os requisitos de entrada documentados.
Comparar a família Nano Banana
Use um único workspace Topview para avaliar o modelo original em relação a Lite, 2 e 2.1 conforme suas necessidades de saída e edição evoluem.
Perguntas frequentes da Nano Banana API
Você pode abrir o Nano Banana Playground para explorar as configurações. O uso da API é pago pelo saldo USD da Platform, e os créditos promocionais variam. Verifique a elegibilidade e o saldo atuais do seu workspace na Topview API Platform.
A Topview API Platform lista Text to Image e Image Editing. Image Editing aceita uma imagem de entrada junto com seu prompt.
Nano Banana oferece 1:1, 16:9, 9:16, 4:3 e 3:4. Não há parâmetro de resolução; cada solicitação retorna um tamanho de saída padrão.
Nano Banana e Nano Banana 2 Lite oferecem preços simples por imagem sem seletor de resolução. Escolha com base nas proporções compatíveis, entradas de edição e na tarifa atual. Para saída 2K ou 4K selecionável, compare Nano Banana 2 e Nano Banana 2.1.
Crie uma chave de API da Platform, envie uma prediction ao endpoint do Nano Banana com um Idempotency-Key, salve o ID da tarefa retornado e consulte até concluir. Depois baixe as imagens rapidamente, pois as URLs de resultado podem expirar. Mantenha a chave no servidor.
EXPLORE APIS RELACIONADAS
Mais modelos de imagem AI, um só destino.
SUA PRÓXIMA IMAGEM COMEÇA AQUI
Crie com a Nano Banana API
Experimente seu primeiro prompt no Playground, compare os preços atuais ou siga a documentação para integrar o Nano Banana à sua aplicação.