蓝度AI生图

解决什么问题

AI 生图接入的常见痛点：参数文档不透明、生成结果保存不稳定、计费规则模糊，工程师往往要反复调试确认。该技能让文生图与图生图调用像运行本地脚本一样直接，同时把能力清单、计费方式、结果生命周期等关键信息明确暴露出来。

技能如何工作

• 环境变量 LANDO_API_KEY（形如 lp_xxx）必须预先设置，所有调用消耗组织账户积分。
• 所有操作通过随包脚本 scripts/lando.py 完成，仅依赖 python3 标准库。
• 先执行 capabilities 命令获取服务端当前真实的能力与参数，一律以其为准。
• 执行任务默认阻塞等待结果，通常 30–60 秒；JSON 结果输出到 stdout，进度信息在 stderr。

核心能力：image.generate

• prompt：必填的图像描述文本，越具体效果越好。
• size：可选，支持 1024x1024 等宽x高组合，或填 auto 交由系统选择。
• n：生成张数，默认 1 张。
• reference_images：可选参考图 URL 数组（图生图），最多 6 张，须为公网可访问地址。
• 计费按分辨率分档：≤1024 为 1K 档，≤2048 为 2K 档，更大为 4K 档；提交时预留积分，完成后按实结算，失败自动退回。

注意点

• 不要臆造参数名，传了不认识的参数会被直接拒绝。
• 生成结果仅保留 24 小时，拿到 succeeded 后需及时下载转存，过期后查询会得到空结果且 output_expired 为 true。
• 积分不足时接口返回 HTTP 402，应提示用户到控制台「套餐与账单」充值，不要重试。
• 密钥一律走环境变量，不要写进代码或提交到仓库。