VIDEOS

Delete a Video

Delete a video job. Queued jobs are cancelled (and never billed); completed jobs have their stored MP4 removed. A generation that is already running cannot be stopped — wait for it to finish (409).

DELETE/v1/videos/{video_id}

Authorization

Authorizationstringheaderrequired

Bearer token — your API key. Example: Bearer sk-...

Behaviour by status

Status	Effect
`queued`	The job is cancelled and removed. You are never charged.
`in_progress`	Not deletable — the generation cannot be stopped once running. Returns 409; wait for a terminal state.
`completed`	The job record and its stored MP4 are removed.
`failed`	The job record is removed.

Usage history is unaffected — billing records for completed generations are retained.

Response

idstringrequired

The deleted video's ID.

object"video.deleted"required

Object type — always "video.deleted".

deletedbooleanrequired

Always true on success.

Request

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "your-scx-api-key",
  baseURL: "https://api.scx.ai/v1",
});

const result = await client.videos.delete("video_9f6c2c4e");

console.log(result.deleted); // true

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "your-scx-api-key",
  baseURL: "https://api.scx.ai/v1",
});

const result = await client.videos.delete("video_9f6c2c4e");

console.log(result.deleted); // true

Response

{
  "id": "video_9f6c2c4e-1c39-4d1a-b7bd-1c0d6d6a2f30",
  "object": "video.deleted",
  "deleted": true
}

{
  "id": "video_9f6c2c4e-1c39-4d1a-b7bd-1c0d6d6a2f30",
  "object": "video.deleted",
  "deleted": true
}