/** * ================================================================================ * DO NOT MODIFY THIS FILE. This file is READ ONLY and is DETERMINISTIC. * * Luma Labs Generative AI Service — Strict, Explicit, and Typed API * * ALL USAGE MUST SPECIFY THE MODEL PARAMETER FOR EVERY GENERATION FUNCTION. * - For images: model: 'photon-1' (REQUIRED, no default) * - For video: model: 'ray-flash-2' | 'ray-2' | 'ray-1-6' (REQUIRED, no default) * * Do not rely on defaults. Always set `model` explicitly in your input object. * ALL references (images, video) MUST use public CDN URLs. * ALL poll logic must use the provided status polling functions. * Only exported functions are public API for use; all others are private. * DO NOT alter the file or function contracts. * Any changes void determinism, auditability, and may break system contracts. * ================================================================================ */ export type AspectRatio = '1:1' | '3:4' | '4:3' | '9:16' | '16:9' | '9:21' | '21:9'; export type Resolution = '540p' | '720p' | '1080p' | '4k'; export type VideoModel = 'ray-flash-2' | 'ray-2' | 'ray-1-6'; export type ImageModel = 'photon-1'; export type LumaImageRef = { url: string; weight: number }; export type LumaStyleRef = { url: string; weight: number }; export type LumaCharacterRef = { [identity: string]: { images: string[] } }; export type LumaModifyImageRef = { url: string; weight: number }; export interface LumaImageGenRequest { prompt: string; aspect_ratio?: AspectRatio; model: ImageModel; // REQUIRED! image_ref?: LumaImageRef[]; style_ref?: LumaStyleRef[]; character_ref?: LumaCharacterRef; modify_image_ref?: LumaModifyImageRef; } export interface LumaVideoKeyframeImage { type: 'image'; url: string; } export interface LumaVideoKeyframeGeneration { type: 'generation'; id: string; } export interface LumaVideoKeyframes { frame0?: LumaVideoKeyframeImage | LumaVideoKeyframeGeneration; frame1?: LumaVideoKeyframeImage | LumaVideoKeyframeGeneration; } /** * CRITICAL: `duration` must be either "5s" or "9s" (seconds) if provided. Only these two values are allowed. */ export interface LumaVideoGenRequest { prompt: string; model: VideoModel; // REQUIRED! resolution?: Resolution; duration?: string; aspect_ratio?: AspectRatio; loop?: boolean; keyframes?: LumaVideoKeyframes; } type LumaGenState = 'queued' | 'processing' | 'dreaming' | 'completed' | 'failed'; export interface LumaImageGenResponse { id: string; type: 'image'; state: LumaGenState; failure_reason?: string | null; assets: { image?: string | null; }; detail?: any; } export interface LumaVideoGenResponse { id: string; generation_type: 'video'; state: LumaGenState; failure_reason?: string | null; assets: { video?: string | null; image?: string | null; progress_video?: string | null; }; detail?: any; } /** * Internal utility: throws if response has any error, failure, or API-side validation issue. */ function _throwIfError(res: any) { if (!res) throw new Error('No response from Luma API'); if (res.failure_reason) throw new Error(res.failure_reason); if (res.detail) throw new Error(typeof res.detail === 'string' ? res.detail : JSON.stringify(res.detail)); if (!res.id) throw new Error('Missing id in response'); } /** * Internal utility: all Luma API calls must go through this proxy, never called directly from client. */ async function _proxyLumaDreamMachine(options: { body?: any; path?: string; method?: string; }): Promise { const { body, path = '/dream-machine/v1/generations/image', method = 'POST', } = options; const headers: Record = { 'accept': 'application/json', 'authorization': 'Bearer secret_cmcaqy9df0000356ni9b1k2ro', 'content-type': 'application/json', }; const payload: any = { protocol: 'https', origin: 'api.lumalabs.ai', path, method, headers, }; if (body) payload.body = JSON.stringify(body); const res = await fetch('/api/proxy', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(payload), }); return res.json(); } /** * ================================================================================ * IMAGE GENERATION METHODS (Photon-1) — model IS REQUIRED * ================================================================================ */ /** * Generate an image from text. You MUST provide { model: 'photon-1' } in the input. */ export async function lumaImageFromText(input: LumaImageGenRequest): Promise { if (!input.model) throw new Error('model is REQUIRED for image generation ("photon-1")'); const res = await _proxyLumaDreamMachine({ body: input }); _throwIfError(res); return res; } /** * Generate an image from text, guided by up to 4 reference images. * You MUST provide { model: 'photon-1' } in the input. */ export async function lumaImageWithReferences(input: LumaImageGenRequest): Promise { if (!input.model) throw new Error('model is REQUIRED for image generation ("photon-1")'); if (!input.image_ref || input.image_ref.length === 0) throw new Error('image_ref required'); const res = await _proxyLumaDreamMachine({ body: input }); _throwIfError(res); return res; } /** * Generate an image with style reference(s). * You MUST provide { model: 'photon-1' } in the input. */ export async function lumaImageWithStyle(input: LumaImageGenRequest): Promise { if (!input.model) throw new Error('model is REQUIRED for image generation ("photon-1")'); if (!input.style_ref || input.style_ref.length === 0) throw new Error('style_ref required'); const res = await _proxyLumaDreamMachine({ body: input }); _throwIfError(res); return res; } /** * Generate an image with character consistency using character_ref. * You MUST provide { model: 'photon-1' } in the input. */ export async function lumaImageWithCharacter(input: LumaImageGenRequest): Promise { if (!input.model) throw new Error('model is REQUIRED for image generation ("photon-1")'); if (!input.character_ref) throw new Error('character_ref required'); const res = await _proxyLumaDreamMachine({ body: input }); _throwIfError(res); return res; } /** * Modify an uploaded image using a prompt and modify_image_ref. * You MUST provide { model: 'photon-1' } in the input. */ export async function lumaModifyImage(input: LumaImageGenRequest): Promise { if (!input.model) throw new Error('model is REQUIRED for image generation ("photon-1")'); if (!input.modify_image_ref) throw new Error('modify_image_ref required'); const res = await _proxyLumaDreamMachine({ body: input }); _throwIfError(res); return res; } /** * Poll for image generation status until completed or failed. * Will NOT time out until completed or failed (long polls supported). * Throws for all error states, including detail/failure_reason/invalid UUID. */ export async function lumaPollImageUrl( id: string, maxAttempts = 999999, intervalMs = 2000 ): Promise { let attempts = 0; while (true) { const res: LumaImageGenResponse = await _proxyLumaDreamMachine({ path: `/dream-machine/v1/generations/${id}`, method: 'GET', }); _throwIfError(res); if (res.state === 'completed' && res.assets?.image) return res.assets.image; if (res.state === 'failed') throw new Error(res.failure_reason || 'Luma image generation failed'); await new Promise((r) => setTimeout(r, intervalMs)); attempts++; if (attempts > maxAttempts) throw new Error('Timeout waiting for Luma image generation'); } } /** * ================================================================================ * VIDEO GENERATION METHODS (Ray) — model IS REQUIRED * ================================================================================ */ /** * Generate a video from text prompt. You MUST provide { model } in the input. * CRITICAL: `duration` must be either "5" or "9" (seconds) if provided. Only these two values are allowed. */ export async function lumaVideoFromText(input: LumaVideoGenRequest): Promise { if (!input.model) throw new Error('model is REQUIRED for video generation'); const res = await _proxyLumaDreamMachine({ body: input, path: '/dream-machine/v1/generations', method: 'POST', }); _throwIfError(res); return res; } /** * Generate video using keyframes (image/generation start and/or end). You MUST provide { model } in the input. * CRITICAL: `duration` must be either "5s" or "9s" (seconds) if provided. Only these two values are allowed. */ export async function lumaVideoWithKeyframes(input: LumaVideoGenRequest): Promise { if (!input.model) throw new Error('model is REQUIRED for video generation'); if (!input.keyframes || !input.keyframes.frame0) throw new Error('At least keyframes.frame0 required'); const res = await _proxyLumaDreamMachine({ body: input, path: '/dream-machine/v1/generations', method: 'POST', }); _throwIfError(res); return res; } /** * Extend a video by using a previous generation id as a keyframe. * You MUST provide { model } in the input. * CRITICAL: `duration` must be either "5s" or "9s" (seconds) if provided. Only these two values are allowed. */ export async function lumaExtendVideo(input: LumaVideoGenRequest): Promise { if (!input.model) throw new Error('model is REQUIRED for video generation'); if (!input.keyframes?.frame0 || (input.keyframes.frame0 as any).type !== 'generation') { throw new Error('keyframes.frame0 with type generation required'); } const res = await _proxyLumaDreamMachine({ body: input, path: '/dream-machine/v1/generations', method: 'POST', }); _throwIfError(res); return res; } /** * Poll for video generation status until completed or failed. * Will NOT time out until completed or failed (long polls supported). * Throws for all error states, including detail/failure_reason/invalid UUID. */ export async function lumaPollVideoUrl( id: string, maxAttempts = 999999, intervalMs = 4000 ): Promise { let attempts = 0; while (true) { const res: LumaVideoGenResponse = await _proxyLumaDreamMachine({ path: `/dream-machine/v1/generations/${id}`, method: 'GET', }); _throwIfError(res); if (res.state === 'completed' && res.assets?.video) return res.assets.video; if (res.state === 'failed') throw new Error(res.failure_reason || 'Luma video generation failed'); await new Promise((r) => setTimeout(r, intervalMs)); attempts++; if (attempts > maxAttempts) throw new Error('Timeout waiting for Luma video generation'); } }

AI Video Generator