---
title: "Identify celebrities in an external image"
method: GET
path: "/api/v0/celebrity-detection/identify"
tags: ["celebrity-detection"]
---

# Identify celebrities in an external image

`GET /api/v0/celebrity-detection/identify`

## Headers

- `Authorization` string, required

## Request body

- CelebrityDetectionIdentifyCelebritiesInExternalImageRequest
  - `image` string, required — Base64 encoded JPEG image

## Response `200`

Successful Response

- CelebrityDetectionIdentifyCelebritiesInExternalImageResponse
  - `persons` CelebrityDetectionPerson[], required — List of persons identified in the image
    - `id` string, uuid, required — Person ID
    - `name` string, required — Person name
    - `aliases` string[], required — Person aliases
    - `bbox` CelebrityDetectionBoundingBox, required
      - `x1` number, double, required
      - `y1` number, double, required
      - `x2` number, double, required
      - `y2` number, double, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)