What is the Raylight API?

A way to get a short video for every feature you ship, the one you would never have made by hand. You send a brief, Raylight pitches a script and shot list for free, and when someone greenlights it Raylight makes the video. You get a share link and a Raylight project you can keep building into a full launch video.

Do I need to write code?

No. Connect Raylight to Claude or ChatGPT once and ask for videos in chat, and greenlight pitches from links in your email. The REST API, TypeScript SDK, CLI and GitHub Action are there when you want to automate it.

How much does it cost?

Pitches and changes to them are free. A video costs 60 credits per second of video, so 300 to 900 credits, charged once when someone greenlights it. It works on every plan, Free included; your plan only sets how many pitches and videos you can make each month. Nothing is charged for a declined or skipped pitch, and credits come back if the video can't be made.

A share link to the video, with no Raylight watermark on any plan, and a real Raylight project in your workspace, so you can open it in the editor and change anything. Every step can also arrive as a signed webhook.

What lengths and shapes can it make?

5 to 15 seconds, in nine aspect ratios including 16:9, 9:16, 1:1 and 4:5. Short on purpose: a feature recap or changelog explainer. For something longer, open the project in Raylight and keep going.

Does Raylight get access to my repository?

No. Raylight is push only: it never connects to your repo, deploy or chat tools. The GitHub Action runs on your own runner and sends only the brief it builds there, and you choose which files go into it in the workflow.

How do I know when a video is ready?

Register a webhook and Raylight posts a signed event when the pitch is ready, when it is greenlit, and when the video is done. You can also poll the production, let the SDK wait for you, or follow it with the CLI.

Which languages are supported?

There's an official TypeScript SDK for Node, and a CLI. For any other language, call the REST API directly; the full OpenAPI document is public, so you can generate a client.

Raylight API

A video for every
feature you ship

Send what the video is about from your code, a GitHub workflow, or a chat with Claude. Raylight writes the script and shot list for free, then makes a short feature video once you greenlight it, as a project you can keep building into a full launch video.

Get an API key Read the docs

Productions

SearchNew production

All9Needs review1In progress3Wrapped4Closed1

VideoStageFormatCreated

Split the bill with friendsClaude Code

Pitch readyFeature · 15s · 9:164m

Pay anyone in a tapacme/ios #412

WrappedFeature · 15s · 16:912m

Dark mode for the dashboardacme/web #409

In productionFeature · 30s · 16:91h

What's new in 2.3v2.3.0

GreenlitChangelog · 20s · 1:13h

Offline sync on iOSENG-2143

Writing pitchFeature · 20s · 9:165h

Savings goalsAPI

WrappedLaunch · 20s · 16:91d

Team spacesacme/web #398

WrappedFeature · 15s · 4:52d

October in reviewClaude Code

WrappedDigest · 45s · 16:93d

Spending insightsAPI

DeclinedFeature · 20s · 16:94d

Pay anyone in a tap

acme/ios #412 · Feature · 15s · 16:9

Wrapped

Brief

Show the new pay and request flow in the Acme app

raylight.app/v/pay-anyone-in-a-tapCopy linkEdit

For developers

Works with
your stack

A REST API with a typed TypeScript SDK, a CLI and a GitHub Action, plus an MCP server for Claude and ChatGPT. If it can send an HTTP request, it can ask for a video.

TypeScript SDK
REST API
CLI
GitHub Actions
Claude
Codex
Cursor
Webhooks
Greenlight links

acme-app

app
api
raylight
route.ts
release
route.ts
layout.tsx
lib
slack.ts
raylight.ts
.env.local
package.json

app/api/raylight/route.tsmain

01import { constructWebhookEvent } from "@raylight/sdk";02import { postToSlack } from "@/lib/slack";0304export const POST = async (request: Request) => {05  const event = constructWebhookEvent(06    await request.arrayBuffer(),07    request.headers.get("raylight-signature") ?? "",08    process.env.RAYLIGHT_WEBHOOK_SECRET!09  );1011  if (event.type === "production.pitch_ready") {12    await postToSlack(`Pitch ready: ${event.data.links.greenlight}`);13  }1415  if (event.type === "production.delivered") {16    await postToSlack(`New video: ${event.data.links.share}`);17  }1819  return new Response(null, { status: 200 });20};

import { Raylight } from "@raylight/sdk";const raylight = new Raylight();const production = await raylight.productions.create({  brief: { intent: "Show the new pay flow in the Acme app" },  greenlightMode: "auto",});const { production: done } = await raylight.productions.waitForDelivery(  production.id);console.log(done.delivery?.shareUrl);

curl https://api.raylight.app/v1/productions \  -H "Authorization: Bearer $RAYLIGHT_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "brief": {      "intent": "Show the new pay flow in the Acme app",      "format": { "template": "feature", "aspect": "16:9" }    },    "externalId": "acme/app#pay-flow"  }'

npm install -g raylightraylight loginraylight productions create \  --intent "Announce multitrack audio" \  --media https://acme.dev/press/tracks.png::Tracks \  --duration 20raylight productions greenlight <id>raylight productions watch <id>

Four steps.
Only one needs you.

Raylight writes the pitch and makes the video. You read it and greenlight it, or let it go ahead on its own.

{  "brief": {    "intent": "Introduce the new prompt bar",    "context": "Type what you want and Acme builds it.",    "media": [      { "id": "bar", "kind": "image", "name": "Prompt bar",        "url": "https://acme.dev/press/bar.png" }    ],    "format": { "template": "feature", "aspect": "16:9" }  },  "externalId": "acme/web#512"}

1 · Send a brief

One sentence about the video, plus any release notes, screenshots or UI files you have.

Pitchv2Pitch ready

Just ask

A 5 second feature recap. One prompt, one send, and the answer it builds. Opens on the prompt bar, as asked.

01Open on the barThe prompt bar fades in on a soft gradient
02The askA prompt types itself out
03SendPush in as the button is pressed
04The answerThe reply streams in, line by line

2 · Read the pitch

A script and shot list, written for free. If a change isn't worth a video, it says so and charges nothing.

Raylight

to you and the launch team

Pitch ready: Just ask

4 shots, 5 seconds. Nothing is charged until you greenlight it.

Greenlight for 300 creditsSend commentsDecline

Open on the prompt bar, not the logo
Pitch v2 readyFree
Greenlit by MayaIn production

3 · Greenlight it, or send comments

Greenlight in the app, in chat, or from the signed link in Raylight's email. Your webhook can post the same link to Slack. Comments get a free new version, up to 5 rounds.

raylight.app/v/just-ask

Share linkEditable project

4 · Get the video

A share link, plus a real Raylight project you can open and keep editing.

The API

A call for every step

Send a brief, read the pitch, send comments, greenlight, decline or cancel. Every call is typed in the SDK and listed in the OpenAPI document.

Get an API key API reference

TypeScript

import { Raylight } from "@raylight/sdk";const raylight = new Raylight();const { id } = await raylight.productions.create({  brief: { intent: "Introduce the new prompt bar" },  externalId: "acme/web#512",});const { pitchMarkdown } = await raylight.productions.waitForPitch(id);await raylight.productions.comment(id, { comment: "Open on the prompt bar" });const { production: pitched } = await raylight.productions.waitForPitch(id);if (pitched.stage === "pitch_ready") {  await raylight.productions.greenlight(id, {    pitchVersion: pitched.pitch?.version,  });}const { production: done } = await raylight.productions.waitForDelivery(id);

Visibility

See every production,
call and delivery

Each production keeps a timeline of what happened and who did it. Every webhook delivery is logged and can be sent again. Analytics show requests, errors and latency for each key and route.

Productions

Just ask

acme/web #512

Wrapped

Version: v2
Length: 5s
Aspect: 16:9
Greenlight: Manual

Requested10:02
Pitch v1 ready10:04
Comments sent10:11
Pitch v2 ready10:13
Greenlit10:20
Wrapped10:31

Webhooks

Send test event

https://acme.dev/hooks/raylight

2 events · signed with whsec_••••3f9a

Active

WrappedDelivered
10:31 · 1 attempt · HTTP 200
Redeliver
GreenlitDelivered
10:20 · 1 attempt · HTTP 200
Redeliver
Pitch readyDelivered
10:13 · 2 attempts · HTTP 200
Redeliver
Pitch readyDelivered
10:04 · 1 attempt · HTTP 200
Redeliver
TestDelivered
09:58 · 1 attempt · HTTP 200
Redeliver

Analytics

Last 24 hours

Requests: 1,284
Error rate: 0.4%
p50 latency: 112 ms
p95 latency: 348 ms

GET/v1/productions/{id}964210 ms
POST/v1/productions212402 ms
POST/v1/productions/{id}/greenlight61296 ms
POST/v1/productions/{id}/comments44318 ms

Built to be trusted

Safe to put in your pipeline

Nothing reaches into your systems, every message is signed, and nothing is charged until someone greenlights it.

Push only
Raylight never calls into your tools and holds no repo, deploy or chat credentials. It works from what you send.
Signed both ways
Webhooks carry an HMAC-SHA256 signature. Greenlight links are tied to one production and one pitch version, and expire in 30 days.
Retries built in
A webhook your server misses is tried again for about seven hours, and any delivery can be sent again from the log.
Pay on greenlight
Pitches are free. Credits are charged once, when someone greenlights one, and refunded if the video can't be made.

Frequently asked questions

Ship a video
with every release.

Get an API key Read the docs

A video for every feature you ship

Works with your stack

Four steps. Only one needs you.

A call for every step

See every production, call and delivery

Safe to put in your pipeline

Push only

Signed both ways

Retries built in

Pay on greenlight