linkfox-aigc-imagegen

根据提示词或参考图生成与编辑图片,支持多种图片模型、分辨率、宽高比、质量和批量输出。适用于 AI 生图、文生图、图生图、商品场景图和图片编辑;不适用于文本生成或视频生成。

SKILL.md

GitHub

AI 生图

适用范围

适用

用户希望“生成图片”“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,取得用户对内容可公开的确认;“上传这个文件”不等于确认可以公开。禁止上传敏感或私密内容,不修改源文件;不需要另找或安装上传技能。

生图流程

  1. 先通过查询模型枚举获取当前可用模型及能力,并遵循用户选择;仅查询失败时使用文档中的静态列表兜底。
  2. 准备提示词、模型与所需参考图;按下方默认策略及接口参考构造生成参数。收到 ARGUMENTS: 后,先完成必要素材准备,参数齐全即执行 python scripts/aigc_imagegen.py '<JSON 参数>',已有可用 URL 或纯文生图可直接执行;上传授权仍按前置条件处理,其余不额外等待确认。
  3. 脚本创建一次任务、轮询该任务并自动下载图片;初始轮询间隔 10 秒,每次减 1 秒至最低 5 秒,最多等待 600 秒。向用户交付本地图片路径;禁止 Read 转存图片内容,避免 base64 进入上下文。
  4. 异常或等待超时时告知状态与任务 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。