API exclusiva do plano Advanced

ViNano AI API

API REST poderosa de geração de imagens com IA, integre-a em seu aplicativo em apenas algumas linhas de código

Requisitos de uso da API

Assinatura do plano Advanced necessária
Usuários do plano anual: Limite de taxa de 200 requisições/minuto
Usuários do plano mensal: Limite de taxa de 20 requisições/minuto

✉️

Precisa de recursos de API mais avançados?

Se você precisa de limites de taxa mais altos, suporte empresarial ou recursos personalizados, envie um e-mail para:

[email protected]

Skills e Guias de integração

Explore guias de integração API, exemplos de código e melhores práticas para ViNano AI API

Ver no GitHub

O que esperar

Criada para desenvolvedores que precisam de processamento de imagens em escala

⚡

Tempo de processamento

O tempo de processamento depende do modelo selecionado, das configurações e da carga do serviço.

🔧

Integração simples

API RESTful com documentação completa e SDKs em vários idiomas

💰

Preços flexíveis

Pague apenas pelo que usar, com preços transparentes e pensados para desenvolvedores

Instruções de chamada da API

Aprenda como usar a API ViNano AI para geração de imagens

Início rápido

Integre geração de imagens com IA em apenas algumas linhas de código

Endpoint da API

POST https://vinano.ai/api/v2/images/generate

curl -X POST https://vinano.ai/api/v2/images/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "prompt=a beautiful sunset over the ocean" \
  -F "model=gemini-2.5-flash-image-preview" \
  -F "aspectRatio=16:9" \
  -F "googleSearch=false" \
  -F "mode=txt2img"

Parâmetros de requisição

Parâmetro	Tipo	Obrigatório	Descrição
prompt	string	No*	Prompt de geração de imagem (máx. 2000 caracteres)
image	File / File[]	No*	Arquivo(s) de imagem carregado(s) (múltiplos suportados)
imageUrl	string / string[]	No*	Existing image URL(s) (supports multiple URLs)
model	string	No	Modelo de IA, suporta gemini-2.5-flash-image-preview, sora_image
aspectRatio	string	No	Proporção de aspecto, ex: 1:1, 16:9, 9:16
mode	string	No	Modo de geração opcional, ex. photo_restoration (fotos antigas), figure, meme, etc. Ver todos os modos
hdPro	boolean	No	Se deve usar o modo HD (consome 30 créditos, modo normal 10 créditos)
img_size	string	No	Tamanho da imagem: 1k, 2k, 4k (apenas modelo gemini-3-pro-image-preview, créditos: 1k=30, 2k=50, 4k=80)
googleSearch	boolean	No	Ativar aprimoramento de pesquisa (suportado apenas pelo modelo gemini-3.1-pro-image-preview, padrão false)

* Prompt ou image deve ser fornecido

Modelos suportados

gemini-2.5-flash-image-preview- Nano Banana (padrão)
gemini-3.1-pro-image-preview- Nano Banana 2 (suporta proporções estendidas 4:1, 1:4, 8:1, 1:8)
nano-banana-2.1Nano Banana 2.1 (1K: 30, 2K: 50, 4K: 70 créditos/imagem; requer associação; contas não pagantes: +10)
gemini-3-pro-image-preview- Nano Banana Pro
sora_image- GPT-Image 2
Seedance-5.0- Seedance 5.0 (apenas 2K/3K, texto→imagem e imagem→imagem, com busca na web)
Z-Image- ViNano Basic (Z-Image, apenas texto→imagem)

Ver preços completos →

Formato de resposta

Resposta bem-sucedida (200)

{
  "status": 200,
  "images": ["https://example.com/generated-image.jpg"],
  "imageDetails": [{
    "width": 1024,
    "height": 1024,
    "filesize": 524288
  }],
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "a beautiful sunset",
  "model": "gemini-2.5-flash-image-preview",
  "credits": {
    "cost": 10
  }
}

⚡ API de Geração de Imagem Assíncrona

Envie uma tarefa e obtenha um task_id, depois consulte o endpoint de status até a geração ser concluída.

Passo 1 — Enviar Tarefa Assíncrona

POST https://vinano.ai/api/v1/images/async

Passo 2 — Consultar Status da Tarefa

GET https://vinano.ai/api/v1/images/task-status?task_id={task_id}

# Step 1: Submit async task (same parameters as sync API)
curl -X POST "https://vinano.ai/api/v1/images/async" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "prompt=a beautiful sunset" \
  -F "model=gemini-2.5-flash-image-preview"

# Response (202):
# {
#   "status": 202,
#   "task_id": "550e8400-e29b-41d4-a716-446655440000",
#   "message": "Task submitted. Use GET /api/v1/images/task-status?task_id={task_id} to poll for results.",
#   "model": "gemini-2.5-flash-image-preview",
#   "credits": { "cost": 10 }
# }

# Step 2: Poll task status (repeat every 3-5s until status=200)
curl -X GET "https://vinano.ai/api/v1/images/task-status?task_id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Response when completed:
# {
#   "status": 200,
#   "images": ["https://example.com/generated-image.jpg"],
#   "imageDetails": [{
#     "width": 1024,
#     "height": 1024,
#     "filesize": 524288
#   }],
#   "uuid": "550e8400-e29b-41d4-a716-446655440000",
#   "prompt": "a beautiful sunset",
#   "model": "gemini-2.5-flash-image-preview",
#   "credits": {
#     "cost": 10
#   }
# }

Explicação dos códigos de erro

Código de status	Descrição
400	Parâmetros obrigatórios ausentes ou validação de parâmetros falhou
401	Token da API inválido, ausente ou malformado
403	Conta desativada, não inscrito no plano Advanced ou sem permissão de API
413	Tamanho do arquivo excede o limite (100MB)
429	Limite de taxa excedido (limite por minuto excedido)
495	Créditos insuficientes
500	Erro interno do servidor ou falha na geração de imagem

Melhores práticas

Mantenha o Token da API seguro

Não compartilhe seu Token da API com outros nem o exponha em repositórios de código

Implementar tratamento de erros

Trate todos os códigos de erro possíveis, especialmente 429 (limite de taxa) e 495 (créditos insuficientes)

Monitorar cabeçalhos de limite de taxa

Verifique X-RateLimit-Remaining nos cabeçalhos de resposta para entender a cota restante

Implementar mecanismo de nova tentativa

Para erros 429, implemente nova tentativa com backoff exponencial baseado no cabeçalho Retry-After

Otimizar prompts

Prompts claros e específicos geram melhores resultados de geração

Comprimir imagens

Comprimir imagens antes do upload melhora a velocidade de transferência e economiza largura de banda

Limite de taxa da API

As chamadas de API são protegidas por limitação de taxa, os limites variam de acordo com o plano de assinatura:

年

Plano Advanced Anual

200 requisições/minuto

月

Plano Advanced Mensal

20 requisições/minuto

💡Os cabeçalhos de resposta incluirão informações X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset