Kling V2.5 Turbo Pro 图生视频
接口
POST /videos/generations
完整 URL: https://modelfold.ai/v1/videos/generations
鉴权:所有请求都需要
Authorization: Bearer <API_KEY>请求头。
模型参数直接放在 JSON 请求体中,不要套 input。请求等待生成完成后返回 data[].url;支持的媒体模型也可使用 异步创建、轮询及回调。示例素材地址须替换为自己的公开可访问文件。计费及错误说明见 API 网关。
生成任务的输入参数
请求参数
请求体 (application/json)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 用于生成任务的模型名称。必填字段。 - 该端点必须使用 kling/v2-5-turbo-image-to-video-pro 模型 默认值:"kling/v2-5-turbo-image-to-video-pro"。 可选值:kling/v2-5-turbo-image-to-video-pro。 示例:kling/v2-5-turbo-image-to-video-pro。 |
prompt | string | 是 | 本站网关要求传入 prompt,最长 2000 字。视频生成的文本描述(最大长度:2500 字符) maxLength: 2000. 示例:宇航员瞬间穿过散发着光芒的魔法木门完成瞬移。采用手持跟踪镜头,相机保持在宇航员斜后上方 5–10 米处,呈现流畅的第三人称追逐视角。整体画面以超写实为基底,每个场景具备独特艺术风格,场景切换时伴随明亮的传送门光晕闪帧效果,细节拉满,8K 分辨率,搭配史诗级管弦乐背景音。通过高帧率插值实现流畅的动态效果与利落的瞬间转场。特写镜头:身着白色宇航服的宇航员从脚下发光的传送门中急速坠落。<br>第一次转场:乐高风格阿尔卑斯山,高饱和度日光下,雪山峰峦与山谷尽收眼底,宇航员坠落过程中,下一个传送门开启。<br>第二次转场:亚马逊雨林,茂密的树冠与河流在下方延展,宇航员坠落,传送门再次开启。<br>第三次转场:古埃及风格,壁画质感的吉萨金字塔,沙漠与尼罗河铺展于下,宇航员坠落,传送门开启。<br>第四次转场:抽象黑白水墨风格,下方是中国长城,宇航员坠落,最后一个传送门开启。<br>第五次转场:纽约夜景,写实风格的深色城市天际线,璀璨的城市灯光与帝国大厦相映,宇航员优雅悬停。全程相机保持固定距离,轻微环绕运动,流畅的第三人称跟踪视角贯穿始终。每次传送门转场均伴随锐利的闪光,凸显速度感与魔幻的旅程体验,艺术风格与场景位置的切换极具冲击力。。 |
image_url | string | 是 | 用于生成视频的图像 URL(为上传后的文件 URL,非文件内容;支持的类型:image/jpeg、image/png;最大文件大小:10.0MB) 示例:https://file.aiquickdraw.com/custom-page/akr/section-images/1759211376283gfcw5zcy.png。 |
tail_image_url | string | 否 | 视频结尾帧图像 URL(为上传后的文件 URL,非文件内容;支持的类型:image/jpeg、image/png;最大文件大小:10.0MB) 示例:``。 |
duration | string | 是 | 必填。"5" 或 "10"(秒)。 可选值:5 / 10。 示例:5。 |
negative_prompt | string | 否 | 视频中需要规避的元素(最大长度:2496 字符) maxLength: 2496. 示例:模糊、失真、画质低下。 |
cfg_scale | number | 否 | CFG(无分类器引导)系数,用于控制模型贴合提示词的程度(最小值:0,最大值:1,步长:0.1) 默认值:0.5。 minimum: 0. maximum: 1. 示例:0.5。 |
请求示例
bash
curl -X POST "https://modelfold.ai/v1/videos/generations" \
-H "Authorization: Bearer $MODELFOLD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling/v2-5-turbo-image-to-video-pro",
"prompt": "宇航员瞬间穿过散发着光芒的魔法木门完成瞬移。采用手持跟踪镜头,相机保持在宇航员斜后上方 5–10 米处,呈现流畅的第三人称追逐视角。整体画面以超写实为基底,每个场景具备独特艺术风格,场景切换时伴随明亮的传送门光晕闪帧效果,细节拉满,8K 分辨率,搭配史诗级管弦乐背景音。通过高帧率插值实现流畅的动态效果与利落的瞬间转场。特写镜头:身着白色宇航服的宇航员从脚下发光的传送门中急速坠落。\n第一次转场:乐高风格阿尔卑斯山,高饱和度日光下,雪山峰峦与山谷尽收眼底,宇航员坠落过程中,下一个传送门开启。\n第二次转场:亚马逊雨林,茂密的树冠与河流在下方延展,宇航员坠落,传送门再次开启。\n第三次转场:古埃及风格,壁画质感的吉萨金字塔,沙漠与尼罗河铺展于下,宇航员坠落,传送门开启。\n第四次转场:抽象黑白水墨风格,下方是中国长城,宇航员坠落,最后一个传送门开启。\n第五次转场:纽约夜景,写实风格的深色城市天际线,璀璨的城市灯光与帝国大厦相映,宇航员优雅悬停。全程相机保持固定距离,轻微环绕运动,流畅的第三人称跟踪视角贯穿始终。每次传送门转场均伴随锐利的闪光,凸显速度感与魔幻的旅程体验,艺术风格与场景位置的切换极具冲击力。",
"image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1759211376283gfcw5zcy.png",
"duration": "5",
"cfg_scale": 0.5
}'json
{
"model": "kling/v2-5-turbo-image-to-video-pro",
"prompt": "宇航员瞬间穿过散发着光芒的魔法木门完成瞬移。采用手持跟踪镜头,相机保持在宇航员斜后上方 5–10 米处,呈现流畅的第三人称追逐视角。整体画面以超写实为基底,每个场景具备独特艺术风格,场景切换时伴随明亮的传送门光晕闪帧效果,细节拉满,8K 分辨率,搭配史诗级管弦乐背景音。通过高帧率插值实现流畅的动态效果与利落的瞬间转场。特写镜头:身着白色宇航服的宇航员从脚下发光的传送门中急速坠落。\n第一次转场:乐高风格阿尔卑斯山,高饱和度日光下,雪山峰峦与山谷尽收眼底,宇航员坠落过程中,下一个传送门开启。\n第二次转场:亚马逊雨林,茂密的树冠与河流在下方延展,宇航员坠落,传送门再次开启。\n第三次转场:古埃及风格,壁画质感的吉萨金字塔,沙漠与尼罗河铺展于下,宇航员坠落,传送门开启。\n第四次转场:抽象黑白水墨风格,下方是中国长城,宇航员坠落,最后一个传送门开启。\n第五次转场:纽约夜景,写实风格的深色城市天际线,璀璨的城市灯光与帝国大厦相映,宇航员优雅悬停。全程相机保持固定距离,轻微环绕运动,流畅的第三人称跟踪视角贯穿始终。每次传送门转场均伴随锐利的闪光,凸显速度感与魔幻的旅程体验,艺术风格与场景位置的切换极具冲击力。",
"image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1759211376283gfcw5zcy.png",
"duration": "5",
"cfg_scale": 0.5
}响应
200 — 生成完成。usage 返回实际计费明细;结果地址仅作结构示例。
json
{
"ok": true,
"created": 1792134000,
"data": [
{
"url": "https://modelfold.ai/uploads/outputs/result.mp4"
}
],
"usage": {}
}