---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/direct/doc/en/objects/adimage.md
  - https://yandex.ru/dev/direct/doc/ru/objects/adimage.md
  - href: ru/objects/adimage.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/dg/objects/adimage.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt

# Изображение (AdImage)

Объект Изображение (AdImage) содержит изображение. В качестве идентификатора изображения используется параметр [AdImageHash](*AdImageHash).

У объявления может быть только одно изображение (либо ни одного). Одно и то же изображение можно привязать к нескольким объявлениям. Подробнее в разделе [Изображения в объявлении](https://yandex.ru/support/direct/efficiency/images.html) Справки Директа.


## Сервис {#service}

Для загрузки изображений в виде бинарных данных, а также для удаления изображений предназначен сервис [AdImages](https://yandex.ru/dev/direct/doc/ref-v5/adimages/adimages.html). Для асинхронной загрузки изображений по списку URL используйте операцию [Upload](https://yandex.ru/dev/direct/doc/dg-v4/live/AdImage_Upload.html) метода [AdImage \(Live\)](https://yandex.ru/dev/direct/doc/dg-v4/live/AdImage.html) API версии Live 4.

Редактирование изображений не предусмотрено. Если требуется изменить изображение, необходимо загрузить новое изображение и привязать его к объявлениям.

Привязать изображение к объявлению или отвязать от объявления можно с помощью сервиса [Ads](https://yandex.ru/dev/direct/doc/ref-v5/ads/ads.html), см. [Дополнения к объявлению](https://yandex.ru/dev/direct/doc/ru/best-practice/launch-campaign.md#harness).

Изображение проходит модерацию только в связке с объявлением, см. [Результат модерации дополнений](https://yandex.ru/dev/direct/doc/ru/objects/ad.md#moderate-addon).

Удалить изображение можно только в случае, если оно не привязано ни к одному объявлению. Получить список объявлений, к которым привязано конкретное изображение, можно с помощью сервиса [Ads](https://yandex.ru/dev/direct/doc/ref-v5/ads/ads.html).


## Ограничения {#restrictions}

Количество изображений у пользователя не может превышать 1000 + 2 × количество объявлений.


## Требования к изображениям, загружаемым через API {#requirements}

- Допустимые форматы изображений: JPG, PNG, GIF.

- Допустимые размеры изображений для графических объявлений:

    - 240 × 400, 300 × 250, 300 × 500, 300 × 600, 320 × 50, 320 × 100, 320 × 480, 336 × 280, 480 × 320, 480 × 800, 600 × 500, 600 × 1000, 600 × 1200, 640 × 100, 640 × 200, 640 × 960, 672 × 560, 720 × 1200, 728 × 90, 900 × 750, 900 × 1500, 900 × 1800, 960 × 150, 960 × 300, 960 × 640, 960 × 1440, 960 × 1600, 970 × 250, 1008 × 840, 1200 × 1000, 1200 × 2000, 1200 × 2400, 1280 × 200, 1280 × 400, 1280 × 1920, 1344 × 1120, 1440 × 960, 1456 × 180, 1920 × 1280, 1940 × 500, 2184 × 270, 2910 × 750, 2912 × 360, 3880 × 1000;

    - размер файла не более 512 КБ.

- Допустимые размеры изображений для других типов объявлений:

    - при соотношении сторон от 1:1 до 3:4/4:3 — от 450 до 5000 пикселей по каждой стороне;

    - при соотношении сторон 16:9 — от 1080 × 607 до 5000 × 2812 пикселей;

    - размер файла не более 10 МБ.



## Тип изображения {#type}

Тип изображения (параметр [Type](*Type), возвращаемый методом `get`) определяется автоматически при загрузке. Описание типов представлено в таблице:


#|
||
**Тип**
|
**Описание**
|
**Подходит для типов объявлений**
||
||
REGULAR
|
Соотношение сторон от 1:1 до 3:4/4:3

Размер от 450 до 5000 пикселей по каждой стороне
|
TEXT_AD

DYNAMIC_TEXT_AD
||
||
WIDE
|
Соотношение сторон 16:9

Размер от 1080 × 607 до 5000 × 2812 пикселей.
|
TEXT_AD

DYNAMIC_TEXT_AD

MOBILE_APP_AD
||
||
FIXED_IMAGE
|
Один из размеров: 240 × 400, 300 × 250, 300 × 500, 300 × 600, 320 × 50, 320 × 100, 320 × 480, 336 × 280, 480 × 320, 480 × 800, 600 × 500, 600 × 1000, 600 × 1200, 640 × 100, 640 × 200, 640 × 960, 672 × 560, 720 × 1200, 728 × 90, 900 × 750, 900 × 1500, 900 × 1800, 960 × 150, 960 × 300, 960 × 640, 960 × 1440, 960 × 1600, 970 × 250, 1008 × 840, 1200 × 1000, 1200 × 2000, 1200 × 2400, 1280 × 200, 1280 × 400, 1280 × 1920, 1344 × 1120, 1440 × 960, 1456 × 180, 1920 × 1280, 1940 × 500, 2184 × 270, 2910 × 750, 2912 × 360, 3880 × 1000
|
IMAGE_AD
||
|#


{% note info %}

Для обеспечения обратной совместимости используются следующие типы изображений:
- SMALL — соотношение сторон от 1:1 до 3:4, размер 150 пикселей по меньшей стороне.

- UNFIT — тип изображения неизвестен или не поддерживается в данной версии API.


Изображения этих типов невозможно привязать к объявлению.

{% endnote %}

[*AdImageHash]: Хэш изображения.

[*Type]: Тип изображения, см. [Тип изображения](#type).
