LinkfoxAI agent and documentation index

Fetch the complete documentation index at: /llms.txt

Read when and how to use LinkfoxAI at: /agent-instructions.txt

Machine-readable API description: LinkfoxAI OpenAPI specification

Use this file to discover all available pages before exploring further.

LinkfoxAI logo
开始使用
API对接文档

智能修图-多图V3

POST/image/v3/make/multiImageFusionapplication/json

请求体

基础参数

素材的格式、大小、尺寸和比例为业务使用要求,部分在任务执行或上游调用阶段检查;创建成功不代表已通过全部素材校验。上传限制与具体业务素材要求分别适用。

imageListarray[string]必填
图片列表,请求张数见下方模型对照表
格式:jpg、jpeg、png、webp大小:单张不超过 10 MB尺寸:800×800~4096×4096
promptstring必填
图片融合目标和要求,不能为空;当前服务端保留前 3000 字符,超过时截断,不返回长度越界错误。
providerstring必填
模型,可选值详见比例与分辨率
outputNuminteger可选默认1
输出张数
templatestring可选
提示词模板名称(多图模板),模板中的 provider、needOptimize 配置优先于入参
可选值搭配融图 / 搭配上身
needOptimizeboolean可选
是否需要提示词优化,true:需要,false:不需要
aspectRatiostring可选
输出比例,模型支持范围详见比例与分辨率
resolutionstring可选
输出分辨率,详见比例与分辨率
supplyTypestring可选
供应模式;是否支持该字段及可选值,以当前模型实际提供为准
backgroundstring可选默认auto
画布背景模式,LF智能模型 G 系列生效:transparent(透明)、opaque(不透明)、auto(由模型决定)。
qualitystring可选默认medium
输出品质,支持范围详见比例与分辨率

QWEN_IMAGE_3_PRO 使用限制

  • 支持 JPG、JPEG、PNG、WEBP 格式,单张图片不超过 10 MB;建议宽高在 384~2048 像素范围内。

比例与分辨率

请显式传入所需分辨率。

provider支持比例支持分辨率支持品质请求图片
正在读取模型配置...

请求示例

LF智能模型 G 系列(LF_G_2 / LF_G_2_5)

JSON
{
    "imageList": [
        "https://test-file-ai.linkfox.com/UPLOAD/image1.jpg",
        "https://test-file-ai.linkfox.com/UPLOAD/image2.jpg"
    ],
    "prompt": "融合两张图片风格,保留主体元素",
    "provider": "LF_G_2",
    "outputNum": 1,
    "resolution": "2K",
    "aspectRatio": "1:1",
    "quality": "high",
    "supplyType": "stable",
    "needOptimize": true
}
LF_G_2_5 / LF_G_2_5_F 请求参数与上方完全一致,仅将 provider 改为对应模型码。

其他模型

JSON
{
    "imageList": [
        "https://test-file-ai.linkfox.com/UPLOAD/image1.jpg",
        "https://test-file-ai.linkfox.com/UPLOAD/image2.jpg"
    ],
    "prompt": "融合两张图片风格,保留主体元素",
    "provider": "LF_BA_3_PRO",
    "outputNum": 1,
    "resolution": "2K",
    "aspectRatio": "1:1",
    "supplyType": "stable",
    "needOptimize": true
}

Qwen模型(QWEN_IMAGE_3_PRO)

JSON
{
    "imageList": [
        "https://test-file-ai.linkfox.com/UPLOAD/image1.jpg",
        "https://test-file-ai.linkfox.com/UPLOAD/image2.jpg"
    ],
    "prompt": "融合两张图片风格,保留主体元素",
    "provider": "QWEN_IMAGE_3_PRO",
    "outputNum": 1,
    "resolution": "2K",
    "aspectRatio": "1:1",
    "supplyType": "stable",
    "needOptimize": true
}

提交后返回什么

提交成功后返回任务编号 data.id,表示任务已创建,结果还需等待生成。请保存编号。查看返回示例。

查询生成结果

用任务编号 data.id 调用获取作图结果,每次查询至少间隔 10 秒。data.status=3 表示成功;若生成了图片或视频,从 data.resultList[].url 获取地址。data.status=4 表示失败。查看统一示例。

扣费标准

正在读取当前模型扣点...

扣点数 = 单张扣点 × 输出数量(outputNum)。

创建上限

配置项上限
创建中 / 生成中任务上限100 个