---
name: dreamina-gateway
description: 通过用户自己的即梦网关查询模型与积分、确认报价、提交异步图片或视频任务，并继续查询和下载原任务。只使用网关 Key，不访问即梦账号。
---

# 即梦网关

使用安装包里的 `dg` 客户端连接用户指定的网关。当前开发版只启用模拟模型；模拟任务不能被描述为真实即梦产出。

## 接入

1. 用户运行 `dg setup`，交互输入服务地址和自己的 Key；不要把 Key 放入命令参数、聊天、URL 或日志。
2. 使用 `dg me` 和 `dg models` 查询当前额度与启用的模型。这些是用户网关请求，不是即梦账号探测。
3. 不读取或修改即梦、浏览器、ZCode 的账号配置；不执行即梦登录、登出或会员／余额检查。

## 提交与继续任务

- 把用户请求写成 UTF-8 提示词文件，通过 `dg quote --model <模型ID> --prompt-file <文件>` 获取确定报价。图片用 `--resolution 2k`，视频用 `--duration 5`；只使用 models 返回的组合。参考素材先用 `dg upload <文件>` 上传（≤10MiB PNG/JPEG）取得素材 ID，报价时用 `--asset <素材ID>` 附带（可重复或逗号分隔）。
- 向用户说明报价、模型、数量、时长／分辨率。遵守用户已经批准的积分预算，新增批次或超过预算时先确认。
- 用 `dg submit --quote <报价ID> --idempotency <稳定UUID>` 提交。先保存报价、幂等标识和返回的任务编号。
- 网络超时后沿用原报价与幂等标识重试提交；已经获得任务编号后只用 `dg status <任务ID>` 继续查询。不要重新提交来“试试”。
- 可用 `dg wait <任务ID> [--timeout 10m]` 轮询等待终态；等待超时或被中断后保留原任务编号，用 `dg status <任务ID>` 继续查询，绝不重新提交。
- `queued` 表示排队，`submitted/generating` 表示上游处理，`transferring` 表示正在交付。未知提交或需要核实的状态应交给管理员处理，不能自动重新生成。
- 只有任务达到 `succeeded`，且 `dg download <作品ID> --output <目标文件>` 下载并核对哈希成功（输出 `{id,size,sha256,path}` 回执）后，才报告作品已交付。退出码 0、拿到提交编号或收到通知都不足以单独证明完成。
- 明确失败、取消与额度变化以服务端任务与账本为准（`dg ledger`、`dg files`、`dg notifications`），不自己推算即梦实际收费；网关积分与即梦成本是不同记录。

## 作品与隐私

只下载任务返回的本人作品 ID。下载链接有时效，在保留期内通过客户端重新取得链接；不要公开链接中的签名。提示词与参考素材只发送到用户已配置的网关，不向其他服务转发。

安装时由用户明确选择 Agent 与技能目录，保留已有文件，不覆盖同名 Skill；卸载只删除本安装包创建的文件。用户配置与 Key 的删除需要用户明确选择。