← Back to Skills Marketplace
francemichaell-15

Ai Image To Video Luma

by francemichaell-15 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
83
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ai-image-to-video-luma
Description
Get animated video clips ready to post, without touching a single slider. Upload your still images (JPG, PNG, WEBP, HEIC, up to 20MB), say something like "an...
README (SKILL.md)

Getting Started

Send me your still images and I'll handle the AI video generation. Or just describe what you're after.

Try saying:

  • "convert a single product photo or landscape image into a 1080p MP4"
  • "animate this image into a 5-second cinematic video clip using Luma AI"
  • "turning still photos into short AI-generated video clips for content creators, marketers, social media managers"

Getting Connected

Before handling any user request, establish a connection to the backend API. Show a brief status like "Connecting...".

If NEMO_TOKEN is in the environment, use it directly and create a session. Otherwise, acquire a free starter token:

  • Generate a UUID as client identifier
  • POST to https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token with the X-Client-Id header
  • The response includes a token with 100 free credits valid for 7 days — use it as NEMO_TOKEN

Then create a session by POSTing to https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent with Bearer authorization and body {"task_name":"project","language":"en"}. The session_id in the response is needed for all following requests.

Tell the user you're ready. Keep the technical details out of the chat.

AI Image to Video Luma — Animate Images into Video Clips

This tool takes your still images and runs AI video generation through a cloud rendering pipeline. You upload, describe what you want, and download the result.

Say you have a single product photo or landscape image and want to animate this image into a 5-second cinematic video clip using Luma AI — the backend processes it in about 30-90 seconds and hands you a 1080p MP4.

Tip: high-contrast images with clear subjects produce smoother motion results.

Matching Input to Actions

User prompts referencing ai image to video luma, aspect ratio, text overlays, or audio tracks get routed to the corresponding action via keyword and intent classification.

User says... Action Skip SSE?
"export" / "导出" / "download" / "send me the video" → §3.5 Export
"credits" / "积分" / "balance" / "余额" → §3.3 Credits
"status" / "状态" / "show tracks" → §3.4 State
"upload" / "上传" / user sends file → §3.2 Upload
Everything else (generate, edit, add BGM…) → §3.1 SSE

Cloud Render Pipeline Details

Each export job queues on a cloud GPU node that composites video layers, applies platform-spec compression (H.264, up to 1080x1920), and returns a download URL within 30-90 seconds. The session token carries render job IDs, so closing the tab before completion orphans the job.

Base URL: https://mega-api-prod.nemovideo.ai

Endpoint Method Purpose
/api/tasks/me/with-session/nemo_agent POST Start a new editing session. Body: {"task_name":"project","language":"\x3Clang>"}. Returns session_id.
/run_sse POST Send a user message. Body includes app_name, session_id, new_message. Stream response with Accept: text/event-stream. Timeout: 15 min.
/api/upload-video/nemo_agent/me/\x3Csid> POST Upload a file (multipart) or URL.
/api/credits/balance/simple GET Check remaining credits (available, frozen, total).
/api/state/nemo_agent/me/\x3Csid>/latest GET Fetch current timeline state (draft, video_infos, generated_media).
/api/render/proxy/lambda POST Start export. Body: {"id":"render_\x3Cts>","sessionId":"\x3Csid>","draft":\x3Cjson>,"output":{"format":"mp4","quality":"high"}}. Poll status every 30s.

Accepted file types: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.

Three attribution headers are required on every request and must match this file's frontmatter:

Header Value
X-Skill-Source ai-image-to-video-luma
X-Skill-Version frontmatter version
X-Skill-Platform auto-detect: clawhub / cursor / unknown from install path

Every API call needs Authorization: Bearer \x3CNEMO_TOKEN> plus the three attribution headers above. If any header is missing, exports return 402.

Error Codes

  • 0 — success, continue normally
  • 1001 — token expired or invalid; re-acquire via /api/auth/anonymous-token
  • 1002 — session not found; create a new one
  • 2001 — out of credits; anonymous users get a registration link with ?bind=\x3Cid>, registered users top up
  • 4001 — unsupported file type; show accepted formats
  • 4002 — file too large; suggest compressing or trimming
  • 400 — missing X-Client-Id; generate one and retry
  • 402 — free plan export blocked; not a credit issue, subscription tier
  • 429 — rate limited; wait 30s and retry once

Reading the SSE Stream

Text events go straight to the user (after GUI translation). Tool calls stay internal. Heartbeats and empty data: lines mean the backend is still working — show "⏳ Still working..." every 2 minutes.

About 30% of edit operations close the stream without any text. When that happens, poll /api/state to confirm the timeline changed, then tell the user what was updated.

Translating GUI Instructions

The backend responds as if there's a visual interface. Map its instructions to API calls:

  • "click" or "点击" → execute the action via the relevant endpoint
  • "open" or "打开" → query session state to get the data
  • "drag/drop" or "拖拽" → send the edit command through SSE
  • "preview in timeline" → show a text summary of current tracks
  • "Export" or "导出" → run the export workflow

Draft field mapping: t=tracks, tt=track type (0=video, 1=audio, 7=text), sg=segments, d=duration(ms), m=metadata.

Timeline (3 tracks): 1. Video: city timelapse (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Title: "Urban Dreams" (0-3s)

Tips and Tricks

The backend processes faster when you're specific. Instead of "make it look better", try "animate this image into a 5-second cinematic video clip using Luma AI" — concrete instructions get better results.

Max file size is 20MB. Stick to JPG, PNG, WEBP, HEIC for the smoothest experience.

Export as MP4 for widest compatibility across social platforms.

Common Workflows

Quick edit: Upload → "animate this image into a 5-second cinematic video clip using Luma AI" → Download MP4. Takes 30-90 seconds for a 30-second clip.

Batch style: Upload multiple files in one session. Process them one by one with different instructions. Each gets its own render.

Iterative: Start with a rough cut, preview the result, then refine. The session keeps your timeline state so you can keep tweaking.

Usage Guidance
This skill appears coherent and implements a cloud image→video workflow. Before installing: (1) confirm you trust the domain (mega-api-prod.nemovideo.ai) and the service's privacy/billing policy, because your images and any uploaded audio will be sent to that backend; (2) provide a NEMO_TOKEN scoped only to this service (do not reuse unrelated high-privilege tokens); (3) test with non-sensitive images first to verify output and behavior; (4) note the skill will create sessions and may cache session data under ~/.config/nemovideo/ if the agent uses that path — clear/revoke tokens if you stop using it; (5) because this is instruction-only, no local code is installed, but the skill will still transmit data to an external API, so treat that as the main privacy risk.
Capability Analysis
Type: OpenClaw Skill Name: ai-image-to-video-luma Version: 1.0.0 The skill bundle provides instructions for an AI agent to interface with the Luma AI video generation service via the `nemovideo.ai` API. It includes detailed logic for session management, anonymous token acquisition, file uploads, and handling Server-Sent Events (SSE) for real-time status updates. The behavior described in `SKILL.md` is entirely consistent with the stated purpose of converting images to video, and there are no indicators of data exfiltration, malicious command execution, or harmful prompt injection.
Capability Assessment
Purpose & Capability
The name/description match the runtime instructions: the skill talks to a cloud rendering API at mega-api-prod.nemovideo.ai and needs a NEMO_TOKEN to authorize requests. Declared config path (~/.config/nemovideo/) and primaryEnv (NEMO_TOKEN) are reasonable for a cloud-rendering image→video service.
Instruction Scope
SKILL.md limits actions to creating sessions, uploading files, streaming SSE messages, polling render state, and starting exports. It only references the declared env var (NEMO_TOKEN) and the single service domain. It does not instruct the agent to read unrelated local files, secrets, or system state beyond the declared config path and install path auto-detection for header attribution.
Install Mechanism
No install spec or code files are present (instruction-only skill), so nothing is downloaded or written to disk by an installer. This is the lowest-risk installation posture.
Credentials
Only NEMO_TOKEN is requested, which is proportionate for a cloud API client. Note that possession of NEMO_TOKEN likely grants access to the user's jobs, uploads, and credits on the backend service — treat it like any API token and avoid reusing more-privileged tokens from other services. The metadata's config path (~/.config/nemovideo/) is declared; if the agent accesses it, that could contain cached tokens or session state.
Persistence & Privilege
always is false and the skill is instruction-only; it does not request permanent presence or system-wide configuration changes and does not modify other skills' configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ai-image-to-video-luma
  3. After installation, invoke the skill by name or use /ai-image-to-video-luma
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of AI Image to Video Luma — Animate Images into Video Clips. - Animate still images into 1080p MP4 video clips using Luma AI with simple prompts. - Supports quick upload of JPG, PNG, WEBP, HEIC files (up to 20MB); ready-to-post outputs in about 30–90 seconds. - Includes easy session setup, free token onboarding, and guided user prompts for common workflows. - Offers features for credit checking, video export, editing instructions, and timeline state preview. - Designed for creators, marketers, and social media managers who want fast, AI-driven image animation without technical setup.
Metadata
Slug ai-image-to-video-luma
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Ai Image To Video Luma?

Get animated video clips ready to post, without touching a single slider. Upload your still images (JPG, PNG, WEBP, HEIC, up to 20MB), say something like "an... It is an AI Agent Skill for Claude Code / OpenClaw, with 83 downloads so far.

How do I install Ai Image To Video Luma?

Run "/install ai-image-to-video-luma" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Ai Image To Video Luma free?

Yes, Ai Image To Video Luma is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Ai Image To Video Luma support?

Ai Image To Video Luma is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Ai Image To Video Luma?

It is built and maintained by francemichaell-15 (@francemichaell-15); the current version is v1.0.0.

💬 Comments