Build · Automazione no-code

Automatizza un catalogo senza scrivere codice

In sintesi

Un'esecuzione no-code invia un batch di foto prodotto con un nodo HTTP, attende 3 secondi, legge lo stato del batch e ripete l'operazione fino al completamento prima di riscrivere gli URL nel tuo foglio di calcolo.

Ottieni una chiave API Consulta l'endpoint batch

Credits: 4 credits a 2K · 5 credits a 4K
Tempo tipico: 1.5–4 min per image
Elaborazione: asincrono, polling

Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato 2026-09-10

Un nodo HTTP, un nodo di attesa e una condizione. n8n, Make o qualsiasi strumento che supporti HTTP può elaborare un intero catalogo tramite l'endpoint batch.

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin/batch \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_images": [
    {
      "image": "https://cdn.yourstore.com/products/jacket-front.jpg",
      "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
      "image_side": "front"
    },
    {
      "image": "https://cdn.yourstore.com/products/shirt-front.jpg",
      "image_side": "front"
    },
    {
      "image": "https://cdn.yourstore.com/products/trousers-front.jpg",
      "image_side": "front"
    }
  ],
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, buttoned up",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/ghost-mannequin/batch", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "product_images": [
      {
        "image": "https://cdn.yourstore.com/products/jacket-front.jpg",
        "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
        "image_side": "front"
      },
      {
        "image": "https://cdn.yourstore.com/products/shirt-front.jpg",
        "image_side": "front"
      },
      {
        "image": "https://cdn.yourstore.com/products/trousers-front.jpg",
        "image_side": "front"
      }
    ],
    "style": "3d",
    "background_color": "white",
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "user_instruction": "closed front, buttoned up",
    "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/ghost-mannequin/batch",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "product_images": [
        {
          "image": "https://cdn.yourstore.com/products/jacket-front.jpg",
          "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
          "image_side": "front"
        },
        {
          "image": "https://cdn.yourstore.com/products/shirt-front.jpg",
          "image_side": "front"
        },
        {
          "image": "https://cdn.yourstore.com/products/trousers-front.jpg",
          "image_side": "front"
        }
      ],
      "style": "3d",
      "background_color": "white",
      "resolution": "2K",
      "aspect_ratio": "3:4",
      "user_instruction": "closed front, buttoned up",
      "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
    },
)
data = res.json()["data"]  # data["id"], data["status"]

Come funziona

In input un foglio di calcolo, in output una cartella di immagini

Esporta il catalogo, configura un nodo HTTP, esegui il ciclo con le attese, riscrivi gli URL.

Passaggio 1
Esporta il catalogo
Una riga per capo d'abbigliamento con un URL immagine pubblico. Quella colonna è l'unico input richiesto dall'endpoint batch.
Passaggio 2
Ottieni una chiave API di Photta
Salvala nel gestore delle credenziali del tuo strumento di automazione, non nel corpo del nodo, in modo che i workflow esportati non contengano segreti.
Passaggio 3
Configura il nodo HTTP
POST, l'intestazione Bearer e il corpo JSON mostrato qui. Ogni elemento dell'array rappresenta un capo d'abbigliamento; i campi di stile si applicano a tutti.
Passaggio 4
Esegui il ciclo con le attese
Attendi 3 secondi, leggi il batch, verifica se lo stato è completed e ripeti il ciclo. Questo intervallo corrisponde a quello indicato nella documentazione.
Passaggio 5
Rispetta i limiti
Il limite sulle dimensioni del batch e quello sui batch concorrenti dipendono entrambi dal tuo piano. Invia un batch, attendi che termini, quindi invia il successivo.
Passaggio 6
Riscrivi gli URL
Al completamento del batch, ogni elemento contiene il proprio URL di output. Scrivili nel foglio di calcolo e scarica i file durante la stessa esecuzione.

I nodi e la loro configurazione

Il corpo della richiesta corrisponde all'esempio pubblicato nella documentazione dell'API; il ciclo segue l'intervallo di polling documentato.

{
  "product_images": [
    {
      "image": "https://cdn.yourstore.com/products/jacket-front.jpg",
      "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
      "image_side": "front"
    },
    {
      "image": "https://cdn.yourstore.com/products/shirt-front.jpg",
      "image_side": "front"
    },
    {
      "image": "https://cdn.yourstore.com/products/trousers-front.jpg",
      "image_side": "front"
    }
  ],
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, buttoned up",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/ghost-mannequin/batch \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_images": [
    {
      "image": "https://cdn.yourstore.com/products/jacket-front.jpg",
      "back_image": "https://cdn.yourstore.com/products/jacket-back.jpg",
      "image_side": "front"
    },
    {
      "image": "https://cdn.yourstore.com/products/shirt-front.jpg",
      "image_side": "front"
    },
    {
      "image": "https://cdn.yourstore.com/products/trousers-front.jpg",
      "image_side": "front"
    }
  ],
  "style": "3d",
  "background_color": "white",
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "user_instruction": "closed front, buttoned up",
  "brand_label_id": "7cc9f988-068b-44cd-8004-22f486b10e67"
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

{
  "nodes": [
    {
      "name": "Wait",
      "type": "n8n-nodes-base.wait",
      "parameters": {
        "amount": 3,
        "unit": "seconds"
      }
    },
    {
      "name": "Read batch",
      "type": "n8n-nodes-base.httpRequest",
      "parameters": {
        "method": "GET",
        "url": "https://api.photta.app/api/v1/ghost-mannequin/batch/{{ $json.data.batch_id }}"
      }
    },
    {
      "name": "Done?",
      "type": "n8n-nodes-base.if",
      "parameters": {
        "conditions": {
          "string": [
            {
              "value1": "={{ $json.data.status }}",
              "value2": "completed"
            }
          ]
        }
      }
    }
  ]
}

# 600 requests per minute per key, fixed window.
# One batch submission plus one poll every 3 seconds is ~21 requests per minute
# per batch in flight, so the concurrency cap binds long before the rate limit.
# On a 429, wait the Retry-After seconds (30 by default) before the next node runs.

Domande frequenti degli sviluppatori

Domande sulle esecuzioni no-code

È necessario scrivere codice?

No. Tutto ciò che serve è una richiesta HTTP con un corpo JSON, supportata da qualsiasi strumento di automazione. L'unico testo da inserire è il corpo mostrato in questa pagina.

Quante immagini possono essere elaborate in una singola esecuzione?

Il limite per batch dell'API è di 5 immagini per Free e Hobby, 10 per Seller, 25 per Brand e 50 per Studio. I cataloghi più estesi vengono elaborati in più batch, uno dopo l'altro.

Cosa succede se un'immagine fallisce?

Il resto del batch continua a essere elaborato. Il corpo della risposta del batch segnala quanti elementi sono completed e quanti sono failed; i credits relativi agli elementi non riusciti vengono rimborsati.

È possibile pianificare l'esecuzione?

Sì. Puoi avviare il workflow ogni notte per elaborare le righe prive di immagine. Il ciclo di polling rimane identico, sia avviato manualmente sia tramite pianificazione.

Funziona su Make o Zapier?

Funziona ovunque sia possibile inviare una richiesta HTTP con un'intestazione e un corpo JSON e attendere tra un passaggio e l'altro. Cambiano i nomi dei nodi, ma i tre passaggi restano gli stessi.

Pagine correlate

Letture correlate

Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato 2026-09-10

Un catalogo, senza sviluppatore

Un nodo HTTP e un'attesa. Il corpo mostrato in questa pagina è quello pubblicato nella documentazione.

Ottieni una chiave API Leggi la guida rapida

Automatizza un catalogo senza scrivere codice

In input un foglio di calcolo, in output una cartella di immagini

Esporta il catalogo

Ottieni una chiave API di Photta

Configura il nodo HTTP

Esegui il ciclo con le attese

Rispetta i limiti

Riscrivi gli URL

I nodi e la loro configurazione

Domande sulle esecuzioni no-code

Letture correlate

Un catalogo, senza sviluppatore