API
API
Nano Banana Upscaler API
ImagemAumente a resolução e melhore a nitidez das imagens com a API Nano Banana Image Enhancer. Amplie uma imagem original para 2K ou 4K.
Corpo
application/jsonmodelstringobrigatórionano-banana-image-enhancerinput.imagesstring[]obrigatórioURLs das imagens originais. Forneça exatamente uma URL de imagem HTTPS acessível publicamente.
Não é necessário fornecer um prompt. Substitua a URL de exemplo pela URL da sua própria imagem.
Máximo de URLs: 1.
Exemplo: ["https://example.com/source.png"]
input.resolutionstringopcionalResolução de saída. Use 2k ou 4k em minúsculas. Se omitido, o padrão é 4k.
Padrão: 4k
Exemplos de requisição
POST /api/v1/createcurl -X POST https://nanobanana.io/api/v1/create \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-image-enhancer",
"input": {
"images": [
"https://example.com/source.png"
],
"resolution": "4k"
}
}'POST /api/v1/create · HTTP 201{
"data": {
"task_id": "task_example",
"model": "nano-banana-image-enhancer",
"status": "processing",
"credits": 10
}
}Consulte este endpoint usando o ID da tarefa retornado até que a tarefa seja concluída ou falhe. Recomendamos consultar a cada 5 segundos para verificar o status mais recente.
POST /api/v1/check{
"task_id": "task_example"
}Resposta
Status da tarefa retornado por POST /api/v1/check. Os IDs, URLs e horários abaixo são ilustrativos.
idstringobrigatórioIdentificador da tarefa em data.id, igual ao task_id enviado na consulta.
statusstringobrigatóriofailed_reasonstringopcionalRetornado somente quando status é failed, para explicar a falha. O campo é omitido em completed e processing.
Concluída · completed
Os URLs de download estão em data.data.results.
POST /api/v1/check · HTTP 200{
"data": {
"id": "task_example",
"created_at": 1791244800,
"model": "nano-banana-image-enhancer",
"status": "completed",
"data": {
"results": [
"https://example.com/generated.png"
],
"processing_time": 18
}
}
}Outros status
Em processing ou failed, data.data é null. Este exemplo mostra failed: somente failed inclui failed_reason. Continue consultando em processing; pare em failed.
POST /api/v1/check · HTTP 200{
"data": {
"id": "task_example",
"created_at": 1791244800,
"model": "nano-banana-image-enhancer",
"status": "failed",
"data": null,
"failed_reason": "Generation failed."
}
}Consumo de créditos
Créditos consumidos por uma solicitação que gera uma imagem.
| Resolução | 2K | 4K |
|---|---|---|
| Uma imagem | 10 | 10 |
Sem parâmetros opcionais: 10 créditos
Envie explicitamente os parâmetros input indicados para usar a tarifa correspondente. Solicitações que geram várias imagens podem consumir mais créditos.
O campo credits retornado por POST /api/v1/create mostra os créditos cobrados pela tarefa.
