linkfox-aigc-imagegen
根据提示词或参考图生成与编辑图片,支持多种图片模型、分辨率、宽高比、质量和批量输出。适用于 AI 生图、文生图、图生图、商品场景图和图片编辑;不适用于文本生成或视频生成。
SKILL.mdskills/linkfox-aigc-imagegen/SKILL.md
GitHubAI 生图
适用范围
适用
用户希望“生成图片”“AI 画图”“帮我画”“做张图”“图生图”或 image generation 时使用本技能。
场景速查
| 用户表达 | 创作场景 |
|---|---|
| 按描述画一张图 | 文生图:根据提示词生成图片。 |
| 用商品图做一张场景图 | 参考图生图:准备素材后生成新图。 |
| 编辑这张现有图片 | 图片编辑:根据用户目标选择图片模型。 |
| 看看有哪些模型可选 | 模型查询:展示当前开放的图片模型与能力。 |
边界
文本生成使用 linkfox-aigc-textgen,视频生成使用 linkfox-aigc-videogen。
接口清单
| 接口 | 端点 | 接口文档 | 对应脚本 | 说明 |
|---|---|---|---|---|
| 创建生图任务 | POST /aigc/imageGenAsync |
references/api.md | scripts/aigc_imagegen.py |
创建异步任务。 |
| 查询任务状态 | POST /aigc/taskQuery |
references/api.md | scripts/aigc_imagegen.py |
查询原任务的状态与图片结果。 |
| 查询模型枚举 | GET ${LINKFOX_AI_API_URL}/image/model/config/list?bizType=201 |
references/api.md | scripts/aigc_imagegen.py --list-models --inline |
获取当前可用模型枚举及能力。 |
| 查询视频模型枚举(共用模块兼容分支) | GET ${LINKFOX_AI_API_URL}/image/video/model/config/list?bizType=88 |
references/api.md | scripts/aigc_model_config.py |
共用模块支持枚举查询;图片命令行入口不调用,不创建视频任务。 |
| 获取上传凭证 | POST /oss/getStsVoucherByAPI |
references/file-upload.md | scripts/upload_file.py |
获取临时凭证后向 OSS 上传素材。 |
以上均为直接端点,无统一转发 path。账号引导使用固定公共资源,不计入本技能业务接口;OSS 上传为素材传输,不另计 LinkFox 接口。
前置条件
明确用户的创作目标与提示词。仅在使用参考图时准备素材;已有公开可访问的 HTTP(S) URL 直接复用,本地图片或附件按 references/file-upload.md 上传,保留输入顺序,用成功项 URL 替换原路径。上传失败即停止生成。
上传前告知文件将获得公开可访问 URL,取得用户对内容可公开的确认;“上传这个文件”不等于确认可以公开。禁止上传敏感或私密内容,不修改源文件;不需要另找或安装上传技能。
生图流程
- 先通过查询模型枚举获取当前可用模型及能力,并遵循用户选择;仅查询失败时使用文档中的静态列表兜底。
- 准备提示词、模型与所需参考图;按下方默认策略及接口参考构造生成参数。收到
ARGUMENTS:后,先完成必要素材准备,参数齐全即执行python scripts/aigc_imagegen.py '<JSON 参数>',已有可用 URL 或纯文生图可直接执行;上传授权仍按前置条件处理,其余不额外等待确认。 - 脚本创建一次任务、轮询该任务并自动下载图片;初始轮询间隔 10 秒,每次减 1 秒至最低 5 秒,最多等待 600 秒。向用户交付本地图片路径;禁止 Read 转存图片内容,避免 base64 进入上下文。
- 异常或等待超时时告知状态与任务 ID;只续查原任务,不自动重提、不切换模型,不在同轮反复等待。客户端等待超时不代表服务端失败或已回补;空体或非 JSON 只解释为上游响应异常。退出码、可续查标记与续查方法见 references/api.md。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python scripts/aigc_imagegen.py '<JSON 参数>' [--inline] [--no-cache]。 - 成本约束:按所选参数动态计费,具体见“算力消耗预估”。同一会话、同一参数组合默认只创建一次任务,业务脚本禁用响应缓存。失败或无图片结果时,只续查已有任务,不自动重提或切换模型;用户要求再次生成时,先说明额外消耗。
输出策略
- 生成成功后自动下载图片到会话
media/,stdout 仅输出Saved full response: ["本地图片路径", ...];完整最终响应静默写入data/。前端应解析所有同类行;单次调用通常一行,多次调用可有多行。 - 无图片产物或生成失败时,输出完整响应或诊断的文件路径与错误摘要;不向用户输出 Python 堆栈。等待超时和下载失败的处理见接口参考。
- 会话目录为
<可写根目录>/linkfox/<YYYY-MM-DD>/<session>/;优先使用ACPX_WORKSPACES首个路径,其次当前工作目录、用户目录、系统临时目录。<session>优先取SESSION_ID;响应文件名为data/linkfox-aigc-imagegen-<ts_us>.json,使用微秒时间戳。 - 业务封装禁用响应缓存,最终响应或失败诊断统一存档;中间创建与轮询不额外建会话或响应文件。
--inline不改变生成时的媒体路径交付,模型查询与上传的 CLI 和输出见接口参考。
需要具体字段时,使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取。禁止 Read 图片内容,避免 base64 进入上下文;向用户交付本地图片路径。会话登记、目录回退与文件精度详见 references/api.md。
执行规则
算力消耗预估
按所选参数动态计费,算力消耗与模型、分辨率、质量和输出数量等参数相关。使用实际返回的 costToken 等计费信息,不编造固定单价或金额;脚本在 costToken 缺失时按 0 记录,不据此推断免费。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - HTTP 状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 展示模型名称:介绍、推荐、确认或解释错误时仅用动态目录的
name;查询失败时用静态兜底说明名称。禁止向用户展示请求值、别名、provider 或下游模型 code;内部映射见接口参考。 - 保持选择逻辑:未指定时使用 LF智能模型 G-2.5 Sunburst(
GPT_2_5_IMAGE/LF_GT_2),先用1K、low出图给用户确认。确认画面后,再询问是否用同一模型重出2K、medium,得到用户同意后才创建新任务。用户已明确指定的模型、分辨率和质量原样透传,只有明确要求才传4K。 不跟随后台默认,不自动换模型;编辑现有图片可按需选择 Linkfox-Image-1。 - 参数选择:参考图数量、分辨率与质量选项须符合所选模型能力;不得向仅支持 1K 的模型提供仅含 2K/4K 的选项。没有合法默认值时询问用户,不自动改参数或换模型。参数范围见接口参考。
- 提示词具体:明确主体、风格、场景、光照与构图,建议用英文提示词获得更好效果。
- 保持动态目录开放:普通场景不以静态目录封顶;仅明确的专用业务在列表查询时取模型交集。能力用于介绍与选择,不额外拦截或改写既有生成请求;默认模型缺失时说明当前目录情况,不自动换模型。
- 区分交付与状态:成功、失败、等待超时与下载失败分别说明;保留完整诊断到数据文件,避免向用户输出 Python 堆栈或猜测模型不可用原因。
使用示例
商品场景图
用户:用这张商品图做一张白色背景、摄影棚灯光的商品图。
准备公开可访问的参考图,结合用户的主体与构图目标组织具体提示词,按当前模型能力选择参数,执行生成并交付本地图片。
编辑已有图片
用户:保留商品外观,换成极简展示背景。
查询模型目录并按名称介绍适合编辑的模型;取得必要素材公开授权后上传,提交编辑目标,交付结果。
已有任务续查
用户:刚才等待超时了,查一下原任务。
使用原任务 ID 查询结果,保留服务端状态;不重新创建任务。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。