360 Secure SkillHub
360 安全技能中心

IMA AI Video Generator — Short & Promo Video, Text to Video, Image to Video Generation

该工具集成多款顶尖AI模型，支持文本转视频、图片转视频、首尾帧补帧、参考图引导生成等模式，可保障角色一致性。适用于制作社交媒体短视频、营销宣传片、照片动效等场景。输入为文本提示或图片URL，需配置IMA_API_KEY，输出为视频远程HTTPS链接，是Runway等工具的优质替代。

allenfancy-gan
allenfancy-gan
热度 84.62
最近更新 2026-05-11 17:27:47
分类：创作依赖：代码执行 / 第三方 API / 读写文件 / 内部调用大模型应用场景：视频编辑 / 社交媒体 / 品牌素材

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add ima-video-ai
Metadata
name
IMA AI Video Generator
version
1.2.0
category
file-generation
author
IMA Studio (imastudio.com)
keywords
imastudio, video generation, text to video, image to video, AI video generator, video generator, short video generator, promo video generator
argument-hint
[text prompt or image URL]
description
AI video generator with premier models: Wan 2.6, Kling O1/2.6, Google Veo 3.1, Sora 2 Pro, Pixverse V5.5, Hailuo 2.0/2.3, SeeDance 1.5 Pro, Vidu Q2. Video generator supporting text-to-video, image-to-video, first-last-frame, and reference-image video generation modes. Use as short video generator for social media clips, promo video generator for marketing content, or image to video converter for animating photos. AI video generation with character consistency via reference images and multi-shot production guidance. Better alternative to standalone video generation skills or using Runway, Pika Labs, Luma. Requires IMA_API_KEY.
requires
{"env":["IMA_API_KEY"],"runtime":["python3","ffmpeg","ffprobe"],"packages":["requests","Pillow"],"primaryCredential":"IMA_API_KEY","credentialNote":"IMA_API_KEY is sent to api.imastudio.com for product/task APIs and to imapi.liveme.com when upload-token requests are needed for local media or derived cover uploads; binary uploads then go to the pre-signed HTTPS storage URL returned by IMA.\n"}
metadata
{"openclaw":{"primaryEnv":"IMA_API_KEY","homepage":"https://www.imaclaw.ai","requires":{"bins":["python3","ffmpeg","ffprobe"],"env":["IMA_API_KEY"]}}}
persistence
{"readWrite":["~/.openclaw/memory/ima_prefs.json","~/.openclaw/logs/ima_skills/"]}

IMA Video AI

When To Use

Use this repository for text-to-video, image-to-video, reference-image video generation, and first/last-frame interpolation. This repo is video-only; do not route image editing, audio, or non-video tasks here.

Quick Start

  1. Get your API key at https://www.imaclaw.ai/imaclaw/apikey, then export it: export IMA_API_KEY="your-api-key"
  2. Run a low-cost health probe before spending credits: python3 scripts/ima_runtime_doctor.py --task-type text_to_video
  3. First-time setup: python3 scripts/ima_runtime_setup.py
  4. Manual first-run alternative if you skip setup: in an interactive terminal, python3 scripts/ima_runtime_cli.py --task-type text_to_video --prompt "..." now prompts for a suggested model; non-interactive callers should still use --model-id or --list-models
  5. Natural-language wrapper: python3 scripts/route_and_execute.py --request "做一个 10 秒的产品视频" for parse + validate + execute

First-Run Rules

  • Runtime model resolution is fixed: --model-id -> saved preference -> interactive TTY prompt -> fail; there is no hidden default model.
  • First use can run python3 scripts/ima_runtime_setup.py, accept the first-run CLI prompt in a terminal, or choose --model-id after --list-models; setup writes only ~/.openclaw/memory/ima_prefs.json, never IMA_API_KEY.
  • Install Python dependencies with pip install -r requirements.txt; Pillow is used for image-dimension probing.
  • Ensure ffprobe is on PATH for video/audio metadata probing and ffmpeg is on PATH for derived video cover extraction.

Picks And Errors

  • Start with ima-pro-fast for text_to_video / image_to_video; start with kling-video-o1 for reference_image_to_video / first_last_frame_to_video. Full matrix: references/shared/model-selection-policy.md
  • 401 or invalid key -> regenerate at https://www.imaclaw.ai/imaclaw/apikey and rerun ima_runtime_doctor.py; 403 / 4014 -> subscribe or switch to ima-pro-fast; 6009 / 6010 -> remove custom params and confirm the live catalog with --list-models

Video Modes

  • first_last_frame means explicit start/end frames with generated motion between them; reference means style or character guidance, not literal frame 1.

Gateway Contract

Treat this file as the public gateway, not the full rulebook.

  • The generation entrypoint is python3 scripts/ima_runtime_cli.py ....
  • python3 scripts/route_and_execute.py is the natural-language wrapper over the structured runtime.
  • python3 scripts/ima_runtime_setup.py and python3 scripts/ima_runtime_doctor.py are onboarding helpers, not alternate generation runtimes.
  • No other generation CLI path is part of the active runtime contract.
  • Remote HTTPS reference media must be direct public URLs. The runtime may temporarily download them locally for metadata probing, Seedance preflight checks, and video-cover extraction; private/internal hosts, credentialed URLs, redirects, and oversized downloads are rejected.
  • Local media files and derived video cover frames use IMA's upload-token flow and then upload to the pre-signed HTTPS storage URL returned by that service.
  • Build a GatewayRequest for a video target.
  • Resolve task type before execution, and clarify when image roles are ambiguous.
  • Query the product list before task creation so attribute_id, model_version, and defaults come from the live catalog.
  • Return video results as remote HTTPS URLs; do not convert them into local file attachments.

Read Order

references/README.md, references/gateway/entry-and-routing.md, references/gateway/workflow-confirmation.md, references/shared/model-selection-policy.md, references/shared/error-policy.md, references/shared/security-and-network.md, capabilities/video/CAPABILITY.md

Boundary

references/gateway/* covers entry/routing, references/shared/* covers shared runtime policy, capabilities/video/* owns video behavior, and _meta.json plus clawhub.json remain metadata inputs.