Работа с изображениями
Ищите, просматривайте и загружайте изображения собак.
Поиск изображений
curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/images/search?limit=2"
Пример ответа:
[
{
"id": "BJa4kxc4X",
"url": "https://cdn2.thedogapi.com/images/BJa4kxc4X.jpg",
"width": 1600,
"height": 1199,
"breeds": []
}
]
Полезные фильтры
limit (1–100), page, order (ASC, DESC, RAND), has_breeds=1, breed_ids=115,1, include_breeds=1 и sub_id. Например, два случайных изображения породы German Shepherd с данными о породе:
curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/images/search?limit=2&breed_ids=115&include_breeds=1"
Получить изображение по ID
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/BJa4kxc4X
Загрузить изображение
curl -X POST -H "x-api-key: YOUR-API-KEY" -F "file=@/path/dog.jpg" https://api.thedogapi.com/v1/images/upload
Изображение анализируется в фоне. Для синхронного ответа с полным анализом используйте https://upload.thedogapi.com/v1/images/upload-sync (см. английскую страницу Image Uploads).
Проверить статус изображения
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/IMAGE_ID/status
Список ваших загруженных изображений
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images
Удалить загруженное изображение
curl -X DELETE -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/IMAGE_ID
Получить метки изображения
Возвращает метки, сгенерированные ИИ (породы, категории), для одного из ваших загруженных изображений.
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/IMAGE_ID/labels