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 suportadas, 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
EXPERIMENTAR Nano Banana API GRATUITAMENTE
Definições
Text to Image
As definições aqui são uma pré-visualização. Gerar copia o seu prompt e abre o Platform Playground correspondente, onde confirma as definições finais.
ESPECIFICAÇÕES DO MODELO
Conheça as definições antes de construir.
Referência rápida das definições do Nano Banana listadas na documentação da Topview API Platform. Cada modo tem os seus próprios requisitos de entrada.
| Parâmetro | Valor |
|---|---|
| Fornecedor / 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 |
INÍCIO RÁPIDO PARA PROGRAMADORES
Da chave de API à sua primeira imagem.
Envie uma previsão assíncrona com a sua chave de API da Platform e consulte o ID da tarefa devolvido 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 ao pedido text-to-image do Nano Banana na documentação da Platform. Mantenha TOPVIEW_API_PLATFORM_KEY apenas no servidor.
Passo 1
Obtenha a sua chave de API
Inicie sessão 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 pedidos de API.
Passo 2
Gerar ou editar uma imagem
Envie um prompt de texto ou carregue imagens de referência para edição. Configure as definições de imagem suportadas, envie o pedido de API e guarde o ID da tarefa devolvido.
Passo 3
Recupere a sua imagem
Verifique o estado da tarefa até a geração concluir. Recupere os URL das imagens, reveja o custo final de utilização e guarde as imagens geradas.
PENSADO 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.
Funcionalidades 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.
PORQUE 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
Reveja a tarifa atual por imagem sem adicionar seletores de resolução 2K ou 4K não suportados.
Cinco proporções suportadas
Teste 1:1, 16:9, 9:16, 4:3 e 3:4 antes de mapear as definiçõ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
Pode abrir o Nano Banana Playground para explorar as definições. A utilização da API é paga a partir do 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 juntamente com o seu prompt.
Nano Banana suporta 1:1, 16:9, 9:16, 4:3 e 3:4. Não há parâmetro de resolução; cada pedido devolve 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.
A SUA PRÓXIMA IMAGEM COMEÇA AQUI
Crie com a Nano Banana API
Experimente o seu primeiro prompt no Playground, compare os preços atuais ou siga a documentação para integrar o Nano Banana na sua aplicação.