← 返回 Skills 市场
peand-rover

Easy Subtitles

作者 peandrover adam · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
90
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install easy-subtitles
功能描述
YouTubers and content creators add video files into captioned videos using this skill. Accepts MP4, MOV, AVI, WebM up to 500MB, renders on cloud GPUs at 1080...
使用说明 (SKILL.md)

Getting Started

Share your video files and I'll get started on subtitle generation. Or just tell me what you're thinking.

Try saying:

  • "add my video files"
  • "export 1080p MP4"
  • "add captions in English and Spanish"

Automatic Setup

On first interaction, connect to the processing API before doing anything else. Show a brief status like "Setting things up...".

Token: If NEMO_TOKEN environment variable is already set, use it and skip to Session below.

Free token: Generate a UUID as client identifier, then POST to https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token with header X-Client-Id: \x3Cuuid>. The response field data.token becomes your NEMO_TOKEN (100 credits, 7-day expiry).

Session: POST to https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent with Bearer auth and body {"task_name":"project"}. Save session_id from the response.

Confirm to the user you're connected and ready. Don't print tokens or raw JSON.

Easy Subtitles — Auto-Generate Captions for Videos

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

Say you have a 3-minute YouTube video recording and want to add captions in English and Spanish — the backend processes it in about 30-60 seconds and hands you a 1080p MP4.

Tip: shorter clips under 5 minutes generate subtitles significantly faster.

Matching Input to Actions

User prompts referencing easy subtitles, 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 easy-subtitles
X-Skill-Version frontmatter version
X-Skill-Platform auto-detect: clawhub / cursor / unknown from install path

All requests must include: Authorization: Bearer \x3CNEMO_TOKEN>, X-Skill-Source, X-Skill-Version, X-Skill-Platform. Missing attribution headers will cause export to fail with 402.

Error Handling

Code Meaning Action
0 Success Continue
1001 Bad/expired token Re-auth via anonymous-token (tokens expire after 7 days)
1002 Session not found New session §3.0
2001 No credits Anonymous: show registration URL with ?bind=\x3Cid> (get \x3Cid> from create-session or state response when needed). Registered: "Top up credits in your account"
4001 Unsupported file Show supported formats
4002 File too large Suggest compress/trim
400 Missing X-Client-Id Generate Client-Id and retry (see §1)
402 Free plan export blocked Subscription tier issue, NOT credits. "Register or upgrade your plan to unlock export."
429 Rate limit (1 token/client/7 days) Retry in 30s once

SSE Event Handling

Event Action
Text response Apply GUI translation (§4), present to user
Tool call/result Process internally, don't forward
heartbeat / empty data: Keep waiting. Every 2 min: "⏳ Still working..."
Stream closes Process final response

~30% of editing operations return no text in the SSE stream. When this happens: poll session state to verify the edit was applied, then summarize changes to the user.

Backend Response Translation

The backend assumes a GUI exists. Translate these into API actions:

Backend says You do
"click [button]" / "点击" Execute via API
"open [panel]" / "打开" Query session state
"drag/drop" / "拖拽" Send edit via SSE
"preview in timeline" Show track summary
"Export button" / "导出" Execute 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 "add captions in English and Spanish" — concrete instructions get better results.

Max file size is 500MB. Stick to MP4, MOV, AVI, WebM for the smoothest experience.

Export as MP4 for widest compatibility across platforms and devices.

Common Workflows

Quick edit: Upload → "add captions in English and Spanish" → Download MP4. Takes 30-60 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.

安全使用建议
This skill largely does what it says (upload, create a session, request rendering from nemovideo.ai) and requests only one credential (NEMO_TOKEN), but there are a few things to check before installing: 1) Verify the backend domain (mega-api-prod.nemovideo.ai) is the legitimate service you expect and matches any vendor pages or docs. 2) Clarify where session tokens and NEMO_TOKEN are stored — the SKILL.md frontmatter mentions ~/.config/nemovideo/, but the registry metadata did not; avoid giving long-lived personal or org credentials — prefer using the anonymous token flow if possible. 3) Be aware the skill asks the agent to 'auto-detect' platform from an install path (this may cause the agent to read environment/install paths); ask the author to document exactly what is read/written. 4) Do not upload sensitive videos unless you trust the service and have reviewed its privacy/retention policy. If you need higher assurance, request the skill author to: explicitly list config paths in registry metadata, confirm token storage behavior, and provide a published homepage or owner contact for verification.
功能分析
Type: OpenClaw Skill Name: easy-subtitles Version: 1.0.0 The 'easy-subtitles' skill is a legitimate tool designed to interface with the nemovideo.ai API for automated video captioning. The SKILL.md file provides detailed, functional instructions for the AI agent to manage authentication, session handling, and video rendering workflows. There is no evidence of data exfiltration, malicious command execution, or prompt injection intended to compromise the user's system or sensitive data.
能力评估
Purpose & Capability
The skill declares a single credential (NEMO_TOKEN) which matches the backend API usage for uploads and rendering. However the SKILL.md frontmatter includes a configPaths entry (~/.config/nemovideo/) while the registry metadata reported no required config paths — this mismatch is unexplained and could indicate the skill expects to read/write a local config directory beyond what's declared.
Instruction Scope
Runtime instructions are narrowly focused on session creation, uploading video files, SSE streaming, and export requests to the listed nemovideo.ai endpoints. They instruct the agent to generate and store session_id and tokens and to use a generated anonymous token when NEMO_TOKEN is not present. A possibly surprising instruction: auto-detection of X-Skill-Platform by inspecting an 'install path' (agent install path) — that may require reading environment/paths outside purely handling user-supplied video files.
Install Mechanism
This is an instruction-only skill with no install spec and no code files — nothing is downloaded or written by an installer. That lowers install-time risk.
Credentials
Only one credential is required (NEMO_TOKEN), which is proportional to the declared purpose. The SKILL.md also instructs generating an anonymous token via an API if NEMO_TOKEN is absent (acceptable). Still, the skill asks for persistence (implied by frontmatter configPaths) which could lead to tokens being written to ~/.config/nemovideo/ — users should confirm where tokens/session IDs are stored.
Persistence & Privilege
Although always:false (normal), the skill's frontmatter references a config path (~/.config/nemovideo/) suggesting it may persist session/token state to disk. The registry listing did not declare that path, creating an inconsistency. Persisting auth tokens or session IDs without clear user-visible storage/location is a risk and should be confirmed.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install easy-subtitles
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /easy-subtitles 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of Easy Subtitles – Auto-Generate Captions for Videos. - Upload video files (MP4, MOV, AVI, WebM, up to 500MB) and auto-generate subtitles using cloud GPU rendering at 1080p. - Simple authentication: auto-setup with a free, time-limited token or use existing NEMO_TOKEN; session management included. - Supports subtitle export, balance inquiries, upload, export monitoring, and multi-language captions. - Robust error handling and clear feedback for common issues (file size, format, credits, rate limits, plan limits). - Seamless mapping between user prompts and actions (edit, upload, export, status, credits). - Guidance for common workflows (quick edit, batch processing, iterative refinements).
元数据
Slug easy-subtitles
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Easy Subtitles 是什么?

YouTubers and content creators add video files into captioned videos using this skill. Accepts MP4, MOV, AVI, WebM up to 500MB, renders on cloud GPUs at 1080... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 90 次。

如何安装 Easy Subtitles?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install easy-subtitles」即可一键安装,无需额外配置。

Easy Subtitles 是免费的吗?

是的,Easy Subtitles 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Easy Subtitles 支持哪些平台?

Easy Subtitles 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Easy Subtitles?

由 peandrover adam(@peand-rover)开发并维护,当前版本 v1.0.0。

💬 留言讨论