---
title: "Start Analyze"
method: POST
path: "/api/auto-sfx/analyze"
tags: ["AutoSFX"]
---

# Start Analyze

`POST /api/auto-sfx/analyze`

## Request body

- FeaturesAutoSfxSchemasAnalyzeRequest
  - `object_key` string
  - `filename` string
  - `cut_points` number[]
  - `grids` GridIn[]
    - `object_key` string, required
    - `times` number[], required
  - `scope` 'timeline' | 'inout'
  - `range_start` number
  - `range_end` number, nullable
  - `fps` number
  - `trigger_speech` boolean
  - `trigger_cuts` boolean
  - `allowed_categories` string[]
  - `sfx_per_minute` integer
  - `user_prompt` string
  - `model` string, nullable
  - `source` 'panel' | 'agent'

## Response `200`

Successful Response

- SfxJobResponse
  - `job_id` string, required
  - `status` string, required

## Other responses

- `422` — Validation Error

---

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