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

# Images in ads

Use the methods [AdImage (Live)](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage.md) and [AdImageAssociation (Live)](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImageAssociation.md) to manage images. The AdImageHash parameter is used as the image identifier.


{% note alert %}

Points are deducted when these methods are invoked (see the section [Point limitations](https://yandex.com/dev/direct/doc/dg-v4/en/concepts/Restrictions.md#Units)).

{% endnote %}


## Creating ads with images {#create}

1. Use the [CreateOrUpdateBanners](https://yandex.com/dev/direct/doc/dg-v4/en/live/CreateOrUpdateBanners.md) method to create ads (banners). The API creates ads **without** images.
1. Upload the images to the Yandex Direct server:
    - Using the synchronous action [UploadRawData](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage_UploadRawData.md) for the [AdImage](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage.md) method, up to 10 images per operation can be uploaded as binary data.
    - Using the asynchronous [Upload](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage_Upload.md) action for the [AdImage](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage.md) method, up to 10,000 images per operation can be uploaded by specifying their URLs.
    
    Use the [CheckUploadStatus](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage_CheckUploadStatus.md) action to check the status of uploading images.
    
1. When the desired images have been uploaded, use the [Set](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImageAssociation_Set.md) action for the [AdImageAssociation](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImageAssociation.md) method to associate the images with ads.
    
    {% note info %}
    
    When associating an image with an ad that has the “Draft” status, points are not deducted for the operation. For this reason, it is wise to create associations first, and then submit ads for moderation.
    
    {% endnote %}
    
1. Use the [ModerateBanners](https://yandex.com/dev/direct/doc/dg-v4/en/live/ModerateBanners.md) method to submit ads for moderation. Images will be moderated together with the ads that they are associated with.
    
    {% note info %}
    
    When associating an image with an ad that has already been approved by the moderator (or is located in an archive), the image is automatically submitted for moderation.
    
    {% endnote %}
    
1. Use the [Get](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImageAssociation_Get.md) action for the [AdImageAssociation](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImageAssociation.md) method to check the image moderation status.

## Removing images {#delete}

We recommend regularly removing any images that are not associated with any ads. Use the [Delete](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage_Delete.md) action for the [AdImage (Live)](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage.md) method to remove unassociated images.

Use the [Get](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage_Get.md) action for the [AdImage (Live)](https://yandex.com/dev/direct/doc/dg-v4/en/live/AdImage.md) method to get a list of a client's images. You can specify a filter to select only unassociated images.

## Related information

- [Image (AdImage)](https://yandex.com/dev/direct/doc/dg-v4/en/concepts/ad-image.md)