When to use
Only handles reference material videos. Input: image/video/audio references; use m2v for single-image and multimodal, use first_last_frame for two images in order as first and last; there is no i2v or multi_modal mode.
When the prompt is not yet determined, hand it to dreamina-prompt-image2video; the final prompt must not be rewritten without the user's request.
Sunset notice: this skill replaces the corresponding generation path of the old dreamina CLI.
Operation Contract
| Item | Standard |
|---|---|
| Input and Prerequisites | User-confirmed prompt, current model specs, projectId, and the references required by the mode |
| Side Effects | Node writes without --run save drafts; paid execution goes through the public execution operations |
| Output Handoff | The returned nodeId and projectId; after generation, also attach submitId and the validated resources |
| Recovery Rules | Recovery uses the original submitId; only when explicitly absent + resubmittable should the submission be restored under the original identity |
Workflow
Step 1: Reuse the public invocation contract and confirmed projectId of dreamina-canvas-cli ; when installation or login is missing, hand it to the setup/auth skill by name.
Step 2: Validate mode parameters from the current model/voice query results, and read the parameter specification. Do not apply the old CLI's model_version, resolution_type, or poll.
Step 3: Save the draft and record the returned nodeId; when modifying an existing node, first read the current state, fully replace the generation parameters and references, and only metadata is a sparse update.
dreamina-canvas --format json node create video --project-id <projectId> \
--prompt "<prompt>" --mode m2v --model <model> --ratio <ratio> --duration <seconds> --ref node:<nodeId>
Step 4: When generation is needed, hand it to the execution operations of dreamina-canvas-cli : node quote → node confirm → node run. Record a stable submitId before submission; the task skill does not approve budgets on its own.
Step 5: Hand it to the same public skill for query recovery and download validation, and verify the actual artifacts of this mode. On timeout, do not change the submitId and resubmit.
Rules
- Placeholder parameters must be replaced with values returned by the current CLI or confirmed by the user; draft commands do not add --run.
- Do not mix required fields from other modes; the batch upper limit comes from the model capability query.
- Never persist tokens, cookies or signed URLs; recovery retains only non-sensitive identity.
- When a companion skill is missing, install it:
npx skills add full-aigc-skills/dreamina-skills --skill <skill-name>。
Progressive disclosure (read on demand)
- When per-flag required/value/conflict rules are needed, read the parameter specification。
- When a model, ratio, resolution, or duration needs to be selected from current discovery results, read model or voice selection。
- When a sectioned workflow such as batch, async, multi-project, or iteration is needed, read common scenario combinations。
- When encountering timeout, partial success, or recovery scenarios, read exception handling。
- When self-checking before delivery, read the acceptance checklist。
- For the first run, see success scenarios; for batch/async/multi-project/authorization-refusal/failure-recovery examples, see the
examples/directory.
Validation checklist
- The input is consistent with m2v / first_last_frame modes, and parameters have undergone real-time discovery.
- The returned projectId, nodeId, and submitId are handed off correctly; acceptance must not be treated as completion.
- Output a successful terminal state, then after download verify the media type, byte count, and SHA-256.
Gotchas
- Node generation editing is a full replace and must not lose existing references.
- Login status, billing permission, and generation success are different checks.
- Generate only the quantity requested by the user; do not automatically add attempts.
Not Applicable and Boundaries
Not applicable to text-only videos or local editing. Two ordinary reference images must not be automatically interpreted as the first and last frames; first choose the mode based on the user's intent. Having only a reference link does not mean generation has occurred.
Read only the account and material information necessary for the current operation; do not store, log, or output access tokens, cookies, or temporary signed links.