生成图片
使用 xianchou generate image 可以提交单次 AI 生图任务。
xianchou generate image \
--prompt "现代科技文档封面,抽象 AI 视频创作画布" \
--project-id <PROJECT_ID> \
--poll
如果不传 --provider-id 和 --model-id,CLI 会读取模型列表并使用默认模型。如果不传 --channel,CLI 会从选中模型的 channels 中使用第一个可用值。
参数
| 参数 | 说明 |
|---|---|
--prompt <prompt> | 必填,图片提示词 |
--project-id <projectId> | 项目 ID;不传时读取配置或 XIANCHOU_PROJECT_ID |
--provider-id <providerId> | Provider ID,来自 models image |
--model-id <modelId> | Model ID,来自 models image |
--channel <channel> | 生图通道;不传时使用选中模型的第一个可用通道 |
--ratio <ratio> | 图片比例,例如 16-9 |
--resolution <resolution> | 分辨率选项 |
--output-format <format> | 图片输出格式 |
--number <number> | 生成图片数量,默认 1 |
--poll | 轮询任务直到成功或失败 |
不轮询
不传 --poll 时,命令只提交任务并输出任务信息:
xianchou generate image --prompt "一张产品海报"
这适合由外部脚本接管后续任务查询。
轮询到完成
传入 --poll 后,CLI 会持续查询任务状态。任务成功后会自动调用 settle 接口并输出最终任务结果:
xianchou generate image --prompt "一张产品海报" --poll