Lançámos 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 no 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 espera de uma API moderna

Desenhada 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 equipa

Gere várias chaves com âmbitos e limites de taxa independentes a partir do painel.

Métricas e registos

Histórico completo de chamadas com custo por pedido, erros e rastreios 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 de água.

POST/v1/workflows/:id/run

Dispare um workflow do utilizador por ID ou webhook.

GET/v1/pricing/image

Consulte o custo estimado em tokens antes de gerar.

GET/v1/runs/:id

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

Preços transparentes

Paga o que usa

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

FAQ

Perguntas frequentes

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

Cada chamada consome tokens consoante o modelo e a resolução. O endpoint GET /pricing/image dá-lhe o custo exato antes de executar. As chamadas falhadas (4xx, 5xx) não consomem tokens.

Por predefinição, 60 pedidos/min no plano Business e personalizado no Enterprise. Qualquer limite de taxa pode ser alargado a pedido.

Sim. A partir do painel pode rodar ou revogar chaves de imediato. As chaves antigas deixam de aceitar novas chamadas.

SDK Node.js e Python em beta. SDK Go, Ruby e PHP no roteiro. Entretanto, 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.