convez.ai
MCP ServerEscrita & ConteúdoIntermediário
HiAPIAI

HiAPI Seedance 2.0 - Geração de Vídeo para Agents

HiAPIAI/hiapi-seedance-2-0-video-skill

Text-to-video e image-to-video para agents IA com Seedance 2.0

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill de geração de vídeo baseada em texto ou imagem para agentes IA compatíveis com OpenAI API. Integra o Seedance 2.0 via HiAPI, permitindo que agents Claude Code, Codex e Cursor criem vídeos com alta qualidade a partir de prompts textuais ou animar imagens existentes.

Instalação

$npx convez-ai HiAPIAI/hiapi-seedance-2-0-video-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 1 dia
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Gerar vídeos promocionais a partir de descrições textuais
  • Animar imagens estáticas em sequências de vídeo
  • Criar conteúdo visual para marketing e comunicação
  • Automação de pipelines de produção de vídeo em agents

Veredito

Skill bem estruturada para agentes que precisam gerar vídeos programaticamente. Boa integração com o ecossistema HiAPI e suporte multi-agent, mas requer chave API externa e conhecimento técnico de configuração.

README

A tradução para o português deste README ainda está na fila.

Seedance 2.0 Video Generation Skill

Add Seedance 2.0 video generation to your AI Agent.

Seedance 2.0 • Install • API Key • HiAPI

Get API Key · Pricing · HiAPI Docs · All HiAPI Skills · Remote MCP

Languages: English | 简体中文

HiAPI Matrix: 🎨 Image Prompts · 🎬 Video Prompts · 🛠️ Agent Skills (you are here) · 🤖 Remote MCP · 📖 API Docs


AI Agent? Skip the README and read llms-install.md. It contains installation steps and error-handling rules written for agents.


What Is This?

An AI video generation skill for OpenClaw / Claude Code / OpenCode / Codex-style agents. After installation, your AI Agent can use Seedance 2.0 through HiAPI to generate videos from text or animate an image.

HiAPI is an AI API platform built for developers: one API, all AI models. Images, video, music, and text with one key.

SkillDescriptionModel
HiAPI Seedance 2.0 VideoText-to-video and image-to-videoSeedance 2.0

Where This Fits

Use this skill when the user needs a stronger video workflow, especially text-to-video plus image-to-video. If the user needs a fast lightweight text-to-video draft, route them to hiapi-happyhorse-1-0-video-skill. If their brief is one or two sentences and they need a directed, scene-by-scene prompt before generating, run it through hiapi-video-prompt-generator-skill first. If they need a still-image starting point before animation, use awesome-gpt-image-2-prompts. For broader agent discovery, use hiapi-skills or Remote MCP at https://mcp.hiapi.ai/mcp.


Install

One Command (Recommended)

npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -y

The installer auto-detects Codex (~/.codex/skills) and Claude Code (~/.claude/skills). If both exist, the -y flag installs to both. To target a specific agent or directory:

npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --codex          # ~/.codex/skills only
npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --claude         # ~/.claude/skills only
npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --target=/path   # custom directory
AGENT_SKILLS_DIR=/path npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -y

The script also reports whether HIAPI_API_KEY is set and links to where to create one.

OpenClaw

openclaw skills add https://github.com/HiAPIAI/hiapi-seedance-2-0-video-skill

Manual Install (Any Agent)

git clone https://github.com/HiAPIAI/hiapi-seedance-2-0-video-skill.git
export AGENT_SKILLS_DIR="/path/to/your/agent/skills"
mkdir -p "$AGENT_SKILLS_DIR"
cp -R hiapi-seedance-2-0-video-skill "$AGENT_SKILLS_DIR/hiapi-seedance-2-0-video"

Replace AGENT_SKILLS_DIR with your agent's skill directory.

Agent Auto-Install Prompt

Install the HiAPI Seedance 2.0 video generation skill:

1. Run: npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -y
   (auto-detects Codex / Claude Code skill directories)
2. Set the HIAPI_API_KEY environment variable from https://www.hiapi.ai/en/dashboard/api-keys
3. Read SKILL.md for usage

Get API Key

  1. Open Get API Key
  2. Sign in or create a HiAPI account
  3. Create a new API Key
  4. Set the environment variable in the terminal that runs your agent:
export HIAPI_API_KEY="your_hiapi_api_key_here"
export HIAPI_BASE_URL="https://api.hiapi.ai"

Check configuration:

node scripts/check-config.mjs

Live check:

node scripts/check-config.mjs --live

Seedance 2.0 Video Generation

Ask your AI Agent to generate a video with natural language. If you provide an image, Seedance 2.0 can use it as the starting frame and turn it into motion.

Features

  • Text-to-video: describe a scene, camera movement, mood, and sound atmosphere
  • Image-to-video: provide a public image URL or data URI and describe how it should move
  • Durations: any integer from 4 to 15 seconds
  • Resolutions: 480p, 720p, 1080p
  • Ratios: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive
  • Media modes: text-to-video, first-frame image-to-video, first+last-frame image-to-video, or multimodal references
  • Generated audio is on by default (API default); pass --no-audio to disable, --generate-audio to force on
  • Reproducible output: pass --seed <0-2147483647>
  • Local output: videos are saved to outputs/ when the result can be downloaded
  • URL output: if the video cannot be downloaded, the Agent returns the remote video URL
  • Clear errors: missing Key, invalid Key, insufficient balance, invalid image URL, task timeout, and task failure all include a next step

Examples

Talk directly to your AI Agent:

Use $hiapi-seedance-2-0-video to generate a 5-second cinematic ocean cliff video.

Use HiAPI Seedance 2.0 to create a vertical product teaser video, 9:16 style.

Animate this product photo with soft camera movement and studio lighting.

CLI Script

Text-to-video:

node scripts/hiapi-seedance-2-video.mjs \
  --prompt "A cinematic shot of ocean waves crashing against cliffs at golden hour" \
  --seconds 5 \
  --resolution 720p \
  --ratio 16:9

Image-to-video:

node scripts/hiapi-seedance-2-video.mjs \
  --prompt "The product photo comes alive with soft camera movement and studio lighting" \
  --first-frame-url "https://example.com/product.jpg" \
  --seconds 5

First+last-frame image-to-video:

node scripts/hiapi-seedance-2-video.mjs \
  --prompt "Animate from the first frame to the final hero frame" \
  --first-frame-url "asset://first-frame" \
  --last-frame-url "asset://last-frame" \
  --seconds 5

With generated audio:

node scripts/hiapi-seedance-2-video.mjs \
  --prompt "A coffee shop scene with natural background ambience" \
  --seconds 5 \
  --generate-audio

Multimodal reference mode:

node scripts/hiapi-seedance-2-video.mjs \
  --prompt "Use the reference images, video motion, and audio mood to create a product spot" \
  --reference-image-url "asset://image-1" \
  --reference-video-url "asset://video-1" \
  --reference-video-duration 6 \
  --reference-audio-url "asset://audio-1" \
  --reference-audio-duration 5 \
  --seconds 5

Media modes are mutually exclusive: first-frame image-to-video, first+last-frame image-to-video, and multimodal reference mode cannot be mixed in one request. If you need strict first and last frames, use first+last-frame mode. If you need references plus a start/end idea, describe which reference should act as the first or last frame in the prompt.

Reference material limits:

  • reference_image_urls plus first/last-frame images: at most 9 images total.
  • reference_video_urls: at most 3 videos; each 2-15 seconds; total duration at most 15 seconds.
  • reference_audio_urls: at most 3 audio clips; each 2-15 seconds; total duration at most 15 seconds.

File Structure

.
├── README.md
├── README.zh-CN.md
├── SKILL.md
├── agents/
│   └── openai.yaml
├── references/
│   ├── api.md
│   └── output.md
├── scripts/
│   ├── check-config.mjs
│   ├── hiapi-seedance-2-video.mjs
│   └── lib/
│       └── seedance-2-video.mjs
├── tests/
│   └── seedance-2-video.test.mjs
└── llms-install.md

FAQ

ProblemSolution
HIAPI_API_KEY is requiredCreate a Key at Get API Key, then set HIAPI_API_KEY.
401 UnauthorizedCheck whether the API Key is correct, or generate a new Key.
402 Payment Required / 403 quota / insufficient balanceOpen the HiAPI Dashboard and check your account status.
400 Bad RequestCheck duration, resolution, ratio, media mode, reference counts, and reference audio/video durations.
429 Too Many RequestsWait and retry, or reduce concurrent generation requests.
Task timed outThe video may still be running. Try again later or create a shorter video.
Task failedTry a clearer prompt or a different image.
No video outputCheck the task response; this skill expects a video URL after the task succeeds.
Skill update availableThe CLI checks the HiAPI skills index at startup. If the update is optional, it prints the upgrade command and continues.
Skill update requiredThe CLI stops and prints the required upgrade command. Run npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -y, then restart your agent.

Set HIAPI_SKIP_UPDATE_CHECK=1 only for offline or locked-down environments where the skills index cannot be reached.


Compatibility

AgentInstall Method
Codexnpx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --codex
Claude Codenpx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --claude
OpenClawopenclaw skills add https://github.com/HiAPIAI/hiapi-seedance-2-0-video-skill
OpenCodeAGENT_SKILLS_DIR=~/.opencode/skills npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -y
Cursor / othernpx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill --target=/your/skills/dir

License

MIT


HiAPI — One API, all AI models

Ver o original no GitHub

Bom para

Relacionados