Nano Banana Pro
Nano Banana Pro (Gemini 3 Pro Image Preview) asynchronous image generation and editing with 1K, 2K, or 4K output and up to 14 reference images.
Preço
$0.022/ chamada
Endpoint
/images/tasks
Forma de entrega
Ciclo de vida das tarefas assíncronas
Disponibilidade
Disponível agora
Documentação da API
Monte e copie a requisição
Escolha as opções que este modelo aceita. O código abaixo é atualizado conforme você escolhe.
https://www.aisplice.store/v1/images/tasksBearer API keyTarefa assíncronaOpçõesSó aparecem as opções publicadas para este modelo.
# Requires curl and jq
API_KEY="${API_KEY:-YOUR_API_KEY}"
# 1. Submit once
SUBMITTED=$(curl --fail-with-body -sS https://www.aisplice.store/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: model-docs-$(date +%s)-$$" \\
-d '{
"model": "Nano Banana Pro",
"prompt": "A cinematic scene with careful composition",
"size": "auto",
"resolution": "1K",
"n": 1
}')
TASK_ID=$(printf '%s' "$SUBMITTED" | jq -r '.task_id // .id // empty')
if [ -z "$TASK_ID" ]; then
printf '%s\n' "$SUBMITTED" >&2
exit 1
fi
echo "task_id=$TASK_ID"
# 2. Poll until terminal
while true; do
STATUS_JSON=$(curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY")
STATUS=$(printf '%s' "$STATUS_JSON" | jq -r '.status // empty' | tr '[:upper:]' '[:lower:]')
echo "status=$STATUS"
case "$STATUS" in
completed|succeeded|success) break ;;
failed|failure|cancelled|canceled)
printf '%s\n' "$STATUS_JSON" | jq .
exit 1
;;
esac
sleep 3
done
# 3. Fetch the final result
curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID/content" \
-H "Authorization: Bearer $API_KEY" | jq .- 1Envie a tarefa
- 2Consulte o status
- 3Busque o conteúdo
URLs de mídia públicas são recomendadas em produção. Envie primeiro o arquivo local e depois coloque public_url na requisição do modelo. Evite corpos grandes em Base64.
Ler o guia de uploadReferência de parâmetros
modelIdentificador exato do modelo para esta requisição.
gemini-3-pro-image-previewpromptInstrução que descreve o resultado desejado.
sizeProporção ou dimensões da saída.
auto1:12:33:23:44:34:55:49:1616:921:9resolutionResolução da saída solicitada.
1K2K4KnimagesOptional reference images, up to 14.
Ciclo de vida da resposta
Status da tarefa, estados finais e exemplos de resposta com o resultado.
Ciclo de vida da resposta
Status da tarefa, estados finais e exemplos de resposta com o resultado.
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "image.task",
"model": "Nano Banana Pro",
"status": "queued"
}{
"created": 1720000000,
"data": [
{
"url": "https://media.example/result.png"
}
]
}Aguardando
queued · submitted · in_progress · processing
Sucesso
completed · succeeded · success
Falha
failed · failure · cancelled · canceled
Erros e produção
Regras de novas tentativas, idempotência e a checklist mínima de produção.
Erros e produção
Regras de novas tentativas, idempotência e a checklist mínima de produção.
400 / 422Corrija os campos da requisição ou a opção não suportada; não tente de novo sem alterações.
401Verifique se a chave de API está presente, ativa e enviada como Bearer token.
402O saldo da conta é insuficiente.
409A Idempotency-Key está em processamento ou foi reutilizada com outro corpo.
429Faça backoff de acordo com o Retry-After antes de tentar novamente.
5xxTente novamente com backoff exponencial e mantenha a Idempotency-Key original.
- Mantenha as chaves de API no seu servidor em aplicações mobile e de navegador públicas.
- Defina uma Idempotency-Key única para cada operação assíncrona cobrada.
- Persista o task_id para que as consultas possam ser retomadas após uma reinicialização.
- Use um timeout em toda requisição HTTP e informe o ID da requisição nos relatos ao suporte.
- Leia os metadados atualizados dos modelos em vez de fixar no código os preços e as opções suportadas.
Preço e faixas
economize 84% em relação ao oficialPreço por requisição
$0.022/ chamada
$0.134
Preço por faixa
Preço base $0.022
Preço por faixa — o preço final depende das opções solicitadas. Faixas não listadas são cobradas pelo preço base.
- 16:9×1$0.022
- 1:1×1$0.022
- 21:9×1$0.022
- 2:3×1$0.022
- 3:2×1$0.022
- 3:4×1$0.022
- 4:3×1$0.022
- 4:5×1$0.022
- 5:4×1$0.022
- 9:16×1$0.022
- auto×1$0.022
- 1k×1$0.022
- 2k×1$0.022
- 4k×1.5$0.033
O preço mostrado aqui é exatamente o que você paga — chamadas com falha são reembolsadas automaticamente.
Modelos relacionados