Saltar al contenido principal

Trabajando con Imágenes

Busca, lista y sube imágenes de perros.

Buscar imágenes​

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

Respuesta de ejemplo:

[
  {
    "id": "BJa4kxc4X",
    "url": "https://cdn2.thedogapi.com/images/BJa4kxc4X.jpg",
    "width": 1600,
    "height": 1199,
    "breeds": []
  }
]

Filtros útiles​

limit (1–100), page, order (ASC, DESC, RAND), has_breeds=1, breed_ids=115,1, include_breeds=1 y sub_id. Por ejemplo, dos imágenes aleatorias de German Shepherd con los detalles de la raza:

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

Obtener una imagen por ID​

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

Subir una imagen​

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

La imagen se analiza en segundo plano. Para una respuesta síncrona con el análisis completo usa https://upload.thedogapi.com/v1/images/upload-sync (consulta la página en inglés Image Uploads).

Comprobar el estado de una imagen​

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

Listar tus imágenes subidas​

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

Eliminar una imagen subida​

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

Obtener las etiquetas de una imagen​

Devuelve las etiquetas generadas por la IA (razas, categorías) de una de tus imágenes subidas.

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