Product Updates··7 Min. Lesezeit

Vier Wege, Bilder in einen Job zu holen

Ihre Bibliothek, Ihr Rechner, eine öffentliche URL oder Google Drive. Vier Wege in dieselbe Asset-Bibliothek, in der App und über die API.

By On-Model Team

Vier leuchtend blaue Eingangslinien laufen in einem einzigen Kanal zusammen, der sich zu einem Raster aus hellen weißen Produktfotokarten auf dunklem Grund öffnet

Niemand wählt eine Bildplattform wegen ihres Upload-Dialogs. Aber wer schon einmal darauf gewartet hat, dass 300 Flat-Lays aus einem geteilten Laufwerk synchronisiert werden, nur um sie dann in den Browser zu ziehen, weiß: Die Bilder hineinzubekommen ist der Teil, der den Tag frisst.

Zwei neue Importwege sind ab sofort verfügbar: aus einer URL und aus Google Drive. Zusammen mit den beiden bereits vorhandenen ergibt das vier Wege, Bilder in einen Job zu bringen, und alle vier enden am selben Ort.

Die vier Wege

Öffnen Sie einen beliebigen Job und klicken Sie auf Add your images. Die Auswahl hat jetzt vier Tabs.

Dieselben vier Tabs in jedem Job: Library, Upload, From URL, From Drive.
WegWann Sie ihn nutzenMehrere auf einmal
LibraryDas Bild liegt bereits in On-Model, aus einem früheren Upload oder einem früheren JobJa
UploadDie Dateien liegen auf dem Rechner, an dem Sie gerade sitzenJa, per Drag-and-drop
From URLDas Bild liegt bereits öffentlich irgendwo: auf einem CDN, einer Produktseite, in einem Link vom LieferantenEinzeln in der App, bis zu 500 pro Aufruf über die API
From DriveDas Shooting landet in Google Drive, bevor es irgendwo anders landetJa, Mehrfachauswahl

Die ersten beiden kennen Sie bereits. Hier ist, was die neuen beiden können.

From URL

Fügen Sie einen direkten Link zu einem Bild ein, klicken Sie auf Import, und On-Model holt es und legt es in Ihrer Bibliothek ab. Das Bild berührt Ihren Rechner nie, und genau darum geht es: Ihr CDN hat bereits eine einwandfreie Kopie, und sie nur herunterzuladen, um sie wieder hochzuladen, ist ein Umweg, den niemand braucht.

Ein direkter Bildlink, ein Klick auf Import, und die Datei liegt in Ihrer Bibliothek.

Drei Dinge sollten Sie vor dem Einfügen wissen:

  • Es muss der Link zum Bild sein, nicht zur Seite, auf der es steht. Eine Produktseite, die auf /p/12345 endet, funktioniert nicht. Klicken Sie mit der rechten Maustaste auf das Bild, kopieren Sie die Bildadresse und verwenden Sie diese.
  • JPEG, PNG, WebP, AVIF und TIFF, bis 25 MB. Dieselben Formate, die auch der Upload-Tab annimmt.
  • Der Link muss öffentlich erreichbar sein. Adressen in privaten oder internen Netzen werden abgelehnt, eine URL, die sich nur in Ihrem Firmennetz auflösen lässt, kann also nicht importiert werden.

Dieser Weg zahlt sich aus, wenn Ihre Produktbilder bereits eine feste Heimat haben. Wenn Ihr PIM, Ihr DAM oder Ihr Shop pro SKU eine stabile Bild-URL bereitstellt, ist diese URL jetzt eine gültige Eingabe für einen Job.

From Google Drive

Klicken Sie auf Select files from Google Drive, melden Sie sich einmal an und wählen Sie Ihre Bilder in Googles eigenem Dateibrowser aus. On-Model holt sie im Hintergrund und zeigt eine Fortschrittsliste pro Datei, sodass ein Import von 200 Bildern etwas ist, das Sie starten und dann liegen lassen, statt es zu beaufsichtigen.

Einmal verbinden, dann Dateien in Googles eigenem Browser auswählen.

On-Model sieht ausschließlich die Dateien, die Sie auswählen. Die Verbindung nutzt Googles dateibezogene Berechtigung: Sie gibt Zugriff auf genau die Bilder frei, die Sie in der Auswahl markieren, und auf nichts sonst. Ihr Drive ist für uns nicht durchsuchbar, wird nicht indexiert und nicht gescannt. Die Verbindung läuft von selbst ab, wenn Ihre Login-Sitzung endet, und Sie können sie jederzeit in Ihrem Google-Konto widerrufen.

Zwei praktische Hinweise. Ordner lassen sich öffnen, aber nicht auswählen, markieren Sie also die Bilddateien selbst statt des Ordners darum herum. Und es gelten dieselben Formate und dieselbe Grenze von 25 MB wie überall sonst.

Alle enden am selben Ort

Das ist der Teil, der mehr zählt als jeder einzelne Tab. Über welchen Weg ein Bild auch ankommt, am anderen Ende steht immer dasselbe: ein Asset in Ihrer Bibliothek, mit Vorschaubild, Dateiname, erkannten Attributen und einem Platz in genau der Auswahl, in der Sie angefangen haben.

Ein heute Morgen aus einer URL importiertes Bild lässt sich also heute Nachmittag über den Tab Library wiederverwenden, mit den farbigen Tags versehen, die Ihr Team ohnehin nutzt, gemeinsam mit allem anderen in Ihrer Asset-Bibliothek filtern und mit Ihrem Team teilen, genau wie eine hochgeladene Datei. Nichts weiter unten in der Kette muss wissen oder interessieren, wie die Pixel dorthin gekommen sind.

Das ist das ganze Designziel. Der Weg ist ein Implementierungsdetail Ihres Workflows, nicht unseres.

Über die API

Dieselben Wege stehen in der API bereit, und dort zahlen sie sich für alle aus, die On-Model in eine größere Pipeline einbetten. Statt Bytes zu verschieben, übergeben Sie eine Liste von Links.

Für ein einzelnes Bild liefert ein synchroner Aufruf das fertige Asset zurück:

POST /upload/from-url
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"]

Für einen ganzen Katalog senden Sie bis zu 500 URLs auf einmal. Der Aufruf kehrt sofort mit einem Batch zurück, den Sie abfragen können, und jede URL wird im Hintergrund geholt:

POST /upload/from-urls
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"

Fehlerhafte Links und Duplikate werden vorab abgewiesen und mit Begründung in der Antwort aufgeführt, eine schlechte Zeile reißt also nicht den ganzen Batch mit. Der Status-Endpunkt meldet jeden Eintrag einzeln: was erfolgreich war, was fehlgeschlagen ist und warum.

Beachten Sie die Felder project_id und tag_ids. Bilder können bereits einsortiert und bereits beschriftet ankommen, das heißt: Der Moment, in dem Ihr Katalog in On-Model eintrifft, ist zugleich der Moment, in dem er organisiert wird. Google-Drive-Importe funktionieren genauso, über eine Verbindung, die Sie einmal in der App herstellen.

Welchen Weg sollten Sie nehmen?

  • Eine Handvoll Dateien auf Ihrem Laptop. Upload. Für kleine Jobs immer noch das Schnellste.
  • Ein Katalog mit stabilen Bild-URLs. From URL, über die API. Das ist der Weg, der skaliert, weil er aus „die Bilder in die Plattform bekommen“ eine Liste von Zeichenketten macht, die Ihre bestehenden Systeme ohnehin erzeugen.
  • Ein Shooting, das in Drive landet. From Drive. Damit entfällt der Umweg über Herunterladen und erneutes Hochladen vollständig.
  • Alles, was Sie schon einmal verarbeitet haben. Library. Wiederverwendung kostet nichts und hält Ihr Set konsistent.

Häufige Fragen

Kann ich Bilder aus einer URL in On-Model importieren? Ja. Die Bildauswahl hat einen Tab From URL, in den Sie einen direkten Link zu einer Bilddatei einfügen, die dann in Ihre Asset-Bibliothek geholt wird. Über die API gibt es zwei Endpunkte: einen für eine einzelne URL und einen, der bis zu 500 URLs pro Aufruf annimmt und den Fortschritt pro Eintrag meldet.

Lässt sich On-Model mit Google Drive verbinden? Ja. Der Tab From Drive öffnet Googles eigene Dateiauswahl. Sie verbinden sich einmal, wählen die gewünschten Bilder aus, und sie werden im Hintergrund importiert. Die Verbindung nutzt Googles dateibezogene Berechtigung, es sind also nur die Dateien zugänglich, die Sie ausdrücklich auswählen.

Welche Bildformate und Größen werden akzeptiert? JPEG, PNG, WebP, AVIF und TIFF, bis 25 MB pro Bild, auf jedem Importweg.

Warum ist mein URL-Import fehlgeschlagen? Fast immer, weil der Link auf eine Webseite zeigt statt auf die Bilddatei selbst. Kopieren Sie die Bildadresse direkt. Abgelehnt werden außerdem Adressen, die nicht öffentlich erreichbar sind, sowie Dateien über 25 MB oder in einem nicht unterstützten Format.

Kosten importierte Bilder Credits? Nein. Importieren und Speichern von Bildern ist in jedem Plan kostenlos, im Rahmen des Asset-Limits Ihres Plans. Credits werden verbraucht, wenn Sie einen Job starten.

Kann ich Bilder schon beim Import taggen? Ja, über die API. Beide URL-Endpunkte und der Drive-Endpunkt nehmen ein Projekt und eine Liste von Tags entgegen, Assets können also bereits einsortiert und beschriftet ankommen.

Jetzt ausprobieren

Öffnen Sie On-Model, starten Sie einen beliebigen Job und klicken Sie auf Add your images. Wenn Ihre Produktfotos ohnehin auf einem CDN liegen, nehmen Sie eine Bild-URL und fügen Sie sie in den Tab From URL ein. Liegen sie in Drive, verbinden Sie sich einmal und wählen mehrere auf einmal aus.

Neu bei On-Model? Beginnen Sie mit dem Flat-to-Model-Guide, dem Create-Packshot-Guide oder dem Model-Swap-Guide.

asset-managementworkflowgoogle-driveapiautomatisierungfashion-ecommerceproduct-updates