Remakes

Start a remake

Start a remake of your own video: Raylight makes a blank project (one empty shot at the source's nearest aspect ratio and frame rate) in your personal workspace's Remakes folder and answers with the remake. The project is held from the moment it exists: only the builder tab and your CLI's uploads may change it until the remake ends. rightsAttested must be true: you confirm you own the video or have the right to use it, and the answer is stored with the remake. Free; one remake runs at a time, five a day, sources up to 3 minutes and within your plan's video limits. npx raylight video-to-project <video> does all of this for you.

POST/v1/remakes

API key with the remake scope.

Request body

application/json

Field	Type	Description
`fileName`required	string
`bytes`required	integer
`durationMs`required	integer
`width`required	integer
`height`required	integer
`fps`required	number
`sha256`required	string
`mime`	enum	One of: `video/mp4`, `video/quicktime`, `video/webm`
`rightsAttested`required	enum
`agent`required	enum	One of: `claude`, `codex`
`cliVersion`required	string

Responses

201The new remake.

400Invalid request.

401Missing, invalid or revoked key.

403The key lacks the scope, or the key's owner has view-only access to the workspace (code forbidden).

404Not found.

409Another remake of yours is still running (code remake_running).

429Rate limited, or a monthly cap reached.

201 response body

Field	Type	Description
`remake`required	object
`remake.id`required	uuid
`remake.status`required	enum	The furthest stage reached: studying (the study runs on your machine), building (shots land in the project as they are built; overlaps studying), polishing (the film-wide pass), needs_repair (the CLI is running the repair session), then done, failed or canceled. New values may be added; treat unknown ones as opaque.One of: `studying`, `building`, `polishing`, `needs_repair`, `done`, `failed`, `canceled`
`remake.projectId`required	uuid \| null
`remake.projectUrl`required	url \| null
`remake.shots`required	object[]
`remake.shots[].index`required	integer
`remake.shots[].startMs`required	number
`remake.shots[].durationMs`required	number
`remake.shots[].state`required	enum	One of: `skeleton`, `building`, `built`, `failed`
`remake.repair`required	object \| null
`remake.repair.requested`required	boolean
`remake.repair.uncovered`required	object[]
`remake.repair.uncovered[].segmentId`required	string
`remake.repair.uncovered[].firstMs`required	number
`remake.repair.uncovered[].lastMs`required	number
`remake.repair.uncovered[].box`required	object
`remake.repair.uncovered[].box.x`required	number
`remake.repair.uncovered[].box.y`required	number
`remake.repair.uncovered[].box.w`required	number
`remake.repair.uncovered[].box.h`required	number
`remake.repair.uncovered[].samples`required	integer
`remake.report`required	object \| null
`remake.report.glitches`required	any[]
`remake.report.gaps`required	any[]
`remake.report.notes`required	string[]
`remake.error`required	string \| null
`remake.errorCode`required	enum \| null	One of: `cli_stopped`, `tab_lost`, `study_error`, `build_error`
`remake.libraryEligible`required	boolean	Whether this remake (the video, the study and the plan applied) may feed Raylight's motion library. False once the owner or the workspace turns data sharing off (Settings, Improve Raylight); that switch is the only opt-out.
`remake.source`required	object
`remake.source.fileName`required	string
`remake.source.durationMs`required	integer
`remake.source.width`required	integer
`remake.source.height`required	integer
`remake.source.fps`required	number
`remake.agent`required	enum	One of: `claude`, `codex`
`remake.builder`required	object
`remake.builder.attached`required	boolean
`remake.builder.lastSeenAt`required	string \| null
`remake.createdAt`required	string
`remake.updatedAt`required	string

Example

curl

curl -X POST https://api.raylight.app/v1/remakes \  -H "Authorization: Bearer $RAYLIGHT_API_KEY" \  -H "Content-Type: application/json" \  -d '{  "fileName": "<fileName>",  "bytes": 1,  "durationMs": 1,  "width": 1,  "height": 1,  "fps": 1,  "sha256": "<sha256>",  "rightsAttested": true,  "agent": "claude",  "cliVersion": "<cliVersion>"}'