DOCUMENTATION

从一次模型发现开始

Agent 可以读取模型参数、上传参考素材、申请报价、提交任务并下载结果。

1 · 登录与发现drama auth login --config config.json --json
drama auth status --config config.json --json
drama models list --json --config config.json
drama models describe <模型ID> --json --config config.json

2 · 素材与恢复drama assets upload --file "人物.png" --key "references/人物.png" --json --config config.json
drama assets resume <原恢复编号> --json --config config.json
drama assets list --json --config config.json

3 · 报价与预算drama quotes create --input @request.json --json --config config.json

request.json 示例 · 参数须以当前模型为准{
  "modelId": "doubao-seedream-5-0-pro-260628",
  "prompt": "雨夜街道上的人物特写",
  "options": {
    "size": "2K",
    "format": "png"
  },
  "assets": [],
  "budgetPoints": "100"
}

budgetPoints 为本次授权的最大积分。参考素材填写本人已就绪的 id 和 versionId；参数或预算改变需要重新报价。

4 · 提交同一请求drama tasks create --quote <报价ID> --idempotency-key <原请求固定键> --json --config config.json

一次业务操作固定一个 16–128 字符幂等键，只使用字母、数字及 _ . : -。回复丢失后沿用原报价和键，不另创建收费任务。

5 · 结果与费用drama tasks get <任务ID> --json --config config.json
drama tasks wait --timeout 10m <任务ID> --json --config config.json
drama tasks outputs <任务ID> --json --config config.json
drama tasks billing <任务ID> --json --config config.json

生成、交付和费用分别查看。CLI 退出或 Ctrl+C 只结束本机等待；已接受任务继续运行。文件未 ready 或费用待核对时，不重新生成。

6 · 下载与结束会话drama assets download --output "结果.png" <ready输出的assetId> --json --config config.json
drama auth logout --json --config config.json

上传中断保留原恢复编号；下载参数放在素材 ID 前，只有完整文件才交付。网页返回不表示积分到账，购买以 AppBoss 原订单和账本为准。