AI 生图V3

请求体

比例与分辨率

以下模型、比例、分辨率和品质从当前模型配置实时读取。未传分辨率时由服务端按模型配置处理，请显式传入所需分辨率。

请求示例

{
  "imageUrls": [
    "https://test-file-ai.linkfox.com/UPLOAD/reference-1.jpg"
  ],
  "prompt": "生成一张简洁明亮的商品主图，白色背景，柔和棚拍光线",
  "outputNum": 1,
  "provider": "LF_BA_3_PRO",
  "resolution": "2K",
  "aspectRatio": "1:1"
}

文生图时省略 imageUrls。使用 LF智能模型 G 系列时，可按模型支持范围增加 quality、background。

提交后返回什么

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

查询生成结果

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

扣费标准

扣点数 = 单张基础点数 × 输出数量（outputNum）。传入 2 张及以上参考图时，每张图片的基础点数额外增加 10 点。

自定义尺寸

支持范围

支持文生图和参考图生图：不传 imageUrls 为文生图，传入参考图为图生图；两种场景均可使用 size。参考图格式、大小和数量仍按本页请求体及模型配置限制。

模型须在当前环境配置并启用，实际可用档位以模型配置为准。LF全能模型等未列出的模型不支持此接口的自定义 size。

LF_G_2 支持 low / medium / high；LF_G_2_5 / LF_G_2_5_F 支持 low / medium / high / xhigh / max，具体支持范围以模型配置为准。

G 系列的 size 可与 quality 同时使用；未传 quality 时使用 medium，不接受 quality=auto。其他模型请省略 quality。所选模型必须支持尺寸对应的计费档位，G 系列还须支持所选品质。

尺寸、规格和品质怎么选

选择一种尺寸方式即可：

• 按规格和比例生成：使用 resolution、aspectRatio，省略 size。不传规格时按当前模型的默认值处理，不保证默认是 1K。
• 按自定义像素尺寸生成：使用 size，省略 resolution、aspectRatio；可同时传 imageUrls，G 系列还可传 quality。

2K 不等于固定的 2048x2048；例如 G 系列的 2K + 1:1 是 2048x2048，2K + 16:9 是 2048x1152。已有请求不传 size 时，继续按原有规格、比例和计价规则处理。

尺寸限制

格式为 宽x高，宽高均为正整数，单位是像素。建议使用小写字母 x；也接受大写 X 及分隔符两侧空格，例如 1200 X 880。请勿使用乘号 × 或 *。size 与 resolution、aspectRatio 互斥，与参考图不互斥。

自定义尺寸须满足以上限制，输出使用请求的宽高。

G 系列示例：1536x1536、1200x880、2032x1392、3008x1776 均为合法尺寸；1205x1205 和 1537x1537 因不是 16 的倍数被拒绝，3840x3840 因总像素超限被拒绝。SEEDREAM5_PRO、WAN2_7 可使用 1376x1008，也可在各自限制内指定其他宽高。

边界尺寸示例

总像素下限和上限都包含在允许范围内。

表中尺寸是面积边界示例，不是固定尺寸列表。其他宽高只要同时满足面积、宽高比和对应模型的额外限制，也可以使用。G 系列要求宽高为 16 的倍数，因此示例按 16 像素调整；SEEDREAM5_PRO 的 1205x1205 不受该倍数限制，总像素 1,452,025，按 2K 档计费。

即使面积在范围内，超过宽高比或边长限制仍会被拒绝。例如 G 系列的 3088x1024 超过 3:1、3856x1024 超过单边 3840；SEEDREAM5_PRO 的 4001x250 超过 16:1；WAN2_7 的 3201x400 超过 8:1。

自定义尺寸如何扣点

自定义 size 沿用所选模型的 1K / 2K / 4K 每张价格，G 系列同时按所选 quality 取价。档位识别仅用于选择价格，实际输出仍使用请求的宽高；SEEDREAM5_PRO、WAN2_7 的当前尺寸范围只会归入 1K 或 2K。

G 系列优先匹配以下全部 33 个标准尺寸。 命中时使用表中的档位。此标准尺寸表仅适用于 G 系列；其他支持模型直接按总像素数分档。

表中比例是规格名称，部分标准宽高经过像素对齐，实际像素比可能略有差异。传 size 时以具体像素宽高为准。

G 系列未命中标准尺寸表时，以及其他支持模型的合法尺寸，按总像素数分档。 须先满足各模型的尺寸限制。

计费边界示例：达到档位上限时仍按当前档位计费，超过上限即按下一档完整价格计费，不按超出的像素比例加价。

SEEDREAM5_PRO、WAN2_7 的当前面积上限为 4,194,304，因此 2048x2049 会因尺寸越界被拒绝，不会按 4K 继续生成。

SEEDREAM5_PRO、WAN2_7 的 1376x1008 总像素为 1,387,008，按各自的 2K 单张价格扣点，实际输出仍为 1376x1008。

传入 2 张及以上参考图时，单张基础点数在对应档位价格上额外增加 10 点，再乘以 outputNum。

以下为 G 系列 计价示例：

例如 1200x880 只比 1K 像素上限略大，也按完整 2K 档价格扣点。同一模型、同一品质、同一档位内的不同合法尺寸，单张点数相同。具体点数请查看本页扣费标准；总扣点数 = 对应档位与品质的单张点数 × outputNum。

按自定义像素尺寸生成

{
  "prompt": "生成一张简洁明亮的商品主图，白色背景，柔和棚拍光线",
  "outputNum": 1,
  "provider": "LF_G_2",
  "size": "1536x1536",
  "quality": "medium"
}

此请求生成 1536x1536 图片，使用当前 LF_G_2 的 2K + medium 单张价格。可将 size 换成其他合法尺寸，也可增加 imageUrls 使用参考图；不要同时补传 resolution、aspectRatio。

参考图生图示例（将图片地址替换为可访问的实际参考图）：

{
  "prompt": "保留参考图中的商品，将背景换成浅黄色，保持简洁商品摄影风格",
  "imageUrls": ["https://test-file-ai.linkfox.com/UPLOAD/reference-1.jpg"],
  "outputNum": 1,
  "provider": "SEEDREAM5_PRO",
  "size": "1376x1008"
}

此请求按 SEEDREAM5_PRO 的 2K 单张价格扣点。可将 provider 换成 WAN2_7 使用相同尺寸；G 系列图生图可使用 LF_G_2_5、size=1200x880 并增加 quality=low。

参数被拒绝时

非法尺寸、互斥参数、不支持自定义尺寸的模型或不支持的品质会返回业务码 5007（ERR_FILED_VALIDATE），未创建任务。HTTP 200 也可能表示参数错误，请同时检查响应体的 code。

例如同时传 size=1536x1536 与 resolution=2K 会被拒绝；只传 size=1536x1536 就能按 2K 档计价，无需再传规格。