100 token in regalo all'iscrizione

API REST

Genera immaginidal tuo codice

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

Tutto quello che ti aspetti da un'API moderna

Progettata perché integrarla sia banale e gestirla in produzione non ti dia sorprese.

Bassa latenza, alta concorrenza

Endpoint sync per risultati istantanei e coda async per il batch senza attese.

Webhook nativi

Ricevi eventi image.generated, run.completed e altri sul tuo endpoint, con firma HMAC-SHA256.

API key per team

Genera più key con scope e rate limit indipendenti dalla dashboard.

Metriche e log

Storico completo delle chiamate con costo per richiesta, errori e tracce per il debug.

Endpoint principali

Tutto il catalogo nella documentazione.

POST/v1/generate/image

Genera immagini con qualsiasi modello IA disponibile.

POST/v1/upscale/image

Aumenta la risoluzione fino a 6K con fal.ai Clarity e Aura SR.

POST/v1/herramientas/quitar-fondo

Background remover con IA, senza filigrana.

POST/v1/workflows/:id/run

Avvia un workflow dell'utente per ID o webhook.

GET/v1/pricing/image

Consulta il costo stimato in token prima di generare.

GET/v1/runs/:id

Stato e output di un'esecuzione asincrona.

Prezzi trasparenti

Paghi quello che usi

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

Domande frequenti

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.

Inizia a integrare oggi

Crea la tua API key, leggi la documentazione e fai la tua prima chiamata in meno di 5 minuti.