Quatre façons d'importer vos images

Personne ne choisit une plateforme d'images pour sa fenêtre d'upload. Mais si vous avez déjà attendu que 300 flat-lays se synchronisent depuis un disque partagé avant de pouvoir les glisser dans un navigateur, vous savez que c'est le fait de faire entrer les images qui mange la journée.

Deux nouvelles voies d'import sont disponibles : depuis une URL et depuis Google Drive. Avec les deux qui existaient déjà, cela fait quatre façons de mettre des images devant un job, et toutes les quatre aboutissent au même endroit.

Les quatre chemins

Ouvrez n'importe quel job et cliquez sur Add your images. Le sélecteur compte désormais quatre onglets.

Les deux premiers, vous les connaissez déjà. Voici ce que font les deux nouveaux.

From URL

Collez un lien direct vers une image, cliquez sur Import, et On-Model va la chercher et la range dans votre bibliothèque. L'image ne passe jamais par votre machine, et c'est tout l'intérêt : votre CDN en détient déjà une copie parfaitement bonne, et la télécharger juste pour la ré-uploader est un aller-retour dont personne n'a besoin.

Trois choses à savoir avant de coller :

• Ce doit être le lien vers l'image, pas vers la page qui la contient. Une fiche produit se terminant par /p/12345 ne fonctionnera pas. Faites un clic droit sur l'image, copiez l'adresse de l'image et utilisez celle-là.
• JPEG, PNG, WebP, AVIF et TIFF, jusqu'à 25 Mo. Les mêmes formats que l'onglet d'upload.
• Le lien doit être accessible publiquement. Les adresses sur des réseaux privés ou internes sont refusées : une URL qui ne se résout qu'à l'intérieur de votre réseau d'entreprise ne pourra pas être importée.

C'est le chemin qui paie quand vos images produit ont déjà un domicile officiel. Si votre PIM, votre DAM ou votre boutique expose une URL d'image stable par SKU, cette URL est désormais une entrée valide pour un job.

From Google Drive

Cliquez sur Select files from Google Drive, connectez-vous une fois, puis choisissez vos images dans l'explorateur de fichiers de Google. On-Model les récupère en arrière-plan et affiche une liste de progression fichier par fichier : un import de 200 images devient donc quelque chose que vous lancez avant de passer à autre chose, plutôt que quelque chose à surveiller.

Deux remarques pratiques. Les dossiers se parcourent mais ne se sélectionnent pas : choisissez donc les fichiers image eux-mêmes plutôt que le dossier qui les contient. Et les mêmes formats et le même plafond de 25 Mo s'appliquent qu'ailleurs.

Tout aboutit au même endroit

C'est le point qui compte plus que n'importe quel onglet pris isolément. Quel que soit le chemin emprunté par une image, ce que vous obtenez au bout est identique : un asset dans votre bibliothèque, avec une vignette, un nom de fichier, des attributs détectés et une place dans le sélecteur d'où vous êtes parti.

Une image importée depuis une URL ce matin peut donc être réutilisée cet après-midi depuis l'onglet Library, recevoir les tags colorés que votre équipe utilise déjà, être filtrée avec tout le reste de votre bibliothèque d'assets et partagée avec votre équipe exactement comme un fichier importé depuis votre ordinateur. Rien en aval n'a besoin de savoir comment les pixels sont arrivés là.

C'est tout l'objectif de conception. Le chemin est un détail d'implémentation de votre workflow, pas du nôtre.

Via l'API

Les mêmes chemins existent dans l'API, et c'est là qu'ils prennent toute leur valeur pour qui fait tourner On-Model à l'intérieur d'une pipeline plus large. Au lieu de déplacer des octets, vous transmettez une liste de liens.

Pour une image seule, un appel synchrone renvoie l'asset terminé :

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"]

Pour un catalogue, envoyez jusqu'à 500 URLs d'un coup. L'appel répond immédiatement avec un lot à interroger, et chaque URL est récupérée en arrière-plan :

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"

Les liens mal formés et les doublons sont écartés en amont et listés dans la réponse avec un motif : une mauvaise ligne ne fait donc pas couler le lot entier. Le endpoint de statut rend compte de chaque élément individuellement : ceux qui ont réussi, ceux qui ont échoué, et pourquoi.

Notez les champs project_id et tag_ids. Les images peuvent arriver déjà classées et déjà étiquetées, ce qui veut dire que le moment où votre catalogue entre dans On-Model est aussi celui où il est organisé. Les imports Google Drive fonctionnent de la même façon, sur une connexion établie une seule fois dans l'app.

Quel chemin choisir ?

• Une poignée de fichiers, sur votre ordinateur. Upload. Cela reste le plus rapide pour les petits jobs.
• Un catalogue avec des URLs d'images stables. From URL, via l'API. C'est le chemin qui passe à l'échelle, parce qu'il transforme « faire entrer les images dans la plateforme » en une liste de chaînes de caractères que vos systèmes produisent déjà.
• Un shooting qui atterrit dans Drive. From Drive. Vous supprimez entièrement l'étape téléchargement puis ré-upload.
• Tout ce que vous avez déjà traité. Library. La réutilisation ne coûte rien et garde votre série cohérente.

Questions fréquentes

Puis-je importer des images dans On-Model depuis une URL ? Oui. Le sélecteur d'images comporte un onglet From URL où vous collez un lien direct vers un fichier image, qui est alors récupéré dans votre bibliothèque d'assets. Via l'API, il existe deux endpoints : un pour une URL unique, et un qui accepte jusqu'à 500 URLs par appel et rend compte de la progression élément par élément.

On-Model se connecte-t-il à Google Drive ? Oui. L'onglet From Drive ouvre le sélecteur de fichiers de Google. Vous vous connectez une fois, sélectionnez les images voulues, et elles sont importées en arrière-plan. La connexion utilise l'autorisation par fichier de Google : seuls les fichiers que vous sélectionnez explicitement sont accessibles.

Quels formats et quelles tailles d'image sont acceptés ? JPEG, PNG, WebP, AVIF et TIFF, jusqu'à 25 Mo par image, sur chaque voie d'import.

Pourquoi mon import depuis une URL a-t-il échoué ? Presque toujours parce que le lien pointe vers une page web plutôt que vers le fichier image lui-même. Copiez directement l'adresse de l'image. Sont également refusées les adresses qui ne sont pas accessibles publiquement, ainsi que les fichiers de plus de 25 Mo ou dans un format non pris en charge.

Les images importées coûtent-elles des crédits ? Non. Importer et stocker des images est gratuit sur tous les plans, dans la limite du nombre d'assets de votre plan. Les crédits sont consommés quand vous lancez un job.

Puis-je taguer les images au moment de l'import ? Oui, via l'API. Les deux endpoints URL et l'endpoint Drive acceptent un projet et une liste de tags : les assets peuvent donc arriver déjà classés et étiquetés.

Essayez maintenant

Ouvrez On-Model, lancez n'importe quel job et cliquez sur Add your images. Si vos photos produit vivent déjà sur un CDN, prenez une URL d'image et collez-la dans l'onglet From URL. Si elles vivent dans Drive, connectez-vous une fois et sélectionnez-en plusieurs.

Nouveau sur On-Model ? Commencez par le guide Flat-to-Model, le guide Create-Packshot ou le guide Model-Swap.