---
title: "Start Color Grade"
method: POST
path: "/api/color-grade"
tags: ["ColorGrade"]
---

# Start Color Grade

`POST /api/color-grade`

Kick off the async grade job. Panel has already exported + uploaded ONE
frame per source to R2. Cost = 1 credit / frame.

## Request body

- ColorGradeRequest
  - `frames` FrameRef[], required
    - `node_id` string, required
    - `object_key` string, required
    - `name` string, nullable
  - `timeline_clips` object[], required
  - `available_effects` object, nullable
  - `user_prompt` string
  - `model` string
  - `source` string
  - `time_start` number, nullable
  - `time_end` number, nullable

## Response `200`

Successful Response

- unknown

## 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)