跳转到主要内容
POST
使用 kling-v4-long-image 调用 POST /v1/images/generations 异步提交任务,从 data[0].task_id 获取任务 ID,再查询 GET /v1/tasks/{task_id}。每次输出一张 PNG 长图;网页模式生成网页设计图片。

模式选择

认证

string
必填
使用 Authorization: Bearer <token>,其中 <token> 为你的 APIMart API Key。

请求参数

string
必填
固定为 kling-v4-long-image。
boolean
默认值:"false"
是否在提交图片任务前执行内容审核。
  • true:使用 omni-moderation-latest 审核提示词和输入图片
  • false 或不传:不发起审核请求,不增加审核成本与延迟(默认)
string
必填
必填且不能为空白。纯英文最多 166,000 字符,纯中文等最多 71,000 字符;混合语言按比例计算。可描述布局、内容模块、文案、风格和主体。
string
必填
必填,支持 ecommerce(电商详情页)或 webpage(网页设计),不区分大小写。两种模式使用不同的参考图字段,见上表。
string
默认值:"medium"
仅用于 skill: "ecommerce":short、medium(默认)或 long。大致对应 2–5、6–10、11–18 个内容模块,具体内容和高度由生成结果决定。网页模式必须省略此字段,传入会返回 HTTP 400。
string
默认值:"1K"
支持 1K(默认)和 2K,不区分大小写。电商的所有长度均可选择这两个档位,包括 long + 2K。输出宽度分别为 1024 px 和 2048 px,高度随内容变化。不支持 4K。
string[]
仅用于电商模式,必须提供 1–3 张商品图。网页模式必须省略此字段,改用 image_with_roles。传入公网可访问的图片直链;本地文件可先使用图片上传接口,再传返回的 url。
object[]
仅用于网页模式,可省略。style 和 subject 各最多 1 张,可只传其中一种,也可都不传。电商模式必须省略此字段。
integer
每次只生成一张长图。可以省略或传整数 1,其他值返回 HTTP 400。
boolean
可以省略或传 false;true 返回 HTTP 400。
不要传 size、aspect_ratio、width、height、mask_url、sequential_image_generation 或 sequential_image_generation_options。这些字段即使值为 null 或空字符串,也会返回 HTTP 400。

参考图要求与引用

支持 JPG / JPEG / PNG,单张不超过 30 MB,宽、高均至少 300 px,宽高比在 2:5–5:2 之间。链接返回 HTTP 403 / 404 / 410、尺寸或比例不符、文件超限时,同步返回 HTTP 400,不创建任务、不扣生成费用。源站超时等其他取图失败会先受理,随后任务失败并退回预扣费用。 提示词中可用 @Image1、@Image2 等引用参考图。电商模式按 image_urls 顺序编号;网页模式按“风格图、主体图”顺序编号,只传其中一张时就是 @Image1。

请求示例

以下请求均发送到 POST /v1/images/generations。请将示例图片地址替换为实际可访问的直链。

电商长页:long + 2K

网页设计:风格图与主体图

网页设计:仅提示词

查询任务

通过任务查询接口轮询,建议每 10 秒查询一次。保留 task_id,不要因等待较久而重复提交生成请求。
以下为成功结果的结构示意。images 和 url 都是数组,本模型每次返回一张长图。
请在 data.result.images[0].expires_at 指定的 Unix 秒级时间戳之前下载保存,过期后链接失效。
生成通常需要几分钟,long + 2K 的一次实测耗时为 432 秒。estimated_time 当前固定返回 60 秒,不能用作完成倒计时或超时依据。耗时随内容和服务负载变化,实测值不是上限。长图的高度和文件大小随内容变化。一个 long + 2K 样本为 2048×46615、63.9 MB;这些是示例,不是尺寸或文件大小上限。结果可超过 50 MB,请考虑下载和展示大图的开销。

计费

每次请求按所选输出档位收取一张长图费用,另加参考图费用:输出档位单价 + 参考图张数 × 参考图单价。商品图、风格图、主体图均计费,首张参考图也收费。 输出共有以下 8 个档位,价格项为 kling-v4-long-image@<档位>,参考图价格项为 kling-v4-long-image@input。这些是计费档位;生成请求的 resolution 仍只传 1K 或 2K。 提交时预扣,成功后结算,失败全额退回预扣费用。具体单价和账户优惠以价格页为准。

常见错误

以下校验错误在提交时同步返回 HTTP 400,不创建任务、不扣生成费用。读取 error.message 获取原因;已创建任务的失败原因读取 data.error.message。