Pular para o conteúdo principal

Trabalhando com Imagens

Pesquise, liste e envie imagens de gatos.

Buscar imagens​

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

Exemplo de resposta:

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

Filtros úteis​

limit (1–100), page, order (ASC, DESC, RAND), has_breeds=1, breed_ids=abys,beng, include_breeds=1 e sub_id. Por exemplo, duas imagens aleatórias de Abyssinian com os detalhes da raça:

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

Obter uma imagem pelo ID​

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

Enviar uma imagem​

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

A imagem é analisada em segundo plano. Para uma resposta síncrona com a análise completa use https://upload.thecatapi.com/v1/images/upload-sync (veja a página em inglês Image Uploads).

Verificar o status de uma imagem​

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

Listar suas imagens enviadas​

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

Excluir uma imagem enviada​

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

Obter os rótulos de uma imagem​

Retorna os rótulos gerados pela IA (raças, categorias) de uma das suas imagens enviadas.

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