# Jimeng CLI Text2video

> Use when the user wants to submit, poll, or troubleshoot Dreamina 即梦 text-to-video tasks through `dreamina text2video`. Covers CLI v1.4.14 required video resolution, Seedance 2.0 model constraints, duration and ratio validation, sessions, and async terminal statuses.

- Skill: `full-aigc-skills/jimeng-cli-text2video` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add full-aigc-skills/jimeng-cli-text2video`
- Raw SKILL.md: https://api.skillmd.com/api/skills/full-aigc-skills/jimeng-cli-text2video/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Complete terms in LICENSE.txt
- Author: full-aigc-skills (https://skillmd.com/u/full-aigc-skills)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/full-aigc-skills/jimeng-cli-text2video

---


# 即梦 CLI 文生视频

执行前先运行 `dreamina text2video -h`。本技能记录 v1.4.14 稳定工作流；实际 help 始终是参数事实源。

## When to use and boundary

用于无参考媒体的 CLI 文生视频提交、轮询和故障诊断。不该用于图生视频、故事板或单纯提示词创作；改用 `jimeng-cli-image2video` 或 prompt 技能。

## 必须遵守

- 每次提交显式传 `--video_resolution`，token 必须是小写 `720p`、`1080p` 或 `4k`。
- `seedance2.0_vip` 支持 720p/1080p/4k；其他公开模型仅支持 720p。
- 文生视频公开模型仅为 Seedance 2.0 家族，不要传旧 3.x 或 Seedance 1.x token。
- duration 范围 4–15 秒，默认模型 `seedance2.0fast`。
- 提交前说明会消耗积分；耗时场景优先异步提交。

## 标准执行

```bash
dreamina user_credit
dreamina text2video \
  --prompt="镜头缓慢推进，一只橘猫在窗台伸懒腰，晨光穿过窗帘" \
  --duration=5 \
  --ratio=16:9 \
  --model_version=seedance2.0fast \
  --video_resolution=720p \
  --poll=0
```

VIP 高分辨率：

```bash
dreamina text2video \
  --prompt="航拍海岸线，浪花沿岩石展开，电影感长镜头" \
  --duration=8 \
  --ratio=16:9 \
  --model_version=seedance2.0_vip \
  --video_resolution=1080p \
  --poll=0
```

## 异步闭环

### Step 1：验证

运行 help，校验模型、duration、ratio 与分辨率组合。

### Step 2：提交

检查积分、说明消费影响、异步提交并保存 `submit_id`。

### Step 3：终态闭环

对 `querying` 持续调用 `query_result`，直到 `success` 或 `fail`。失败时报告
`fail_reason`。遇到 `AigcComplianceConfirmationRequired` 时提示用户先在 Web 端完成授权。

## Gotchas

1. **分辨率遗漏**：每次都必须传 `video_resolution`。
2. **token 大小写**：使用 `720p`/`1080p`，不是大写 P。
3. **模型越界**：文生视频不接受 Seedance 1.x 或旧 3.x。
4. **高分辨率误用**：1080p/4k 仅 `seedance2.0_vip`。
5. **长任务误判**：poll 超时仍为 `querying` 时继续查询，不立即重提。

## References

- [`dreamina-cli` skill 的 v1.4.14 参数契约](https://github.com/full-aigc-skills/jimeng-skills/blob/main/skills/dreamina-cli/references/dreamina-cli-v1.4.14-contract.md)(如未安装:`npx skills add full-aigc-skills/jimeng-skills --skill dreamina-cli`)
- [参数参考](references/parameter-reference.md)
- [模型选择](references/model-guide.md)
- [VIP 指南](references/official-doc-vip-guide.md)
- [工作流模式](references/workflow-patterns.md)
- [示例](examples/basic-generation.md)