# Raylight > Raylight makes short feature videos (5 to 15 seconds) from a brief pushed over HTTP. Send one sentence of intent plus context, media links and UI source files. Raylight writes a free pitch (script plus shot list). Greenlight it over REST, MCP, the app or a signed login-free link, and the video comes back as a share link plus an editable project you can grow into a longer video in Raylight. Each video is a production (`/v1/productions`). Every production event is pushed to webhooks you register. Raylight never pulls from your systems or holds your credentials. How to use these docs: every page has a markdown twin. Append `.md` to any docs URL (the overview is https://www.raylight.app/docs/index.md), or request the normal URL with `Accept: text/markdown`. API base URL: https://api.raylight.app. Authenticate with `Authorization: Bearer rl_live_...`: productions and webhooks need a key with the `productions` scope, renders the `renders` scope, and each operation below names its own. Every non-2xx body is `{ error, code? }`. Nothing is charged until a pitch is greenlit (`POST /v1/productions/{id}/greenlight`); a video costs 60 credits per second of video, quoted on the pitch as `estimatedCredits`. If no render machine can start on a greenlit video within 30 minutes, the production fails and the credits are refunded. ## Get started - [Raylight API](https://www.raylight.app/docs/index.md): Turn a short brief into a short feature video you can keep editing, from an AI assistant, a workflow or your own code. ## No code - [Use it from an AI assistant](https://www.raylight.app/docs/mcp.md): Connect Claude, ChatGPT, Codex or Cursor once, then ask for videos in chat. No code, no API key. - [Greenlight links](https://www.raylight.app/docs/greenlight-links.md): Signed, login-free links that answer one pitch from Raylight's email, or from anywhere your webhook posts them. ## Automate - [GitHub Action](https://www.raylight.app/docs/github-action.md): A workflow step that builds a brief from your diff on your runner and posts the pitch as a check. - [CLI](https://www.raylight.app/docs/cli.md): Log in, build a brief from a diff, run productions and manage webhooks from a terminal. - [Recipes](https://www.raylight.app/docs/recipes.md): Six small integrations, each with a prompt to hand your agent. ## Build - [Quickstart](https://www.raylight.app/docs/quickstart.md): From nothing to a finished video: one prompt for your coding agent, or the same five calls by hand. - [Productions](https://www.raylight.app/docs/productions.md): How a production moves from brief to finished video, and every field you can send. - [Webhooks](https://www.raylight.app/docs/webhooks.md): Signed production events pushed to your URL, with retries, secret rolling and redelivery. - [Authentication and keys](https://www.raylight.app/docs/authentication.md): API keys, scopes, the device flow, rate limits, and OAuth for MCP. - [SDK](https://www.raylight.app/docs/sdk.md): @raylight/sdk for TypeScript: typed calls, wait helpers and webhook verification. ## Platform - [Limits and pricing](https://www.raylight.app/docs/limits.md): What a video costs, the monthly pitch cap, and every rate and size limit. - [Security](https://www.raylight.app/docs/security.md): What leaves your environment, what Raylight stores, and how secrets and links are protected. ## API reference - [API reference](https://www.raylight.app/docs/reference.md): Every endpoint, generated from the OpenAPI document, with a curl example for each. - [GET /v1/productions: List productions](https://www.raylight.app/docs/reference/get-v1-productions.md) - [POST /v1/productions: Create a production](https://www.raylight.app/docs/reference/post-v1-productions.md) - [GET /v1/productions/usage: This month's usage and pitch cap](https://www.raylight.app/docs/reference/get-v1-productions-usage.md) - [GET /v1/productions/{id}: Read a production](https://www.raylight.app/docs/reference/get-v1-productions-id.md) - [POST /v1/productions/{id}/greenlight: Greenlight the pitch](https://www.raylight.app/docs/reference/post-v1-productions-id-greenlight.md) - [POST /v1/productions/{id}/comments: Send comments](https://www.raylight.app/docs/reference/post-v1-productions-id-comments.md) - [POST /v1/productions/{id}/decline: Decline the pitch](https://www.raylight.app/docs/reference/post-v1-productions-id-decline.md) - [POST /v1/productions/{id}/cancel: Cancel a production](https://www.raylight.app/docs/reference/post-v1-productions-id-cancel.md) - [GET /v1/webhooks: List webhook endpoints](https://www.raylight.app/docs/reference/get-v1-webhooks.md) - [POST /v1/webhooks: Create a webhook endpoint](https://www.raylight.app/docs/reference/post-v1-webhooks.md) - [GET /v1/webhooks/{id}: Read a webhook endpoint](https://www.raylight.app/docs/reference/get-v1-webhooks-id.md) - [PATCH /v1/webhooks/{id}: Update a webhook endpoint](https://www.raylight.app/docs/reference/patch-v1-webhooks-id.md) - [DELETE /v1/webhooks/{id}: Delete a webhook endpoint](https://www.raylight.app/docs/reference/delete-v1-webhooks-id.md) - [POST /v1/webhooks/{id}/roll-secret: Roll the signing secret](https://www.raylight.app/docs/reference/post-v1-webhooks-id-roll-secret.md) - [POST /v1/webhooks/{id}/test: Send a test event](https://www.raylight.app/docs/reference/post-v1-webhooks-id-test.md) - [GET /v1/webhooks/{id}/deliveries: List deliveries](https://www.raylight.app/docs/reference/get-v1-webhooks-id-deliveries.md) - [POST /v1/webhooks/{id}/deliveries/{deliveryId}/redeliver: Redeliver an event](https://www.raylight.app/docs/reference/post-v1-webhooks-id-deliveries-deliveryid-redeliver.md) - [POST your endpoint URL: A production event, delivered to your endpoint](https://www.raylight.app/docs/reference/webhook-production-event.md) - [GET /production-links/{token}: Read a signed greenlight link](https://www.raylight.app/docs/reference/get-production-links-token.md) - [POST /production-links/{token}/greenlight: Greenlight through a link](https://www.raylight.app/docs/reference/post-production-links-token-greenlight.md) - [POST /production-links/{token}/comments: Send comments through a link](https://www.raylight.app/docs/reference/post-production-links-token-comments.md) - [POST /production-links/{token}/decline: Decline through a link](https://www.raylight.app/docs/reference/post-production-links-token-decline.md) - [POST /v1/keys/request: Start a device-code key request](https://www.raylight.app/docs/reference/post-v1-keys-request.md) - [POST /v1/keys/poll: Poll a key request](https://www.raylight.app/docs/reference/post-v1-keys-poll.md) - [DELETE /v1/keys/current: Revoke the key making the call](https://www.raylight.app/docs/reference/delete-v1-keys-current.md) - [POST /v1/renders: Render images into a video](https://www.raylight.app/docs/reference/post-v1-renders.md) - [GET /v1/renders/{id}: Read a render](https://www.raylight.app/docs/reference/get-v1-renders-id.md) ## Machine-readable - [OpenAPI 3.1 document](https://api.raylight.app/v1/openapi.json): every endpoint, generated from the server's own schemas. - [MCP server](https://api.raylight.app/mcp): streamable HTTP, OAuth sign-in, the same production and webhook tools for AI clients. - [Render API (images in, video out)](https://www.raylight.app/api.md): the older one-call endpoint. ## Optional - [Full documentation in one file](https://www.raylight.app/llms-full.txt): every docs page in one file.