Automatyczna analiza zdjęć dla packshotów z wtyczek

Każdy packshot zarejestrowany przez POST /plugin/packshots jest teraz w tle przetwarzany przez analizator zdjęć Qamery. Analizator rozpoznaje stronę produktu (przód, tył, bok, góra, dół), wykrywa obecność tekstu na zdjęciu, opisuje tło i wnioskuje pola na poziomie produktu, takie jak ogólna kategoria czy charakterystyka. Powstałe metadane lądują w katalogu instalacji i są automatycznie wykorzystywane w promptach generacyjnych — bez dodatkowego wywołania API, nagłówka czy flagi włączającej tę funkcję.

Dla sklepów oznacza to wyraźnie lepsze wyniki generacji: pomylenie strony produktu (np. tył wygenerowany jako przód) oraz utrata tekstu z opakowania — dwa najczęstsze błędy — są adresowane u źródła. Packshoty wgrywane bez osobnego source_image_ref nie wymagają go już; API tworzy automatycznie powiązany wiersz zdjęcia źródłowego, a identyczna zawartość przesłana dwukrotnie jest deduplikowana po haszu bez ponownej analizy.

Kilka zmian w zachowaniu, o których powinni wiedzieć autorzy wtyczek:

• Zadania wskazujące packshot, którego wtyczka wcześniej nie zarejestrowała, kończą się teraz nowym typem błędu PLUGIN_JOB_MISSING_CATALOG_ENTRY. Zarejestruj packshot przez POST /plugin/packshots (lub równoważną mutację katalogu), zanim wyślesz zadanie.
• Na webhookach webhook.failed mogą pojawić się dwa nowe typy błędów: PREPARE_PHOTOS_TIMEOUT i PREPARE_PHOTOS_FAILED, gdy analizator działa zbyt długo lub odrzuci obraz. Oba to błędy trwałe; przyczynę widać w treści webhooka.
• Pola opcjonalne product_name, product_specific_category, product_side i product_general_category w treści POST /plugin/jobs są uznane za przestarzałe. API nadal je akceptuje dla wstecznej zgodności, ale ignoruje przekazane wartości — odpowiedniki z katalogu sterują promptem. Pełne wyłączenie tych pól nastąpi w przyszłej wersji; rekomendujemy ich usunięcie z treści żądań.

Istniejące integracje działają bez zmian w kodzie; nowe zachowanie wnosi wyłącznie dodatkową analizę.