---
title: "Create Video Job"
method: POST
path: "/v1/video/create"
---

# Create Video Job

`POST /v1/video/create`

## Request body

- VideoCreateJobRequest — Request model for creating a video generation job.
  - `model` string, nullable — The model to use for the video generation
  - `messages` BasicMessage[], nullable — The messages that will be used to generate the video script
    - `role` 'user' | 'assistant' | 'system', required
    - `content` string, required
  - `include_sources` boolean, nullable — Whether to gather data from the web to help with the video script
  - `search_for` string, nullable — The query to search the web for
  - `source_count` integer, nullable — The number of sources to gather from the web
  - `length` integer, nullable — The number of paragraphs to generate for the video script
  - `script` string, nullable — The script to use for the video, with sections delimited by '-----'
  - `upload_to_s3` boolean, nullable — Whether to upload the video to S3
  - `title` string, nullable — The title of the video, if you want to provide one
  - `webhook_url` string, nullable — The Webhook URL to send the video completion response to
  - `exclude_watermark` boolean, nullable — Whether to exclude the watermark from the video

## Response `200`

Successful Response

- VideoCreateJobResponse — Response model for video job creation.
  - `success` boolean, required
  - `message` string, nullable
  - `video_id` string, nullable

## Other responses

- `401` — Invalid API key or unauthorized access
- `402` — Insufficient credits
- `422` — Validation Error
- `429` — Rate limit exceeded
- `500` — Internal server error

---

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