Sviluppatori · API

Vesti qualsiasi prodotto con una sola chiamata API.

Lo stesso motore dietro l’app NoShot, esposto come API REST essenziale. Invia un’immagine prodotto e ricevi render indossati fotorealistici e maschere pulite — in pochi secondi, su scala catalogo.

api.noshot.colive
POST /v1/generate200 OK · 4 render · 4K + maschere
<15s
per immagine
4K
maschere pulite
4
endpoint
500+
brand attivi
Perché l’API

Immagini di produzione, come endpoint

Tutto ciò che fa l’app, richiamabile dalla tua pipeline, dal PIM o dallo store — senza interfaccia di caricamento, senza direzione artistica manuale.

01

Immagini indossate via codice

Un POST trasforma un packshot piatto in render indossati fotorealistici. Modella, posa, luce e scena si scelgono come parametri — non a clic.

02

In blocco, su scala catalogo

Manda migliaia di SKU attraverso /v1/batch in una sola richiesta. Stessi crediti, un solo job da seguire — pensato per volumi da marketplace.

03

Export 4K, maschere pulite

Ogni render esce fino a 4K con una maschera alpha precisa al pixel — pronta da comporre o da mettere dritta in scheda prodotto.

04

Webhook, non polling

Iscriviti a job.succeeded: appena sono pronti, mandiamo in POST gli URL finali al tuo endpoint. Niente cicli di attesa.

Guida rapida

Il tuo primo render in una richiesta

Autenticati con un bearer token, manda in POST un’immagine prodotto con i parametri di modella e scena, poi interroga il job o intercetta il webhook. Ecco il giro completo.

api.noshot.coPOST /v1/generate
curl -X POST https://api.noshot.co/v1/generate \
  -H "Authorization: Bearer $NOSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_image_url": "https://cdn.yourbrand.com/sku/8842-front.jpg",
    "category": "apparel",
    "model": { "gender": "female", "body": "medium", "skin_tone": "III" },
    "scene": { "preset": "studio-daylight", "background": "seamless-bone" },
    "output": { "count": 4, "resolution": "4k", "mask": true }
  }'
Risposta200 OK
{
  "id": "job_9f8c2a1b7d",
  "status": "succeeded",
  "credits_used": 4,
  "images": [
    {
      "url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/01.png",
      "width": 3072,
      "height": 4096,
      "mask_url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/01-mask.png"
    },
    {
      "url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/02.png",
      "width": 3072,
      "height": 4096,
      "mask_url": "https://cdn.noshot.co/v1/renders/9f8c2a1b7d/02-mask.png"
    }
  ],
  "created_at": "2026-07-22T09:41:20Z"
}

A titolo di esempio — nella reference live dentro l’app trovi tutti i parametri e ogni preset di scena.

Endpoint

Una superficie piccola, di proposito

Quattro endpoint coprono l’intero ciclo di vita — genera, controlla, elabora in blocco, esplora.

POST/v1/generate

Crea un job di render da un’immagine prodotto più i tuoi parametri di modella e scena.

GET/v1/jobs/{id}

Interroga un job: stato, URL delle immagini e URL delle maschere.

POST/v1/batch

Mette in coda molti SKU in una sola richiesta, per lavorazioni su scala catalogo.

GET/v1/models

Elenca i preset di modelle, i tipi di corporatura, i toni di pelle e le scene disponibili.

Limiti & prezzi

A crediti, e semplice

Un’immagine, un credito — è tutto il modello di prezzo.

  • 1 immagine = 1 credito. I render extra di una richiesta attingono allo stesso saldo.
  • I render falliti o rifiutati non vengono mai addebitati.
  • Ogni risposta restituisce un header X-Credits-Remaining, così misuri i consumi.
  • I limiti crescono con il tuo piano; con Enterprise spariscono del tutto.
PianoImmaginiLimite
Free1030 req/min
Starter100 / mese60 req/min
StudioIl più scelto400 / mese120 req/min
EnterpriseIllimitateSu misura

I crediti arrivano dal tuo piano NoShot — trovi tutti i livelli nella pagina Prezzi.

Reference completa

La documentazione completa vive nell’app

Ogni parametro, evento webhook, codice di errore e SDK ufficiale — versionati e interattivi — sta nella tua dashboard. Crea una chiave e la reference si apre lì accanto.

Pubblica immagini indossate, via codice.

Crea una chiave nell’app e fai la prima chiamata in pochi minuti. Piano gratuito incluso — senza carta.