API REST
API REST con SDK ufficiale, webhook e prezzi trasparenti. Integra Pictulab nel tuo prodotto in pochi minuti.
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"
}'Produzione · Beta aperta
Progettata perché integrarla sia banale e gestirla in produzione non ti dia sorprese.
Endpoint sync per risultati istantanei e coda async per il batch senza attese.
Ricevi eventi image.generated, run.completed e altri sul tuo endpoint, con firma HMAC-SHA256.
Genera più key con scope e rate limit indipendenti dalla dashboard.
Storico completo delle chiamate con costo per richiesta, errori e tracce per il debug.
Tutto il catalogo nella documentazione.
/v1/generate/imageGenera immagini con qualsiasi modello IA disponibile.
/v1/upscale/imageAumenta la risoluzione fino a 6K con fal.ai Clarity e Aura SR.
/v1/herramientas/quitar-fondoBackground remover con IA, senza filigrana.
/v1/workflows/:id/runAvvia un workflow dell'utente per ID o webhook.
/v1/pricing/imageConsulta il costo stimato in token prima di generare.
/v1/runs/:idStato e output di un'esecuzione asincrona.
Prezzi trasparenti
L'API viene fatturata a token, esattamente come la dashboard. Nessuna tariffa fissa mensile nel piano Business — paghi solo le chiamate che vanno a buon fine.
FAQ
Crea un account su cloud.pictulab.com, vai su Developers → API Keys e genera una key. Disponibile dal piano Business.
Ogni chiamata consuma token in base al modello e alla risoluzione. L'endpoint GET /pricing/image ti dà il costo esatto prima di eseguire. Le chiamate fallite (4xx, 5xx) non consumano token.
Di base, 60 req/min nel piano Business e personalizzati in Enterprise. Qualsiasi rate limit può essere ampliato su richiesta.
Sì. Dalla dashboard puoi ruotare o revocare le key all'istante. Le chiavi vecchie smettono di accettare nuove chiamate.
SDK Node.js e Python in beta. SDK Go, Ruby e PHP in roadmap. Nel frattempo, qualsiasi client HTTP standard funziona.
Crea la tua API key, leggi la documentazione e fai la tua prima chiamata in meno di 5 minuti.