seedance-2-prompt

name	seedance-2-prompt
description	Render a single 3-15s video clip via Seedance 2.0. Supports two backends: OpenRouter (default, model bytedance/seedance-2.0) and the official Volcengine ARK / BytePlus ModelArk endpoint (model doubao-seedance-2-0-260128 / dreamina-seedance-2-0-260128). Accepts a structured English video prompt, optional first-frame image, and optional identity/style reference image. Trigger when the user asks for AI video clip generation, 分镜视频, seedance, or wants a short cinematic shot from a prompt + frame.
description_zh	通过Seedance 2.0渲染单个3-15秒视频片段。支持两种后端：OpenRouter（默认，模型 bytedance/seedance-2.0）和官方火山引擎ARK / BytePlus ModelArk端点（模型 doubao-seedance-2-0-260128 / dreamina-seedance-2-0-260128）。接受结构化英文视频提示词、可选首帧图像和可选身份/风格参考图。当用户需要AI视频片段生成、分镜视频、seedance，或想根据提示词+画面生成短电影镜头时触发。
provenance	{"origin":"clawhub-mit0","license":"MIT-0","upstream_url":"https://clawhub.ai/dandysuper/seedance-2-prompt-engineering-skill","upstream_version":"2.0.0","maintained_by":"OpenStarry Code","modifications":"Added scripts/generate_video.py with dual-provider support: OpenRouter async /videos API and Volcengine ARK / BytePlus ModelArk /contents/generations/tasks. References kept from upstream."}
metadata	{"openstarry-code":{"risk":"medium","capabilities":["network-read","filesystem-write"],"requires":{"bins":"[Truncated]","anyBins":"[Truncated]","envAny":"[Truncated]"}}}
entrypoint	{"command":"python {baseDir}/scripts/generate_video.py","args":["--prompt","{{ with.prompt }}","--filename","{{ with.filename }}","--provider","{{ with.provider | default('openrouter') }}","--aspect-ratio","{{ with.aspect_ratio | default('9:16') }}","--duration","{{ with.duration | default(5) }}","--resolution","{{ with.resolution | default('720p') }}","--model","{{ with.model | default('') }}","--input-image","{{ with.input_image | default('') }}","--input-reference","{{ with.input_reference | default('') }}","--input-reference","{{ with.input_reference_2 | default('') }}","--max-retries","{{ with.max_retries | default(0) }}"],"parse":"text","timeout":1500}

seedance-2-prompt — Seedance 2.0 video clip generator (dual backend)

Submits a Seedance 2.0 generation job and downloads the resulting MP4. Two backends share one CLI, picked via with.provider:

with.provider	Endpoint	Auth env	Default model
openrouter (default)	https://openrouter.ai/api/v1/videos	OPENROUTER_API_KEY	bytedance/seedance-2.0
volcengine (CN)	https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks	ARK_API_KEY (or VOLC_ARK_API_KEY)	doubao-seedance-2-0-260128
byteplus (intl)	https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks	ARK_API_KEY (or BYTEPLUS_API_KEY)	dreamina-seedance-2-0-260128

Both flavours follow submit-then-poll, but differ in request shape (OpenRouter uses a flat prompt field; ARK packs everything into a content[] array), polling URL (OpenRouter returns polling_url; ARK gets id and you construct /contents/generations/tasks/{id}), the terminal-success status (completed vs succeeded), and where the final MP4 URL sits (top-level unsigned_urls[0] vs content.video_url). This script normalises both into a single Python contract.

Inputs (with:)

key	required	default	notes
prompt	yes	—	Structured English video prompt (use this skill's recipes).
filename	yes	—	Output .mp4 path.