跳到主要内容

生成图片

使用 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