Pular para o conteúdo principal

Trabalhando com Imagens

Pesquise, liste e envie imagens de cães.

Buscar imagens​

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

Exemplo de resposta:

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

Filtros úteis​

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

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

Obter uma imagem pelo ID​

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

Enviar uma imagem​

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

A imagem é analisada em segundo plano. Para uma resposta síncrona com a análise completa use https://upload.thedogapi.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.thedogapi.com/v1/images/IMAGE_ID/status

Listar suas imagens enviadas​

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

Excluir uma imagem enviada​

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