Перейти к основному содержимому

Работа с изображениями

Ищите, просматривайте и загружайте изображения кошек.

Поиск изображений​

curl -H "x-api-key: YOUR-API-KEY" "https://api.thecatapi.com/v1/images/search?limit=2"

Пример ответа:

[
  {
    "id": "KWdLHmOqc",
    "url": "https://cdn2.thecatapi.com/images/KWdLHmOqc.jpg",
    "width": 3114,
    "height": 2609,
    "breeds": []
  }
]

Полезные фильтры​

limit (1–100), page, order (ASC, DESC, RAND), has_breeds=1, breed_ids=abys,beng, include_breeds=1 и sub_id. Например, два случайных изображения породы Abyssinian с данными о породе:

curl -H "x-api-key: YOUR-API-KEY" "https://api.thecatapi.com/v1/images/search?limit=2&breed_ids=abys&include_breeds=1"

Получить изображение по ID​

curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/images/KWdLHmOqc

Загрузить изображение​

curl -X POST -H "x-api-key: YOUR-API-KEY" -F "file=@/path/cat.jpg" https://api.thecatapi.com/v1/images/upload

Изображение анализируется в фоне. Для синхронного ответа с полным анализом используйте https://upload.thecatapi.com/v1/images/upload-sync (см. английскую страницу Image Uploads).

Проверить статус изображения​

curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/images/IMAGE_ID/status

Список ваших загруженных изображений​

curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/images

Удалить загруженное изображение​

curl -X DELETE -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/images/IMAGE_ID

Получить метки изображения​

Возвращает метки, сгенерированные ИИ (породы, категории), для одного из ваших загруженных изображений.

curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/images/IMAGE_ID/labels