Kling V4 Flash

使用模型 kling-v4-flash 在 APIMaster 创建异步视频任务。先在控制台创建 API Key，调用地址为 https://apimaster.ai/v1。

能力对照

能力	kling-v4	kling-v4-flash
文生视频	支持	支持
图生视频	首帧、中间帧、尾帧，最多 10 张	仅一张首帧
Omni 图像参考	首帧、中间帧、尾帧和参考图	首帧和参考图
参考视频、视频编辑	支持	支持
自定义元素、预设元素	支持	支持
音色参考、音色管理	支持	不支持
输出分辨率	720p、1080p，默认 1080p	仅 720p
输出时长	3–30 整数秒	3–20 整数秒
输入视频时长	单条及合计均为 3–30 秒	单条及合计均为 3–20 秒
输出帧率	24 fps	24 fps

本页原生工作流使用 settings、contents、options。既有 /videos/generations 扁平便捷格式继续使用其原有参数与默认值，不能将两套格式混用。Flash 输出上限为 20 秒；V4 上限为 30 秒。

鉴权和接口总表

请求头为 Authorization: Bearer YOUR_APIMASTER_KEY、Content-Type: application/json。提交时建议使用唯一的 Idempotency-Key；响应超时后使用相同 Key 恢复，避免重复付费生成。

以下路径均相对于 https://apimaster.ai/v1，MODEL 替换成 kling-v4-flash。

方法	路径	功能
POST	/kling/MODEL/text-to-video	文生视频
POST	/kling/MODEL/image-to-video	图生视频
POST	/kling/MODEL/omni-video	多模态参考生成、视频编辑
GET	/videos/{task_id}	查询本账号的视频或资源任务
GET	/videos/{task_id}/content	下载已完成视频，需要鉴权
POST	/kling/MODEL/create-element	创建多图元素或视频人物元素
GET	/kling/MODEL/elements	分页列出本账号的元素任务
GET	/kling/MODEL/elements/{resource_id}	查询本账号元素
GET	/kling/MODEL/elements/presets	预设元素库
DELETE	/kling/MODEL/elements/{resource_id}	删除本账号的自定义元素

自定义资源 ID 是 APIMaster 返回的 task_… 句柄，预设资源 ID 带 preset: 前缀。引用和删除时使用返回值，不填写其他账号的原始资源 ID。自定义素材按账号和创建路由隔离，不可跨账号查询或引用；原创建路由不可用时返回错误，不会悄悄替换为其他素材。

生成请求完整参数

字段	类型	必填	说明
model	string	原生路径可省略	提供时必须与 URL 中的 kling-v4-flash 一致
prompt	string	文生视频必填	描述场景、人物、动作、镜头、正向和负向要求；仅用于文生路径
contents	object[]	图生、Omni 必填	按顺序组织素材，必须恰有一个 prompt 项
settings	object	否	输出分辨率、时长、画幅、声音设置，见下表
options	object	否	回调、客户端引用、水印设置
notifications	object	否	APIMaster 已验证任务 Webhook；见回调指南
client_reference_id	string	否	APIMaster 回调中的业务关联值，最多 128 字节

纯英文提示词最多 26,000 字符，纯非英文最多 11,000 字符；混合输入须满足 英文字符数 / 26000 + 非英文字符数 / 11000 <= 1。通过 @id 引用素材，并明确要求保留的外观、动作、背景、音色或镜头节奏。多阶段动作按时间顺序描述。仅在提示词里写素材名称不会自动上传素材。

contents 项

字段	类型	必填条件	说明
type	string	所有项	内容类型，见下表
text	string	prompt	提示词内容
url	string	图像、视频类型	可公开访问的素材 URL；图像还可使用 Base64
id	string	条件必填	当前任务内唯一，通过 @id 引用；元素和音色必填，V4 多张中间帧或多张参考图也须提供
element_id	string	element	本账号元素句柄或返回的预设 ID
voice_id	string	voice	本账号音色句柄、元素绑定音色句柄或预设 ID；仅 V4

type	用途	图生视频	Omni
prompt	生成描述	必须	必须
first_frame	固定首帧	两模型	两模型
middle_frame	按时间顺序给中间帧	仅 V4	仅 V4
last_frame	固定尾帧	仅 V4	仅 V4
refer_image	外观、主体、背景、风格参考，不锁定帧	不支持	两模型
feature_video	动作、镜头、节奏参考	不支持	两模型
base_video	待编辑视频	不支持	两模型，最多一条
element	持久的人物、物品、场景元素	不支持	两模型
voice	音色参考	不支持	仅 V4

首帧图须位于所有图像之前，尾帧图须位于所有图像之后。中间帧按出现顺序排列。Flash 不支持中间帧和尾帧。

settings

字段	类型	必填	取值、默认值和约束
resolution	string	否	仅 720p，默认 720p
duration	integer	否	3–20 秒；显式参数优先于提示词中的时长
aspect_ratio	string	否，仅文生和 Omni	21:9、16:9、9:16、1:1、4:3、3:4；Omni 额外支持 adaptive。文生默认 16:9，Omni 默认 adaptive；图生按图片输入确定
audio	string	否，仅 Omni	native 默认生成匹配音频；original 保留源视频音频

original 必须提供 base_video 或 feature_video；优先取 base_video 的音频，否则取第一条 feature_video 的音频，不能同时引用音色。原生格式不提供 audio=false 静音开关。

省略 duration 时，优先采用提示词明确指定的时长；提示词也没有指定时，Omni 存在 base_video 则按其时长四舍五入取整，否则默认 10 秒。最终输出计费时长使用任务用量回执，而不是直接把下载后的视频容器时长当成计费时长。

Omni 采用 adaptive 时，先识别提示词中明确的画幅；没有时依次参考 base_video、关键帧（首帧优先）、单条 feature_video。多条 feature_video 或没有适用素材时默认 16:9。显式传入非 adaptive 的画幅优先于提示词画幅。

options

字段	类型	必填	说明
callback_url	string	否	原生任务状态回调地址；需要 APIMaster 公共任务 ID 和投递记录时使用 notifications
external_task_id	string	否	客户端关联值；查询时使用返回的 task ID，安全重试使用 Idempotency-Key
watermark_info	object	否	是否同时生成带水印版本
watermark_info.enabled	boolean	否	默认 false；显式 false 会保留，true 请求额外水印结果；不支持自定义水印图案

素材限制

类别	限制
生成图像	JPG/JPEG/PNG，每张最多 30 MB，宽高至少 300px，比例 2:5–5:2，最多 10 张
生成输入视频	MP4/MOV，每条最多 300 MB，宽高分别为 700–4553px，总像素面积不超过 8,294,400，24–60fps，比例 2:5–5:2
V4 输入时长	每条及归一化后合计均为 3–30 秒
Flash 输入时长	每条及归一化后合计均为 3–20 秒
视频数量	参考视频与视频人物元素合计最多 5 个，base_video 最多 1 条
元素数量	最多 7 个，视频人物元素最多 3 个
音色数量	最多 3 个，仅 V4
总素材数量	图像、视频、元素和音色合计最多 15 个，prompt 不计入

视频人物元素会占用视频数量并贡献输入视频时长。元素创建的图像限制与生成图像不同，见后文。URL 须在任务素材摄取期间保持可访问，不能依赖 Cookie 或登录。

调用示例

文生视频

curl "https://apimaster.ai/v1/kling/kling-v4-flash/text-to-video" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{"prompt":"A paper boat floats on a quiet pond, gentle water sounds.","settings":{"duration":3,"resolution":"720p","aspect_ratio":"16:9"},"options":{"watermark_info":{"enabled":false}}}'

图生视频

向 POST https://apimaster.ai/v1/kling/kling-v4-flash/image-to-video 提交：

{
  "contents":[
    {"type":"prompt","text":"Start from @first. Slowly move the camera toward the subject."},
    {"type":"first_frame","url":"https://YOUR_PUBLIC_HOST/first.jpg","id":"first"}
  ],
  "settings":{"duration":5,"resolution":"720p"}
}

V4 可继续加入 middle_frame 和 last_frame；Flash 只能提供一张 first_frame。

Omni 编辑与多模态参考

向 POST https://apimaster.ai/v1/kling/kling-v4-flash/omni-video 提交：

{
  "contents":[
    {"type":"prompt","text":"Edit @source. Replace the main object with @object, preserve camera movement and background."},
    {"type":"base_video","url":"https://YOUR_PUBLIC_HOST/source.mp4","id":"source"},
    {"type":"refer_image","url":"https://YOUR_PUBLIC_HOST/object.png","id":"object"}
  ],
  "settings":{"duration":5,"resolution":"720p","aspect_ratio":"adaptive","audio":"original"}
}

仅参考镜头或动作而不编辑源视频时，把 base_video 改成 feature_video 并明确用途。引用元素时添加 {"type":"element","element_id":"task_YOUR_ELEMENT","id":"character"}，提示词中用 @character 指定主体。

元素管理

向 POST https://apimaster.ai/v1/kling/kling-v4-flash/create-element 提交。创建是异步任务；完成后把返回的 resource.element_id 用于 Omni 引用。预设库元素无需创建。

字段	类型	必填条件	说明
element_name	string	必填	1–20 字符
element_description	string	必填	1–100 字符
reference_type	string	必填	image_refer 多图元素，或 video_refer 视频人物元素
element_image_list	object	image_refer	正面图与其他参考图
element_image_list.frontal_image	string	图像元素	正面图 URL 或 Base64
element_image_list.refer_images	object[]	图像元素	1–3 张不同角度或细节图，不与正面图重复
element_image_list.refer_images[].image_url	string	每张参考图	图像 URL 或 Base64
element_video_list	object	video_refer	视频人物素材，不与图像素材字段混用
element_video_list.refer_videos	object[]	视频元素	恰好 1 条
element_video_list.refer_videos[].video_url	string	每条视频	MP4/MOV 公共 URL
element_voice_id	string	否	绑定已有的自定义或预设音色；图像元素绑定音色仅适用于人物/类人元素
tag_list	object[]	否	元素分类
tag_list[].tag_id	string	每个标签	o_101 热门、o_102 人物、o_103 动物、o_104 物品、o_105 服装、o_106 场景、o_107 特效、o_108 其他
callback_url	string	否	原生任务回调
external_task_id	string	否	客户端关联值；轮询使用返回的公共 task ID

创建元素的图像须为 JPG/JPEG/PNG，每张最多 10 MB，宽高至少 300px，比例 1:2.5–2.5:1。视频人物素材仅支持写实类人角色：3–8 秒、1080p、16:9 或 9:16、MP4/MOV、最多 200 MB。视频含人声时可能自动定制并绑定音色，返回的绑定音色句柄以 .voice 结尾。

{
  "element_name":"Blue mascot",
  "element_description":"A fictional blue mascot from multiple angles",
  "reference_type":"image_refer",
  "element_image_list":{
    "frontal_image":"https://YOUR_PUBLIC_HOST/front.png",
    "refer_images":[{"image_url":"https://YOUR_PUBLIC_HOST/side.png"}]
  },
  "tag_list":[{"tag_id":"o_104"}]
}

自定义列表：GET …/elements?pageNum=1&pageSize=30，pageNum 为 1–1000、pageSize 为 1–500。预设列表：GET …/elements/presets。查询资源：GET …/elements/task_YOUR_ELEMENT。删除自定义元素：DELETE …/elements/task_YOUR_ELEMENT；预设元素不可删除，删除不清除历史视频或消费记录。

音色

本模型不支持音色输入与音色管理。

任务、下载与错误

创建成功返回公共任务 ID：

{"id":"task_EXAMPLE","task_id":"task_EXAMPLE","object":"video","model":"kling-v4-flash","status":"queued"}

同一账号携带 API Key 轮询 GET https://apimaster.ai/v1/videos/task_EXAMPLE。状态为 queued、in_progress、completed、failed。视频完成后返回鉴权下载 URL；元素和音色任务返回带本账号资源句柄的对象。资源列表也包含仍在处理或失败的创建任务。

curl "https://apimaster.ai/v1/videos/task_EXAMPLE" -H "Authorization: Bearer $APIMASTER_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_EXAMPLE/content" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" -o output.mp4

建议每 3–5 秒轮询并适当退避。不要因为任务尚未完成就重新生成。提交超时后使用原 Idempotency-Key 恢复；同一个 Key 改变请求体会被拒绝。下载链接有有效期，完成后请及时保存视频。

情况	处理
参数、类型、模型与路径冲突	HTTP 400，修正后再提交
Key 无效、模型权限不足	检查账号与模型访问权限
资源不存在、属于其他账号	拒绝访问或引用
素材无法读取、签名 URL 失效	修复可访问性，按失败状态决定是否重新提交
频率或并发限制	退避，已受理任务继续轮询，不重复创建
已受理任务最终失败	状态 failed，进入正常任务退款流程
视频完成而用量/回执尚未就绪	继续轮询，待最终用量可验证后结算

计费

当前售价以模型卡和账号实际折扣为准。图像参考、图像元素、音色不自动计入输入视频；视频人物元素需要计入。

无视频输入：计费秒数 = 输出计费时长
有视频输入：计费秒数 = 输出计费时长 + max(输入计费时长, 输出计费时长)

有视频输入采用单独的每秒费率。输入视频时长包括 feature_video、base_video、视频人物元素，经系统归一化后可能与源文件略有不同。短输入视频也可能按输出时长两倍计费，不能只看输出长度估算费用。

网关先预扣，再按完成回执中的用量结算，退回多余预扣。省略 duration 时模型可能从提示词决定时长，因此预扣值可能大于实际费用。元素创建、音色创建是独立操作，不应误算为视频时长；音色创建按次计费，视频折扣不代表音色创建也享受相同折扣。

最终实扣与视频预览请查看控制台消费日志。成功响应和视频可播放属于功能交付证据，不等于独立模型身份指纹验证。

---

请求了带水印版本时，可使用 GET /v1/videos/{task_id}/content?watermark=true 下载该版本；普通 content 端点返回原始版本，两者均需认证。

既有便捷接口

kling-v4-flash 的 APIMaster 网关契约，核查日期 2026-11-07。APIMaster 支持文生、单首帧图生、图片与视频参考、编辑和续写；输出统一为 720p、24fps、3–20 秒，与普通 Kling V4 是不同模型。

Kling V4 Flash

接口与认证

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

字段与限制

使用 JSON 和 Authorization: Bearer YOUR_API_KEY。model 固定 kling-v4-flash。除单首帧图生外，prompt 均必填。duration 与 seconds 仅接受 3–20 的 JSON 整数，默认 5；null 视为省略，显式 0 拒绝。两个别名同时出现时必须都有效且相等。编辑省略时长时，使用输入视频流时长向上取整。resolution 仅支持 720p。aspect_ratio（兼容别名 size）支持 16:9、9:16、1:1、21:9；仅参考模式支持 auto。文生默认 16:9，参考默认 auto，编辑省略比例则跟随输入。图生及续写拒绝非空 aspect_ratio/size，需要其他比例请先裁剪首帧。audio 仅允许 true，watermark 仅允许 false。

参数	JSON 类型	是否必填	默认值	用途、取值与限制
model	string	必填	kling-v4-flash	固定传 kling-v4-flash。五种操作共用此模型 ID；kling-v4 是另一个模型，不能混用。
prompt	string	按模式	—	描述画面、动作或修改目标。文生、参考、编辑、续写必填；仅单首帧图生可以省略。用 @Image1、@Video1 等引用素材，图片与视频各自按数组顺序从 1 编号；编辑源视频为 @Video1。
duration	integer / null	可选	5	输出时长，使用 3–20 的 JSON 整数，通常默认 5 秒。编辑省略两个时长字段时，跟随输入视频流时长并向上取整；续写表示新增片段时长。null 视为省略，0、非整数数值及字符串数字均拒绝；实际文件多约一帧时仍按该整数计费。
seconds	integer / null	可选	—	duration 的兼容别名，范围和省略规则相同。建议只传一个；两个都传时必须各自有效且相等，否则返回 400。
resolution	string	可选	720p	输出清晰度档位，仅支持 720p。不代表输出短边始终为 720 像素；不支持 1080p，也不能通过 mode 切换画质。
aspect_ratio	string	可选	按模式	文生、参考、编辑可用 16:9、9:16、1:1、21:9；仅参考还支持 auto。文生默认 16:9、参考默认 auto、编辑默认跟随源视频。图生与续写不接受非空值；空字符串视为省略。
size	string	可选	—	aspect_ratio 的兼容别名，表示宽高比，不是清晰度或 1280x720 像素尺寸。两个字段都传时必须相同；单首帧图生及续写应同时省略这两个字段。
image_urls	string[]	按模式	—	公开图片 URL 数组。自动模式只接受一张首帧；仅用图片做参考时须明确设置 reference。参考/编辑最多 10 张，与 reference_image 角色图片合并计数。图生不能与其他首帧字段混用；续写不接受图片。
first_frame_image	string	按模式	—	单张首帧的公开图片 URL。与单个 image_urls 或单个 first_frame 角色条目是三选一关系，不能重复提供首帧。用于图生，此时提示词可省略。图片宽、高均至少 300px，宽高比 2:5–5:2；需要其他构图时先裁图。
image_with_roles	{url, role}[]	按模式	—	对象数组，每项必含 url（公开 HTTP(S) 图片 URL）和 role。first_frame 用于唯一首帧；reference_image 用于参考/编辑。尾帧、中间帧、关键帧均不支持。两种图片字段合计最多 10 张参考图，参考图与参考视频总计最多 15 个素材。
video_url	string	按模式	—	单条源视频公开 URL，仅用于明确指定的 edit / extend，与 video_urls 互斥。编辑输入须为 MP4/MOV、视频流时长 3–20 秒，宽和高分别为 700–4553px。续写从源视频最后一帧生成，只返回新增片段；此处不能填任务 ID 或会话 ID。
video_urls	string[]	按模式	—	参考视频 URL 数组，最多 5 条；每条 MP4/MOV、视频流时长至少 3 秒，宽和高分别为 700–4553px，总时长不超过 20 秒。明确设置编辑/续写时也可传恰好 1 条代替 video_url。超长直接拒绝，不自动截取；参考模式可由此字段自动识别。
omni_reference_task_type	string	可选	auto	auto 根据素材识别文生、首帧图生或参考；reference 将图片视为参考图且要求有参考素材；edit / extend 要求恰好一条源视频。仅传 video_url 而未明确编辑/续写无效；自动模式下两张普通图片不会自动变成参考模式。
audio_setting	string	可选	auto	仅用于含参考视频的参考模式。auto 重新生成声音；origin 保留第一条参考视频原声，若其没有音轨，输出也没有音轨。编辑重新生成声音，应省略此字段；文生、仅图片参考及续写也不支持。它不是音频 URL 参数。
audio	boolean	可选	true	兼容布尔参数，只能省略或传 true；false 拒绝。它不控制是否保留原声，应在支持的模式下使用 audio_setting。不支持单独上传音频作为参考。
watermark	boolean	可选	false	兼容布尔参数，只能省略或传 false；true 拒绝。此参数不提供对输入素材去水印的服务。

使用不含嵌入认证信息的公开 HTTP(S) 直链，不支持 base64、本地路径或任务 ID。上游此页未另行承诺图片文件格式及字节上限。网关每条被探测的参考/编辑视频最多读取 100MiB，这不是对所有上游上传素材的统一大小承诺。

模式与素材

生成模式	选择方式与必需素材	默认行为与不支持项
文生视频	不传图片/视频，提示词必填；任务类型省略或为 auto。	默认 5 秒、16:9；不支持参考音频或 audio_setting。
单首帧图生视频	通过三种首帧字段之一提供恰好一张图片，提示词可省略。	默认 5 秒，跟随图片比例；省略 aspect_ratio / size，不支持尾帧。
参考生视频	reference + 图片，或使用 reference_image 角色、video_urls；提示词必填。	默认 5 秒、auto；图片≤10、视频≤5、合计≤15；带视频才能用 audio_setting。
视频编辑	明确 edit + 恰好一条源视频，提示词必填；可附最多 10 张参考图。	时长默认随输入向上取整，比例默认随输入；不接受帧角色或 audio_setting。
视频续写	明确 extend + 恰好一条源视频，提示词必填。	默认新增 5 秒，比例随输入；不接受图片、比例覆盖或 audio_setting；不沿用编辑/参考的最小尺寸及最小时长检查。

omni_reference_task_type 支持 auto、reference、edit、extend。单张 image_urls、first_frame_image 或恰好一个 first_frame 角色用于图生；多张参考图需要明确 reference 或 reference_image 角色，auto 下直接给两张 image_urls 会拒绝。video_urls 默认用于参考，edit/extend 时可提供一条。video_url 必须明确 edit/extend，且与 video_urls 互斥。编辑及续写需要一条视频；编辑可附参考图，续写不接受图片或 audio_setting，且只返回新增片段。续写输入应为公开可访问的源视频 URL，本接口不接受平台任务 ID 或上游会话 ID 作为续作参数。

素材使用不含认证信息的公开 HTTP(S) 直链。参考图/编辑图最多 10 张，图片加参考视频合计最多 15 个；图片宽高均至少 300 像素，宽高比 2:5–5:2。参考视频最多 5 条 MP4/MOV，每条至少 3 秒，合计不超过 20 秒；编辑仅一条 3–20 秒视频，宽和高分别须在 700–4553 像素之间。网关单条探测最多读取 100 MiB，按视频流时长计量，不按容器或音轨。续写输入不受上述编辑/参考尺寸与最小时长检查限制。上游还会检查素材几何尺寸，拒绝受理的请求无最终生成费用。audio_setting=origin 仅适用于带视频的参考模式，保留首条参考视频声音，无音轨则输出静音；auto 重新生成声音。编辑重新生成声音，不支持该字段。音频 URL、尾帧/中间帧、关键帧、negative_prompt、mode、seed、多镜头及主体/音色列表均不支持。

输出像素与帧率

比例 / 模式	上游公布的输出像素	帧率
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
单首帧图生视频	跟随首帧比例，总像素约 0.92MP，例如 2:5 首帧约为 604×1516。	24 fps

这里是输出规格，不是输入素材的尺寸要求。例如 21:9 成片高度为 628px，不能直接满足参考/编辑输入至少 700px 的门槛；再次用于这些模式时需准备合规源素材，续写则不受该最小尺寸检查限制。实际时长可能比请求整数多约一帧。

不执行生成的示例

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

计费规则

官方名义基础价为 720P 输出每秒 $0.094，720P-input 每计费秒 $0.0628。文生、图生、仅图片参考以及续写按输出/新增片段秒数计费。视频参考与编辑按 输出 + max(输入, 输出) 计费：先将全部输入视频流时长相加，再对输入总时长向上取整。例如输入 3.04 秒、输出 3 秒，按 3 + max(4,3) = 7 秒乘视频输入档单价，不是只收 3 秒。两条 3.04 秒输入合计 6.08，先取整为 7 再代入。成片可能多约一帧，输出仍按请求的整数秒计费。资源包折扣与名义基础价分开，实际售价还取决于账户/模型规则，以模型卡和最终消费记录为准。生成失败退还预扣，停止轮询不会取消任务；网络超时或受理不明不代表可以重新生成。

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

轮询、错误与安全重试

首次成功提交返回 HTTP 200、公开 task_id 和 queued。通过 GET /v1/videos/{task_id} 查询 queued/in_progress/completed/failed，容忍暂时 unknown。完成后的 url 与 metadata.url 是需要 Bearer 的代理地址，也可用 GET /v1/videos/{task_id}/content 下载。任务失败提供 error.code=generation_failed 与脱敏原因，参数错误使用 HTTP 400。每次新操作携带独立 Idempotency-Key（8–128 个可见 ASCII 字符，无空格）；同账户、同键、同请求重放返回 HTTP 202，不重复生成或预扣，改正文返回 409。用原请求头调用 GET /v1/video-submissions/by-key 查回执；accepted 且 task_ready=true 时轮询 task_id，pending/submitting 或尚未就绪时继续等待；acceptance_unknown 时保存原键并联系支持，禁止自动换键重发。404 并不证明原请求未受理。此为网关幂等，不代表上游按键查单；键至少保留 30 天。最终客户费用请按 other.task_id 查消费日志，轮询响应不保证包含最终账单。本模型不支持 /v1/videos/quote。下方仅为不执行的 JSON 示例，请替换素材地址；新操作换新键，重试才保留同一键与正文。

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}