前言¶
在 IDE 或 Agent 里做配图，常见做法是手写一长串 shell，再对照即梦网页端猜参数；任务一异步，终端里还要自己记 submit_id、轮询状态和下载路径。SkillHub 上的 即梦-文生图 CLI 技能（@user_c1d16043/jimeng-cli-text2image）把安装校验、登录、参数映射、标准执行流程和错误处理写进 SKILL.md，智能体在用户提到「即梦 CLI」「命令行生图」或要提交/查询文生图任务时，会按同一套步骤调用字节跳动 dreamina 命令行，而不是临时拼凑命令。
这是什么¶
即梦-文生图 CLI 技能 是面向 AI Agent 的操作指南型 Skill（当前版本 1.0.4，来源 community，分类 design-media）。发布者为 SkillHub 用户 user_c1d16043（页面标注作者 Loong10K）。它不负责替代即梦服务端，而是说明如何通过官方 dreamina CLI 向即梦（Dreamina/Jimeng）3.0～5.0 等文生图模型提交任务，并覆盖积分查询、同步/异步提交、结果轮询与会话（session）维度的项目组织。SkillHub 标签 requires_api_key=false：认证走 CLI 登录流程，不是在本 Skill 里配置第三方 API Key。
核心功能¶
以下能力均来自 SkillHub 页面与技能简介的表述，可与官方 dreamina CLI 文档对照使用。
- 触发边界：用户要用已确认的提示词在命令行出图；提到
dreamina、即梦 CLI、生成/提交/执行 prompt；或需要查积分、任务状态、会话管理、结果下载时，Agent 应加载本 Skill。 - 安装与认证：包含安装校验（确认
dreamina可用）、登录与账号侧检查（如积分）。 - 参数映射：把自然语言或规格里的提示词、画幅、分辨率等映射为 CLI 参数（具体 flag 以本机
dreamina text2image -h为准）。 - 执行方式：支持同步等待与异步提交；异步场景下配合
query_result、任务列表等命令轮询与取回结果。 - 流程与排错：技能说明中归纳 4 条标准执行工作流 与 6 种常见错误处理模式（细节在安装的
SKILL.md内，不在此重复编造）。 - 范围限制：聚焦 文生图（
dreamina text2image），不替代图生图、视频生成或纯提示词创作类 Skill。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本 Skill 到当前 Agent 的 skills 目录¶
SkillHub 要求 --dir 必须指向当前 Agent 实际读取的 skills 目录，否则技能不会被加载。安装坐标：
skillhub install @user_c1d16043/jimeng-cli-text2image --dir <你的 skills 目录>
页面给出的通用提示为：依据 SkillHub 安装说明 安装 @user_c1d16043/jimeng-cli-text2image。
常用客户端 skills 路径（摘自 SkillHub 安装文档，按你当前环境选用其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
安装后需按各客户端要求刷新或重启，使新 Skill 生效。
3. 安装并登录 dreamina CLI（生图二进制）¶
本 Skill 指导的是 dreamina 命令行。官方一键安装示例（字节跳动即梦 CLI 仓库文档）：
curl -fsSL https://jimeng.jianying.com/cli | bash
默认将 dreamina 安装到 ~/.local/bin/。远程或无图形环境时，可用无头扫码登录：
dreamina login --headless
登录后可用积分接口确认会话是否有效：
dreamina user_credit
典型用法¶
下面示例来自官方 dreamina CLI 文档中的文生图与异步查询用法；Agent 在实际执行前应运行 dreamina text2image -h 核对当前版本支持的参数。生成命令会消耗即梦积分，提交前应向用户说明。
同步或带轮询的文生图（指定比例与分辨率类型）：
dreamina text2image \
--prompt="cyberpunk cityscape at night, neon reflections" \
--ratio=1:1 \
--resolution_type=2k
异步任务：先提交，再按 submit_id 查询并下载：
dreamina query_result --submit_id=3f6eb41f425d23a3 --download_dir=./output
查看历史任务（便于接续未完成的异步生成）：
dreamina list_task --gen_status=success
文生图模型与 resolution_type 的对应关系（如 3.0/3.1 支持 1k/2k，4.x/5.0 支持 2k/4k 等）以官方 CLI 帮助与即梦侧说明为准；技能内的参数映射应与此保持一致。
适用场景与注意¶
适合：已在 Agent 工作流里固定使用即梦账号；希望把「装 CLI → 登录 → 提交文生图 → 轮询/下载」交给智能体按步骤完成；需要统一处理 CLI 报错与会话管理的团队或个人。
注意：
- 本 Skill 为 community 维护，与官方 dreamina 仓库自带的 Agent Skill 路径不同；以 SkillHub 安装的
SKILL.md为 Agent 行为准则。 - 部分模型可能需要在即梦网页端完成一次性授权后才能通过 CLI 调用。
- 异步任务务必保留
submit_id，并在终端侧正确处理「任务未完成 / 超时 / 积分不足」等状态；具体对策见技能内 6 类错误模式说明。 - SkillHub 页面统计（抓取时）：评分 100000，下载 32183 次；安装量以商店展示为准。
结尾¶
即梦-文生图 CLI 技能 把即梦文生图从「临时查文档写命令」收敛为 Agent 可重复执行的流程：安装校验、认证、参数映射、同步/异步提交与排错模板都在 Skill 内对齐。若你的智能体需要在对话里稳定跑 dreamina text2image，可从 SkillHub 安装 @user_c1d16043/jimeng-cli-text2image。
- SkillHub 页面：https://www.skillhub.cn/skills/user_c1d16043/jimeng-cli-text2image
- API/分享地址：https://api.skillhub.cn/user_c1d16043/jimeng-cli-text2image
- SkillHub 安装说明：https://skillhub.cn/install/skillhub.md
