allegro / allegro/allegro-api

[NEWS] Oznaczanie zdjęć “AI” (AI Act) – wdrożyliśmy obsługę aiCoCreatedContent oraz zmiany w POST /sale/images / "AI" image labeling (AI Act) – we have implemented support for aiCoCreatedContent and changes in POST /sale/images

オープン
#13,798 コメント 0 件 リアクション 0 件 担当者 1 名 @Aureliusz-Brussy が担当を希望しています GitHub で見る
News Offer - images and attachments Offer - management Offer - Products
主要言語
言語のデータがありません
スター
244
フォーク
40
PR マージ指標
30日以内にマージされた PR はありません

説明

[Zgodnie z zapowiedzią](https://developer.allegro.pl/news/oznaczanie-zdjec-ai-ai-act-dodajemy-oraz-rozszerzamy-strukture-aicocreatedcontent-o-pole-images-oraz-wprowadzamy-zmiany-w-post-sale-images-oAk7nPX3zuW), uruchomiliśmy pełną obsługę oznaczania zdjęć wygenerowanych lub istotnie zmodyfikowanych przez sztuczną inteligencję (deepfake). Zmiany pozwolą Tobie i Twoim użytkownikom spełnić wymogi unijnego Aktu o sztucznej inteligencji ([**AI Act**](https://digital-strategy.ec.europa.eu/pl/policies/regulatory-framework-ai)), który wchodzi w życie **2 sierpnia 2026 roku**.

Znieśliśmy tymczasowe ograniczenie – struktura `aiCoCreatedContent` w publicznym API w pełni przyjmuje, przetwarza i zwraca wartości w tablicy `images` (nie zwraca już domyślnie pustej tablicy).

#### Kluczowe zasady techniczne

Podczas integracji **zwróć szczególną uwagę** na logikę systemu:

* **Oznaczenie tylko przy uploadzie** – informację o tym, że zdjęcie ma być oznaczone “AI” przekaż **podczas pierwszego dodawania zdjęcia** do platformy. Po dodaniu pliku nie zmienisz oznaczenia na zdjęciu.
* **Logika bazy zdjęć** – jeśli przesyłasz nowe zdjęcie z zewnątrz, system zapisze, czy chcesz je oznaczyć “AI”. Jeśli używasz zdjęcia już istniejącego w bazie Allegro, zignorujemy dane, które wysyłasz w strukturze `aiCoCreatedContent` (liczy się oznaczenie użyte przy pierwotnym uploadzie zdjęcia)
* **Domyślny brak oznaczenia “AI”** – brak parametru przy nowo wgrywanych plikach oznacza, że zdjęcie nie chcesz, by na zdjęciu pojawiło się oznaczenia “AI”

> **Ważna informacja dot. znaku wodnego**
>
> Wskazane materiały w obiekcie `aiCoCreatedContent` (w zasobach zarządzania ofertami i wgrywania zdjęć) oznaczymy znakiem wodnym AI. **Funkcja oznaczania zdjęć znakiem wodnym „AI" jest w fazie testów \[BETA\] oraz ma charakter wyłącznie techniczny i pomocniczy.**
>
> Sprzedawca odpowiada za to, co pokazuje w ofercie oraz za jej zgodność z przepisami prawa, w tym za treść oferty i ocenę, czy wymaga oznaczenia „AI”. Ocena charakteru zdjęcia i decyzja, czy je oznaczyć znakiem wodnym „AI”, należy do niego. Gdy zdecyduje się na nasze oznaczenia zdjęcia „AI”, akceptuje sposób jego wyświetlania, działanie, stan techniczny funkcji i zrzeka się roszczeń z tytułu sposobu oznaczania.

#### Zmiany w API w pigułce

**1\. Zarządzanie ofertami**

W endpointach tworzenia i edycji dodaliśmy sekcję `aiCoCreatedContent.images`, w której przekażesz lub odbierzesz adresy URL zdjęć do oznaczenia “AI”. Dotyczy to:

* [POST /sale/product-offers](https://developer.allegro.pl/documentation#tag/Offer-management/operation/createProductOffers)
* [PATCH /sale/product-offers/{id}](https://developer.allegro.pl/documentation#tag/Offer-management/operation/editProductOffers)
* [GET /sale/product-offers/{id}](https://developer.allegro.pl/documentation#tag/User's-offer-information/operation/getProductOffer)

**Fragment requestu/response:**

```json5
{
...
"images": [
"https://...obrazek1.jpeg",
"https://...obrazek-AI.jpeg"
],
"aiCoCreatedContent": {
"images": [
{
"url": "https://...obrazek-AI.jpeg"
}
]
}
...
}
```

**2\. Katalog Produktów**

Zwracamy zaktualizowaną strukturę `aiCoCreatedContent` w odpowiedziach (brak zdjęcia w tablicy oznacza brak oznaczenia “AI”). Dotyczy to:

* [GET /sale/products](https://developer.allegro.pl/documentation#tag/Products/operation/getSaleProducts)
* [GET /sale/products/{productId}](https://developer.allegro.pl/documentation#tag/Products/operation/getSaleProduct)

Dla [POST /sale/product-proposals](https://developer.allegro.pl/documentation#tag/Products/operation/proposeSaleProduct) **ignorujemy pole w żądaniu** (chęć oznaczenia “AI” składasz przy wcześniejszym uploadzie zdjęcia), ale zwracamy odpowiednio wypełnioną strukturę w response dla spójności danych.

**3\. Wgrywanie zdjęć**

W endpoincie [POST /sale/images](https://developer.allegro.pl/documentation#tag/Images-and-attachments/operation/uploadOfferImageUsingPOST) dodaliśmy:

* **query parametr:** `isAiCoCreated=true/false` (działa dla wszystkich `Content-Type`),
* **pole w body:** `"isAiCoCreated": true/false` (dostępne tylko dla `Content-Type: "application/vnd.allegro.public.v1+json"`).

#### Dlaczego to ważne?

Niedostosowanie się do przepisów AI Act i brak umożliwienia sprzedawcom oznaczania takich zdjęć, grozi surowymi karami administracyjnymi (do 15 mln euro lub do 3% obrotu). **Dostosuj swoją aplikację jak najszybciej**, aby zapewnić użytkownikom bezpieczną i zgodną z prawem obsługę ofert.

Więcej informacji oraz odpowiedzi na najczęściej zadawane pytania znajdziesz w [Pomocy dla sprzedającego](https://help.allegro.com/pl/sell/a/oznaczanie-zdjec-wygenerowanych-lub-zmodyfikowanych-za-pomoca-ai-najczesciej-zadawane-pytania-lLPlveB2RhE).

Więcej o wystawianiu oferty produktu przez API przeczytasz w [naszym poradniku](https://developer.allegro.pl/tutorials/jak-jednym-requestem-wystawic-oferte-powiazana-z-produktem-D7Kj9gw4xFA).

--------

[As previously announced](https://developer.allegro.pl/news/ai-image-labeling-ai-act-we-are-adding-and-extending-the-aicocreatedcontent-structure-with-the-images-field-and-introducing-changes-to-post-sale-images-oAk7nPX3zuW), we have launched full support for labeling images generated or significantly modified by artificial intelligence (deepfakes). These changes will allow you and your users to meet the requirements of the EU Artificial Intelligence Act ([**AI Act**](https://digital-strategy.ec.europa.eu/pl/policies/regulatory-framework-ai)), which comes into force on **August 2, 2026**.

We have removed the temporary restriction – the `aiCoCreatedContent` structure in the public API now fully accepts, processes, and returns values in the `images` array (it no longer returns an empty array by default).

#### Key technical rules

When integrating, **pay special attention** to the system logic:

* **Labeling only upon upload** – provide the information that the image should be labeled as "AI" **during the initial addition (upload) of the image** to the platform. Once the file is added, you will not be able to change the label on the image.
* **Image database logic** – if you upload a new image from an external source, the system will save whether you want to label it as "AI". If you use an image that already exists in the Allegro database, we will ignore the data you send in the `aiCoCreatedContent` structure (the label used during the original image upload applies).
* **Default no "AI" label** – no parameter for newly uploaded files means you do not want the "AI" label to appear on the image.

> **Important information regarding the watermark**
>
> We will mark the media indicated in the `aiCoCreatedContent` object (in the offer management and image upload resources) with an "AI" watermark. **The "AI" watermarking feature is currently in the beta testing phase and is for technical and auxiliary purposes only.**
>
> The merchant is responsible for the content of the offer and its compliance with legal regulations, including the content of the offer and the assessment of whether it requires an "AI" watermark. It is their responsibility to assess the nature of the photo and decide whether to mark it with an "AI" watermark. By choosing our "AI" watermarking for the photo, they accept its display, functionality, and technical condition, and waive any claims arising from the marking method.

#### API changes in a nutshell

**1\. Offer management**

In the creation and editing endpoints, we have added the `aiCoCreatedContent.images` section, where you will pass or receive the URLs of the images to be labeled as "AI". This applies to:

* [POST /sale/product-offers](https://developer.allegro.pl/documentation#tag/Offer-management/operation/createProductOffers)
* [PATCH /sale/product-offers/{id}](https://developer.allegro.pl/documentation#tag/Offer-management/operation/editProductOffers)
* [GET /sale/product-offers/{id}](https://developer.allegro.pl/documentation#tag/User's-offer-information/operation/getProductOffer)

**Request/response fragment:**

```json5
{
...
"images": [
"https://...image1.jpeg",
"https://...image-AI.jpeg"
],
"aiCoCreatedContent": {
"images": [
{
"url": "https://...image-AI.jpeg"
}
]
}
...
}
```

**2\. Product Catalog**

We return the updated `aiCoCreatedContent` structure in responses (no image in the array means no "AI" label). This applies to:

* [GET /sale/products](https://developer.allegro.pl/documentation#tag/Products/operation/getSaleProducts)
* [GET /sale/products/{productId}](https://developer.allegro.pl/documentation#tag/Products/operation/getSaleProduct)

For [POST /sale/product-proposals](https://developer.allegro.pl/documentation#tag/Products/operation/proposeSaleProduct), we **ignore the field in the request** (you declare your willingness to use the "AI" label during the earlier image upload), but we return the properly filled structure in the response for data consistency.

**3\. Image upload**

In the [POST /sale/images](https://developer.allegro.pl/documentation#tag/Images-and-attachments/operation/uploadOfferImageUsingPOST) endpoint, we have added:

* **query parameter:** `isAiCoCreated=true/false` (works for all `Content-Type`s),
* **field in the body:** `"isAiCoCreated": true/false` (available only for `Content-Type: "application/vnd.allegro.public.v1+json"`).

#### Why is this important?

Failure to comply with the AI Act regulations and failing to enable sellers to label such images may result in severe administrative fines (up to €15 million or up to 3% of turnover). **Adapt your application as soon as possible** to ensure safe and legally compliant offer management for users.

You can find more information and answers to frequently asked questions in the [Help for Sellers page](https://help.allegro.com/pl/sell/a/oznaczanie-zdjec-wygenerowanych-lub-zmodyfikowanych-za-pomoca-ai-najczesciej-zadawane-pytania-lLPlveB2RhE).

You can read more about listing a product offer via API in [our tutorial](https://developer.allegro.pl/tutorials/jak-jednym-requestem-wystawic-oferte-powiazana-z-produktem-D7Kj9gw4xFA).

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

評価

この issue はまだ評価されていません。

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。