---
title: "Detect animals"
method: POST
path: "/v1/apple/animals"
tags: ["Apple"]
---

# Detect animals

`POST /v1/apple/animals`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/apple/animals`
- Auth: HTTP bearer

Detects cats and dogs with bounding boxes and classification.

## Request body

- ImageRequest
  - `image` string, required: Base64-encoded image data (PNG, JPEG, TIFF, HEIC)

## Response `200`

Detected animals

- object
  - `animals` object[]
    - `label` string
    - `confidence` number
    - `bounding_box` BoundingBox: Normalized coordinates (0–1), bottom-left origin
      - `x` number, required
      - `y` number, required
      - `width` number, required
      - `height` number, required

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)