Quattro modi per aggiungere immagini

Nessuno sceglie una piattaforma di immagini per la sua finestra di upload. Ma se ti è capitato di aspettare che 300 flat-lay si sincronizzassero da un disco condiviso solo per poterli trascinare nel browser, sai che è il far entrare le immagini a mangiarsi la giornata.

Due nuove strade di import sono attive: da un URL e da Google Drive. Insieme alle due che c'erano già, fanno quattro modi di mettere immagini davanti a un job, e tutti e quattro finiscono nello stesso posto.

Le quattro strade

Apri un job qualsiasi e clicca su Add your images. Il selettore ora ha quattro schede.

Le prime due le conosci già. Ecco cosa fanno le due nuove.

From URL

Incolla un link diretto a un'immagine, premi Import, e On-Model la recupera e la archivia nella tua libreria. L'immagine non tocca mai la tua macchina, ed è proprio questo il punto: il tuo CDN ne ha già una copia perfetta, e scaricarla solo per ricaricarla è un giro che non serve a nessuno.

Tre cose da sapere prima di incollare:

• Deve essere il link all'immagine, non alla pagina che la contiene. Una scheda prodotto che finisce con /p/12345 non funzionerà. Fai clic destro sull'immagine, copia l'indirizzo dell'immagine e usa quello.
• JPEG, PNG, WebP, AVIF e TIFF, fino a 25 MB. Gli stessi formati accettati dalla scheda di upload.
• Il link deve essere raggiungibile pubblicamente. Gli indirizzi su reti private o interne vengono rifiutati, quindi un URL che si risolve solo dentro la rete del tuo ufficio non potrà essere importato.

È la strada che ripaga quando le tue immagini prodotto hanno già una casa ufficiale. Se il tuo PIM, il tuo DAM o il tuo store espone un URL immagine stabile per SKU, quell'URL è ora un input valido per un job.

From Google Drive

Clicca su Select files from Google Drive, accedi una volta e scegli le immagini nel browser file di Google. On-Model le recupera in background e mostra un elenco di avanzamento file per file, così un import da 200 immagini diventa qualcosa che avvii e poi lasci andare, invece di qualcosa da sorvegliare.

Due note pratiche. Le cartelle si possono aprire ma non selezionare, quindi scegli i file immagine veri e propri invece della cartella che li contiene. E valgono gli stessi formati e lo stesso limite di 25 MB di ogni altra strada.

Finiscono tutte nello stesso posto

Questa è la parte che conta più di qualsiasi singola scheda. Da qualunque strada arrivi un'immagine, quello che ottieni dall'altro lato è identico: un asset nella tua libreria, con miniatura, nome file, attributi rilevati e un posto nello stesso selettore da cui sei partito.

Così un'immagine importata da un URL stamattina può essere riutilizzata questo pomeriggio dalla scheda Library, contrassegnata con i tag colorati che il tuo team già usa, filtrata insieme a tutto il resto della tua libreria di asset e condivisa con il tuo team esattamente come un file caricato dal computer. Niente a valle ha bisogno di sapere come i pixel siano arrivati lì.

È tutto qui l'obiettivo di progetto. La strada è un dettaglio implementativo del tuo flusso di lavoro, non del nostro.

Via API

Le stesse strade sono nell'API, ed è lì che ripagano davvero per chi fa girare On-Model dentro una pipeline più grande. Invece di spostare byte, passi una lista di link.

Per una singola immagine, una chiamata sincrona restituisce l'asset finito:

import requests

api_url = "https://v2.api.piktid.com"

response = requests.post(
  f"{api_url}/upload/from-url",
  headers={"Authorization": "Bearer " + access_token},
  json={"url": "https://cdn.example.com/sku-12345.jpg"},
)

asset_id = response.json()["asset_id"]

Per un catalogo, invia fino a 500 URL in una volta sola. La chiamata risponde subito con un batch da interrogare, e ogni URL viene recuperato in background:

response = requests.post(
  f"{api_url}/upload/from-urls",
  headers={"Authorization": "Bearer " + access_token},
  json={
      "urls": [f"https://cdn.example.com/sku-{n}.jpg" for n in skus],
      "project_id": project_id,
      "tag_ids": [autumn_drop_tag_id],
  },
)

batch_id = response.json()["batch_id"]

# then poll GET /upload/imports/{batch_id} until status == "completed"

I link malformati e i duplicati vengono scartati in partenza ed elencati nella risposta con il motivo, quindi una riga sbagliata non affonda l'intero batch. L'endpoint di stato riporta ogni elemento singolarmente: quali sono riusciti, quali no e perché.

Nota i campi project_id e tag_ids. Le immagini possono arrivare già archiviate e già etichettate, il che significa che il momento in cui il tuo catalogo entra in On-Model è anche il momento in cui viene organizzato. Gli import da Google Drive funzionano allo stesso modo, su un collegamento che stabilisci una volta sola nell'app.

Quale strada scegliere?

• Una manciata di file, sul tuo portatile. Upload. Resta la cosa più veloce per i job piccoli.
• Un catalogo con URL immagine stabili. From URL, via API. È la strada che scala, perché trasforma «portare le immagini dentro la piattaforma» in una lista di stringhe che i tuoi sistemi già producono.
• Uno shooting che atterra su Drive. From Drive. Salta del tutto il passaggio scarica-e-ricarica.
• Qualsiasi cosa tu abbia già lavorato. Library. Riusare non costa nulla e mantiene coerente il set.

Domande frequenti

Posso importare immagini in On-Model da un URL? Sì. Il selettore di immagini ha una scheda From URL in cui incolli un link diretto a un file immagine, che viene recuperato nella tua libreria di asset. Via API ci sono due endpoint: uno per un singolo URL e uno che accetta fino a 500 URL per chiamata e riporta l'avanzamento elemento per elemento.

On-Model si collega a Google Drive? Sì. La scheda From Drive apre il selettore file di Google. Ti colleghi una volta, selezioni le immagini che vuoi e vengono importate in background. Il collegamento usa il permesso per singolo file di Google, quindi sono accessibili soltanto i file che selezioni esplicitamente.

Quali formati e dimensioni di immagine sono accettati? JPEG, PNG, WebP, AVIF e TIFF, fino a 25 MB per immagine, su ogni strada di import.

Perché il mio import da URL è fallito? Quasi sempre perché il link punta a una pagina web invece che al file immagine vero e proprio. Copia direttamente l'indirizzo dell'immagine. Vengono rifiutati anche gli indirizzi non raggiungibili pubblicamente e i file oltre 25 MB o in un formato non supportato.

Le immagini importate costano crediti? No. Importare e conservare immagini è gratuito su ogni piano, entro il limite di asset del tuo piano. I crediti si spendono quando avvii un job.

Posso taggare le immagini mentre vengono importate? Sì, via API. Entrambi gli endpoint URL e quello Drive accettano un progetto e una lista di tag, quindi gli asset possono arrivare già archiviati ed etichettati.

Provalo ora

Apri On-Model, avvia un job qualsiasi e clicca su Add your images. Se le tue foto prodotto vivono già su un CDN, prendi un URL immagine e incollalo nella scheda From URL. Se vivono su Drive, collegati una volta e selezionane più di una.

Nuovo su On-Model? Parti dalla guida Flat-to-Model, dalla guida Create-Packshot o dalla guida Model-Swap.