用途:根据文字提示词和可选参考图生成或编辑图片,适合制作产品图、修改现有图片与进行创意视觉变换。
主要能力:文生图;图生图(保留参考图元素);图片编辑(改元素、颜色、背景、风格);产品合成(把一张图的产品放进另一张图的场景);换模特(保留服装与姿势);支持 1:1、3:4、4:3、9:16、16:9 比例,默认 1:1。
使用方式:核心参数为 prompt(必填,最长 1000 字符)、referenceImageUrl(可选,逗号分隔,最多 3 个公开可访问的图片 URL,最长 1000 字符)、aspectRatio(可选,默认 1:1)。可调用 API 端点 POST /multimodal/generateImage,或运行 python scripts/multimodal_generate_image.py '<JSON 参数>' [--inline]。本地图片需先上传获取公开 URL:python scripts/upload_image.py /path/to/local/image.png,返回的 URL 有效期 24 小时。写提示词时建议具体描述主体、场景、光线、风格与氛围;使用参考图时按顺序称为 image 1、image 2;明确使用 replace、change、put、combine、generate 等动词。
输出与成本:脚本默认把完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-multimodal-generate-image-<timestamp>.json,禁止写入 /tmp;响应体不超过 8 KB 时打印完整 JSON,超过时只打印摘要,加 --inline 可强制全量打印。同一会话同一参数组合默认只调用一次,脚本带 24h 本地缓存。计费按动态规则:消耗算力 = rawTokens × 0.045,可能一次性消耗大量算力,需先提醒用户由用户决定是否继续。
限制:参考图最多 3 张,提示词不超过 1000 字符,参考图 URL 必须公开可访问,仅支持上述 5 种比例。不适用于图片分析识别、视频生成编辑、图片格式转换、大批量图片处理及图床存储。未配置 API Key、返回 401/402、提示算力或余额不足时,按 references/onboarding.md 处理。相关参数、响应与错误码见 references/api.md。