Lançamos workflowsExperimente agora

API REST

Gere imagens
a partir do seu código

API REST com SDK oficial, webhooks e preços transparentes. Integre o Pictulab ao seu produto em minutos.

curl https://api.beta.pictulab.com/v1/generate/image \
  -H "Authorization: Bearer $PICTULAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Foto producto fondo blanco, estilo Amazon",
    "model_id": "gemini-2.5-flash-image",
    "aspectRatio": "1:1",
    "resolution": "2k"
  }'
Produção · Beta aberta

Tudo o que você espera de uma API moderna

Projetada para que integrá-la seja trivial e operá-la em produção não lhe dê sustos.

Latência baixa, alta concorrência

Endpoints síncronos para resultados instantâneos e fila assíncrona para lotes sem esperar.

Webhooks nativos

Receba eventos image.generated, run.completed e outros no seu endpoint, com assinatura HMAC-SHA256.

Chaves de API por equipe

Gere várias chaves com escopos e limites de taxa independentes pelo painel.

Métricas e logs

Histórico completo de chamadas com custo por requisição, erros e traces para depuração.

Endpoints principais

Todo o catálogo na documentação.

POST/v1/generate/image

Gere imagens com qualquer modelo de IA disponível.

POST/v1/upscale/image

Aumente a resolução até 6K com o fal.ai Clarity e o Aura SR.

POST/v1/herramientas/quitar-fondo

Remoção de fundo com IA, sem marca d'água.

POST/v1/workflows/:id/run

Dispare um workflow do usuário por ID ou webhook.

GET/v1/pricing/image

Consulte o custo estimado em tokens antes de gerar.

GET/v1/runs/:id

Status e resultados de uma execução assíncrona.

Preços transparentes

Pague pelo que usar

A API é cobrada por tokens, assim como o painel. Sem tarifa fixa mensal no plano Business — você paga apenas as chamadas executadas com sucesso.

FAQ

Perguntas frequentes

Crie uma conta em cloud.pictulab.com, vá em Developers → API Keys e gere uma chave. Disponível a partir do plano Business.

Cada chamada consome tokens conforme o modelo e a resolução. O endpoint GET /pricing/image informa o custo exato antes de executar. As chamadas com falha (4xx, 5xx) não consomem tokens.

Por padrão, 60 requisições/min no plano Business e personalizado no Enterprise. Qualquer limite de taxa pode ser ampliado sob demanda.

Sim. Pelo painel você pode rotacionar ou revogar chaves imediatamente. As chaves antigas deixam de aceitar novas chamadas.

SDK Node.js e Python em beta. SDK Go, Ruby e PHP no roadmap. Enquanto isso, qualquer cliente HTTP padrão funciona.

Comece a integrar hoje

Crie a sua chave de API, leia a documentação e faça a primeira chamada em menos de 5 minutos.