用途:本技能指导使用 z-ai-web-dev-sdk 包与 CLI 工具实现图像生成功能,根据文本提示词(prompt)创建图片,可用于创意工作流、设计自动化和视觉内容生产。
主要能力:通过 zai.images.generations.create 接口传入 prompt 与 size 参数生成图片,返回 base64 数据,需解码后保存为文件。支持批量生成、结果缓存、错误重试等模式。支持的尺寸限定为:1024x1024(方形)、768x1344、864x1152(竖版)、1344x768、1152x864(横版)、1440x720(宽横版)、720x1440(高竖版)。
使用方式:先导入 SDK 并创建实例,再调用生成接口。CLI 示例:z-ai image --prompt "A beautiful landscape" --output "./image.png",短写为 z-ai image -p "A cute cat" -o "./cat.png",指定尺寸用 -s 1344x768。技能位于项目 {project_path}/skills/image-generation,参考脚本在 scripts/image-generation.ts。
适用场景:网站视觉素材(主图、背景、图标)、营销与社交媒体图、产品图与效果图、博客配图、品牌资产、UI/UX 插画、游戏概念图、电商产品图等,也可封装为 Express 等后端接口或写入 Shell 脚本批量调用。
限制:z-ai-web-dev-sdk 必须且只能在后端代码中使用,不可用于客户端代码。尺寸只能从上述列表选择。提示词应具体、包含风格与细节以提升匹配度。SDK 假设已安装,导入方式以示例为准。资料未说明具体收费、价格、模型名称或平台支持情况。