Saltar al contenido principal

Trabajando con Imágenes

Busca, lista y sube imágenes de gatos.

Buscar imágenes​

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

Respuesta de ejemplo:

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

Filtros útiles​

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

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

Obtener una imagen por ID​

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

Subir una imagen​

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

La imagen se analiza en segundo plano. Para una respuesta síncrona con el análisis completo usa https://upload.thecatapi.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.thecatapi.com/v1/images/IMAGE_ID/status

Listar tus imágenes subidas​

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

Eliminar una imagen subida​

curl -X DELETE -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.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.thecatapi.com/v1/images/IMAGE_ID/labels