{"id":"699a2d35-147f-41f3-9c80-b2efeeb5f8b0","slug":"luma-api-mcp","kind":"mcp","name":"luma-api-mcp","summary":"Powered by Ray (video) and Photon (image) models by Luma AI","owner":"lumalabs","repoUrl":"https://github.com/lumalabs/luma-api-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":26,"match":null,"fewStars":false,"format":"mcp","createdAt":"2025-04-15T01:27:03.000Z","addedAt":"2026-10-14T05:02:47.366Z","logoUrl":"https://avatars.githubusercontent.com/u/85601507?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["design-media","cloud-infra","memory-knowledge"],"tags":["api","genai","image","luma","lumaai","photon","python","ray"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-17T08:55:47.626Z","sample":false,"url":"https://conduits.dev/tools/luma-api-mcp","language":"Python","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Luma API MCP\n\n## Setup\n\n1. Install Claude Desktop App or any MCP client\n2. Get API Key from https://lumalabs.ai/api/keys\n3. Run `sh setup.sh`, here it will ask the API Key - paste it from 2.\n\n## Run\n\nOpen Claude Desktop or any MCP client\n\n## Features\n\n### Create Image\n\n-   `prompt`: text\n-   `aspect_ratio`: \"1:1\", \"16:9\", \"9:16\", \"4:3\", \"3:4\", \"21:9\", \"9:21\" (default: \"16:9\")\n-   `model`: \"photon-1\", \"photon-flash-1\" (default: \"photon-1\")\n-   `image_ref`: list of image URLs with weights to influence generation (optional), max 8\n-   `style_ref`: single image URL with weight to influence style (optional), max 1\n-   `character_ref`: list of character image URLs (optional), max 4\n-   `modify_image_ref`: single image URL to modify with weight (optional), max 1\n\n### Create Video\n\n-   `prompt`: text\n-   `aspect_ratio`: \"1:1\", \"16:9\", \"9:16\", \"4:3\", \"3:4\", \"21:9\", \"9:21\" (default: \"16:9\")\n-   `model`: \"ray-2\", \"ray-flash-2\", \"ray-1-6\" (default: \"ray-2\")\n-   `loop`: boolean (default: false)\n-   `resolution`: \"540p\", \"720p\", \"1080p\", \"4k\" (default: \"720p\")\n-   `duration`: \"5s\", \"9s\" (default: \"5s\")\n-   `frame0_image`: image URL (optional)\n-   `frame1_image`: image URL (optional)\n-   `frame0_id`: generation ID (optional)\n-   `frame1_id`: generation ID (optional)\n\n## Technical Notes\n- Keyframes: Providing frame0_image/frame1_image gives more control over video start/end points\n- Video Response Time: Typical video generation takes 15-60 seconds depending on duration and resolution\n- Image Response Time: Typical generation takes 5-15 seconds depending on model complexity\n"}