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.

Host: api.noshot.co
Chiamata: POST /v1/generate
live: 200 OK · 4 render · 4K + maschere

Ottieni la chiave API Vedi la guida rapida

<15s

per immagine

maschere pulite

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.

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.

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.

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.

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.

Richiesta

cURLPOST /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 }
  }'

NodePOST /v1/generate

import NoShot from "@noshot/sdk";

const noshot = new NoShot({ apiKey: process.env.NOSHOT_API_KEY });

const job = await noshot.generate({
  productImageUrl: "https://cdn.yourbrand.com/sku/8842-front.jpg",
  category: "apparel",
  model: { gender: "female", body: "medium", skinTone: "III" },
  scene: { preset: "studio-daylight", background: "seamless-bone" },
  output: { count: 4, resolution: "4k", mask: true },
});

console.log(job.id, job.status); // "job_9f8c2a1b7d", "succeeded"

PythonPOST /v1/generate

import os
from noshot import NoShot

noshot = NoShot(api_key=os.environ["NOSHOT_API_KEY"])

job = noshot.generate(
    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},
)

print(job.id, job.status)  # "job_9f8c2a1b7d", "succeeded"

Risposta

JSON200 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.

Una chiamata, due estremi

Abito a colonna in seta — Seta avorio tagliata in sbieco, scollo ricamato a perline — InputAbito a colonna in seta

Abito a colonna in seta — Ogni perlina dove l'hai messa — Output3072 × 4096

Endpoint

Una superficie piccola, di proposito

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

POST: /v1/generateCrea 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/batchMette in coda molti SKU in una sola richiesta, per lavorazioni su scala catalogo.
GET: /v1/modelsElenca 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.

01: 1 immagine = 1 credito. I render extra di una richiesta attingono allo stesso saldo.
02: I render falliti o rifiutati non vengono mai addebitati.
03: Ogni risposta restituisce un header X-Credits-Remaining, così misuri i consumi.
04: 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.

Vedi piani e crediti

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.

Apri la reference API

Pubblica le tue immagini indossate,
via API.

Inizia gratis Prenota una demo

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