---
title: "Search Clips by Image"
method: POST
path: "/serve/api/v1/search_clips_by_image"
---

# Search Clips by Image

`POST /serve/api/v1/search_clips_by_image`

## Response `200`

Successful response

- SearchClipsByImageResponse
  - `code` string
  - `msg` string
  - `data` object[]
    - `start_time` number, double — Clip start time in seconds.
    - `end_time` number, double — Clip end time in seconds.
    - `score` number, double — Similarity score.
    - `video_bucket` string — GCS bucket of the target video file. Omitted when the storage location cannot be resolved.
    - `video_blob` string — GCS blob path of the target video. Use with video_bucket at GET /serve/api/v2/download to fetch the file directly.
  - `success` boolean
  - `failed` boolean

---

[API](https://skmtc.dev/memories/apis/screenplay-extraction-api.md) · [All operations](https://skmtc.dev/memories/apis/screenplay-extraction-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/memories/screenplay-extraction-api/revisions/720c8c144ddc/schema)