金山云-文档中心-可灵AI

星流平台

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

星流平台

模型API服务

API文档

视频生成模型

可灵AI

最近更新时间：2026-01-28 15:55:22



文生视频

请求参数

字段	类型	必填	默认值	描述
model_name	string	必填	无	模型名称枚举值：kling-v2-1-master, kling-v2-5-turbo,kling-v2-6
prompt	string	必填	无	正向文本提示词不能超过2500个字符
negative_prompt	string	可选	无	负向文本提示词不能超过2500个字符
sound	string	可选	off	生成视频时是否同时生成声音枚举值：on，off 仅V2.6及后续版本模型支持当前参数
mode	string	可选	std	生成视频的模式枚举值：std，pro 其中std：标准模式（标准），基础模式，性价比高其中pro：专家模式（高品质），高表现模式，生成视频质量更佳
camera_control	object	可选	空	控制摄像机运动的协议（如未指定，模型将根据输入的文本/图片进行智能匹配）
camera_control type	string	可选	无	预定义的运镜类型枚举值：“simple”, “down_back”, “forward_up”, “right_turn_forward”, “left_turn_forward” simple：简单运镜，此类型下可在"config"中六选一进行运镜 down_back：镜头下压并后退 ➡️ 下移拉远，此类型下config参数无需填写 forward_up：镜头前进并上仰 ➡️ 推进上移，此类型下config参数无需填写 right_turn_forward：先右旋转后前进 ➡️ 右旋推进，此类型下config参数无需填写 left_turn_forward：先左旋并前进 ➡️ 左旋推进，此类型下config参数无需填写
camera_control config	object	可选	无	包含六个字段，用于指定摄像机在不同方向上的运动或变化当运镜类型指定simple时必填，指定其他类型时不填以下参数6选1，即只能有一个参数不为0，其余参数为0
camera_control horizontal	float	可选	无	水平运镜，控制摄像机在水平方向上的移动量（沿x轴平移）取值范围：[-10, 10]，负值表示向左平移，正值表示向右平移
camera_control vertical	float	可选	无	垂直运镜，控制摄像机在垂直方向上的移动量（沿y轴平移）取值范围：[-10, 10]，负值表示向下平移，正值表示向上平移
camera_control pan	float	可选	无	水平摇镜，控制摄像机在水平面上的旋转量（绕y轴旋转）取值范围：[-10, 10]，负值表示绕y轴向左旋转，正值表示绕y轴向右旋转
camera_control tilt	float	可选	无	垂直摇镜，控制摄像机在垂直面上的旋转量（沿x轴旋转）取值范围：[-10, 10]，负值表示绕x轴向下旋转，正值表示绕x轴向上旋转
camera_control roll	float	可选	无	旋转运镜，控制摄像机的滚动量（绕z轴旋转）取值范围：[-10, 10]，负值表示绕z轴逆时针旋转，正值表示绕z轴顺时针旋转
camera_control zoom	float	可选	无	变焦，控制摄像机的焦距变化，影响视野的远近取值范围：[-10, 10]，负值表示焦距变长、视野范围变小，正值表示焦距变短、视野范围变大
aspect_ratio	string	可选	16:9	生成视频的画面纵横比（宽:高）枚举值：16:9, 9:16, 1:1
duration	string	可选	5	生成视频时长，单位s 枚举值：5，10
external_task_id	string	可选	无	自定义任务ID 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询请注意，单用户下需要保证唯一性

调用示例

curl --location 'https://kspmas.ksyun.com/v1/videos/text2video' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer $KSC_API_KEY' \
  -d '{
    "model_name": "kling-v2-5-turbo",
    "prompt":"宇航员躺下睡着了",
    "negative_prompt":"不要畸形，不要多余的手指，不要模糊，不要过暗，不要扭曲",
    "mode":"pro"
    "duration":5
  }'

响应体

{
  "code": 0, //错误码；具体定义见错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", //任务ID，系统生成
    "task_info": {
      //任务创建时的参数信息
      "external_task_id": "string" //客户自定义任务ID
    },
    "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

图生视频

首尾帧视频生成仅kling-2-5-turbo的pro模式及kling-v2-6支持

请求参数

字段	类型	必填	默认值	描述
model_name	string	可选	kling-v1	模型名称枚举值： kling-v2-1-master, kling-v2-5-turbo,kling-v2-6
image	string	必须	空	参考图像支持传入图片Base64编码或图片URL（确保可访问）请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。示例：正确的Base64编码参数： `iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==` 错误的Base64编码参数（包含data:前缀）： `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==` 请仅提供Base64编码的字符串部分，以便系统能够正确处理和解析您的数据。图片格式支持.jpg / .jpeg / .png 图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间 image 参数与 image_tail 参数至少二选一，二者不能同时为空 image + image_tail参数、dynamic_masks/static_mask参数、camera_control参数三选一，不能同时使用
image_tail	string	可选	空	参考图像 - 尾帧控制支持传入图片Base64编码或图片URL（确保可访问）请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。示例：正确的Base64编码参数： `iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==` 错误的Base64编码参数（包含data:前缀）： `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==` 请仅提供Base64编码的字符串部分，以便系统能够正确处理和解析您的数据。图片格式支持.jpg / .jpeg / .png 图片文件大小不能超过10MB，图片宽高尺寸不小于300px image 参数与 image_tail 参数至少二选一，二者不能同时为空 image+image_tail参数、dynamic_masks/static_mask参数、camera_control参数三选一，不能同时使用首尾帧生成功能仅kling-v2-5-turbo的pro模式支持
prompt	string	可选	无	正向文本提示词不能超过2500个字符
negative_prompt	string	可选	空	负向文本提示词不能超过2500个字符
sound	string	可选	off	生成视频时是否同时生成声音枚举值：on，off 仅V2.6及后续版本模型支持当前参数
voice_list	array	可选	无	生成视频时所引用的音色的列表一次视频生成任务至多引用2个音色当voice_list参数不为空且prompt参数中引用音色ID时，视频生成任务按“有指定音色”计量计费 voice_id参数值通过音色定制接口返回，也可使用系统预置音色非对口型API的voice_id `"voice_list":[ {"voice_id":"voice_id_1"}, {"voice_id":"voice_id_2"} ]` 仅V2.6及后续版本模型支持当前参数
mode	string	可选	std	生成视频的模式枚举值：std，pro 其中std：标准模式（标准），基础模式，性价比高其中pro：专家模式（高品质），高表现模式，生成视频质量更佳
static_mask	string	可选	无	静态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片） “运动笔刷”能力包含“动态笔刷 dynamic_masks”和“静态笔刷 static_mask”两种支持传入图片Base64编码或图片URL（确保可访问，格式要求同 image 字段）图片格式支持.jpg / .jpeg / .png 图片长宽比必须与输入图片相同（即image字段），否则任务失败（failed） static_mask 和 dynamic_masks.mask 这两张图片的分辨率必须一致，否则任务失败（failed）
dynamic_masks	array	可选	无	动态笔刷配置列表可配置多组（最多6组），每组包含“涂抹区域 mask”与“运动轨迹 trajectories”序列不同模型版本、视频模式支持范围不同，详见当前文档3-0能力地图
dynamic_masks mask	string	可选	无	动态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片）支持传入图片Base64编码或图片URL（确保可访问，格式要求同 image 字段）图片格式支持.jpg / .jpeg / .png 图片长宽比必须与输入图片相同（即image字段），否则任务失败（failed） static_mask 和 dynamic_masks.mask 这两张图片的分辨率必须一致，否则任务失败（failed）
dynamic_masks trajectories	array	可选	无	运动轨迹坐标序列生成5s的视频，轨迹长度不超过77，即坐标个数取值范围：[2, 77] 轨迹坐标系，以图片左下角为坐标原点注1：坐标点个数越多轨迹刻画越准确，如只有2个轨迹点则为这两点连接的直线注2：轨迹方向以传入顺序为指向，以最先传入的坐标为轨迹起点，依次链接后续坐标形成运动轨迹
dynamic_masks trajectories x	int	可选	无	轨迹点横坐标（在像素二维坐标系下，以输入图片image左下为原点的像素坐标）
dynamic_masks trajectories y	int	可选	无	轨迹点纵坐标（在像素二维坐标系下，以输入图片image左下为原点的像素坐标）
camera_control	object	可选	空	控制摄像机运动的协议（如未指定，模型将根据输入的文本/图片进行智能匹配）不同模型版本、视频模式支持范围不同，详见当前文档3-0能力地图
camera_control type	string	可选	无	预定义的运镜类型枚举值：“simple”, “down_back”, “forward_up”, “right_turn_forward”, “left_turn_forward” simple：简单运镜，此类型下可在"config"中六选一进行运镜 down_back：镜头下压并后退 ➡️ 下移拉远，此类型下config参数无需填写 forward_up：镜头前进并上仰 ➡️ 推进上移，此类型下config参数无需填写 right_turn_forward：先右旋转后前进 ➡️ 右旋推进，此类型下config参数无需填写 left_turn_forward：先左旋并前进 ➡️ 左旋推进，此类型下config参数无需填写
camera_control config	object	可选	无	包含六个字段，用于指定摄像机在不同方向上的运动或变化当运镜类型指定simple时必填，指定其他类型时不填以下参数6选1，即只能有一个参数不为0，其余参数为0
config horizontal	float	可选	无	水平运镜，控制摄像机在水平方向上的移动量（沿x轴平移）取值范围：[-10, 10]，负值表示向左平移，正值表示向右平移
config vertical	float	可选	无	垂直运镜，控制摄像机在垂直方向上的移动量（沿y轴平移）取值范围：[-10, 10]，负值表示向下平移，正值表示向上平移
config pan	float	可选	无	水平摇镜，控制摄像机在水平面上的旋转量（绕y轴旋转）取值范围：[-10, 10]，负值表示绕y轴向左旋转，正值表示绕y轴向右旋转
config tilt	float	可选	无	垂直摇镜，控制摄像机在垂直面上的旋转量（沿x轴旋转）取值范围：[-10, 10]，负值表示绕x轴向下旋转，正值表示绕x轴向上旋转
config roll	float	可选	无	旋转运镜，控制摄像机的滚动量（绕z轴旋转）取值范围：[-10, 10]，负值表示绕z轴逆时针旋转，正值表示绕z轴顺时针旋转
config zoom	float	可选	无	变焦，控制摄像机的焦距变化，影响视野的远近取值范围：[-10, 10]，负值表示焦距变长、视野范围变小，正值表示焦距变短、视野范围变大
duration	string	可选	5	生成视频时长，单位s 枚举值：5，10
external_task_id	string	可选	无	自定义任务ID 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询请注意，单用户下需要保证唯一性

调用示例

curl --location 'https://kspmas.ksyun.com/v1/videos/image2video' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer $KSC_API_KEY' \
  -d '{
    "model_name": "kling-v2-5-turbo",
    "mode": "pro",
    "duration": "5",
    "image": "https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg",
    "prompt": "宇航员躺下睡着了"
}'

响应体

{
  "code": 0, //错误码；具体定义见错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", //任务ID，系统生成
    "task_info": {
      //任务创建时的参数信息
      "external_task_id": "string" //客户自定义任务ID
    },
    "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

动作控制

请求参数

字段	类型	必填	默认值	描述
model_name	string	必选	无	模型名称枚举值：kling-v2-6
prompt	string	可选	空	文本提示词，可包含正向描述和负向描述可通过提示词为画面增加元素、实现运镜效果不能超过2500个字符
image_url	string	必须	无	参考图像，生成视频中的人物、背景等元素均已参考图为准视频内容需满足以下要求：人物比例尽量与参考动作比例一致，尽量避免全身动作驱动半身人物进行生成人物需要漏出清晰的上半身或全身的肢体及头部，避免遮挡画面中人物避免存在极端朝向，比如倒立、平卧等。人物占画面比例不得太低支持真实/风格化的角色（包括人物/类人动物/部分纯动物/部分类人肢体比例的角色）通过包含支持传入图片Base64编码或图片URL（确保可访问）请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。示例：正确的Base64编码参数： `1iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==` 错误的Base64编码参数（包含data:前缀）： `1data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==` 请仅提供Base64编码的字符串部分，以便系统能够正确处理和解析您的数据。图片格式支持.jpg / .jpeg / .png 图片文件大小不能超过10MB，图片宽高尺寸介于300px～65536px，图片宽高比介于1:2.5 ~ 2.5:1之间
video_url	string	必须	无	参考视频的获取链接。生成视频中的人物动作与参考视频一致。视频内容需满足以下要求：人物需要漏出清晰的上半身或全身的全部肢体及头部，避免遮挡建议上传1人动作视频，2人及以上会取画面占比最大的人物动作进行生成推荐使用真人动作，部分风格化的人物/类人肢体比例可以通过动作视频一镜到底，角色始终出现在画面中，避免切镜、运镜等。否则会被截取动作避免过快，相对平稳的动作生成效果更佳视频文件支持.mp4/.mov，文件大小不超过100MB，仅支持长宽的边长均位于340px~3850px之间，上述校验不通过会返回错误码等信息视频时长下限不短于3秒，时长上限与人物朝向参考（character_orientation）有关：当人物朝向与视频中人物一致时，视频时长最长可达30秒；当人物朝向与图片中人物一致时，视频时长最长可达10秒；如果您的动作难度比较高、速度比较快，有一定概率生成不足上传视频时长的结果，因为模型只能提取有效动作时长进行生成，最短提取出3s可用连续动作即可生成。请注意，因此消耗的积分将无法退还，建议适当调整动作难度与速度系统会校验视频内容，如有问题会返回错误码等信息
keep_original_sound	string	可选	yes	可选择是否保留视频原声枚举值：yes，no 其中yes：保留视频原声其中no：不保留视频原声
character_orientation	string	必须	无	生成视频中人物的朝向，可选择与图片一致或与视频一致枚举值：image，video，其中：其中image：与图片中人物朝向一致；此时参考视频时长不得超过10秒；其中video：与视频中人物朝向一致；此时参考视频时长不得超过30秒；
mode	string	必须	无	生成视频的模式枚举值：std，pro 其中std：标准模式（标准），基础模式，性价比高其中pro：专家模式（高品质），高表现模式，生成视频质量更佳
external_task_id	string	可选	无	自定义任务ID 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询请注意，单用户下需要保证唯一性

调用示例

curl -X POST http://kspmas.ksyun.com/v1/videos/motion-control \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $KSC_API_KEY" \
-d '{
    "model_name": "kling-v2-6",
    "prompt": "跑进一只柯基犬，在地上转圈",
    "mode": "std",
    "character_orientation": "image",
    "image_url": "https://docs.qingque.cn/image/api/convert/loadimage?id=-8654991330408162800eZQDlFDacBuEmer7HQstW4wes&docId=eZQAl5y8xNSkr0iYUS8-bpGvP&identityId=2Oa28mncRIC&loadSource=true",
    "video_url": "https://v4-fdl.kechuangai.com/ksc2/YFSvXF-bly6hu8o-D7L9tG7BgOC_Sv-r8_stl3SfL64aBt02ZD0kKtYG01U1XnS036DUJ3mhzZNCTjH6xwvrD_r7fv-yoDRSG_i8zOJkh5DaqBbaT4yqTyAgI1Pvo8Sjv8_o8SQxeV9pefFaGfXXYBGQeRr2mls-7LOXP_ETQYczCvdrfZN3IGMdvU2F3epu9vSM6krIaE35aLNM38eRyA.mp4?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAFGTrQJVVXJX_loAxg-kuHzhfs73l1b1iVEmcUd1jyyQabRBF-aggkZhxuPZJu1vn6jPuphruofXUqPs8XAzn0kRkqSU74Mhwf1O3oJpoLo0DPExHxgN7se-5mG9N9wOodEFZ-LIwR_JRaWORlXyrMwSJO6373YDUICB98Z1rykGrTzE_iDcjykLipiRDlSZ6C0ODniieg6pPcFM_TDm_DL4K2G2hsW-zMx-dgLHxvIQxoSS2Y9drB8Z4ednHxTIh7XZcnaIiDpX5Y-ZB0zHs3rFPWGxp3DG1INiKA41uY8yANeRHf9JCgFMAE&x-kcdn-pid=112757&pkey=AAVzRlrAxMHBkOpsyx8M2w5hntgOH8fhePu_DDkk1a_rDHRTwpqA3ScSRctccHaiWNgpwl1Q7c-xKKpHZzXaSgc48kS-k_f4FR6B6Kqh5lFpw0i9Mjz2WqhqiF1tOJBY_ss",
    "duration": "5"
}'

响应体

{
  "code": 0, //错误码；具体定义见错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data":{
  	"task_id": "string", //任务ID，系统生成
    "task_info":{ //任务创建时的参数信息
       "external_task_id": "string"//客户自定义任务ID
    }, 
    "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

Omni-Video

请求参数

字段	类型	必填	默认值	描述
model_name	string	必选	-	模型名称枚举值：kling-video-o1
prompt	string	必须	无	文本提示词，可包含正向描述和负向描述可将提示词模板化来满足不同的视频生成需求不能超过2500个字符 Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力通过<<<>>>的格式来指定某个主体、图片或视频，如：<<<element_1>>>、<<<image_1>>>、<<<video_1>>>
image_list	array	可选	空	参考图列表包括主体、场景、风格等参考图片，也可作为首帧或尾帧生成视频；当作为首帧或尾帧生成视频时：通过type参数来定义图片是否为首尾帧：first_frame为首帧，end_frame为尾帧暂时不支持仅尾帧，即有尾帧图时必须有首帧图首帧或首尾帧生视频时，不能使用视频编辑功能用key:value承载，如下： `"image_list":[ { "image_url":"image_url", "type":"first_frame" }, { "image_url":"image_url", "type":"end_frame" } ]` 支持传入图片Base64编码或图片URL（确保可访问）图片格式支持.jpg / .jpeg / .png 图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比要在1:2.5 ~ 2.5:1之间有参考视频时，参考图片数量不得超过4；无参考视频时，参考图片数量不得超过7 数组中超过2张图片时，不支持设置尾帧 image_url参数值不得为空
element_list	array	可选	空	主体参考列表基于主体库中主体的ID配置，用key:value承载，如下： `"element_list":[ { "element_id":long } ]` 参考主体数量与有无参考视频、参考图片数量有关，其中：有参考视频时，参考图片数量和参考主体数量之和不得超过4；无参考视频时，参考图片数量和参考主体数量之和不得超过7
video_list	array	可选	空	参考视频，通过URL方式获取可作为特征参考视频，也可作为待编辑视频，默认为待编辑视频；可选择性保留视频原声通过refer_type参数区分参考视频类型：feature为特征参考视频，base为待编辑视频参考视频为待编辑视频时，不能定义视频首尾帧通过keep_original_sound参数选择是否保留视频原声，yes为保留，no为不保留；当前参数对特征参考视频（feature）也生效用key:value承载，如下： `"video_list":[ { "video_url":"video_url", "refer_type":"base", "keep_original_sound":"yes" } ]` 视频格式仅支持MP4/MOV 仅支持时长≥3秒且≤10秒的视频视频宽高尺寸需介于720px（含）和2160px（含）之间视频帧率基于24fps～60fps，生成视频时会输出为24fps 至多仅支持上传1段视频，视频大小不超过200MB video_url参数值不得为空
mode	string	可选	pro	生成视频的模式枚举值：std，pro 其中std：标准模式（标准），基础模式，性价比高其中pro：专家模式（高品质），高表现模式，生成视频质量更佳
aspect_ratio	string	可选	空	生成视频的画面纵横比（宽:高）枚举值：16:9, 9:16, 1:1 未使用首帧参考或视频编辑功能时，当前参数必填
duration	string	可选	5	生成视频时长，单位s 枚举值：3，4，5，6，7，8，9，10，其中：使用文生视频、首帧图生视频时，仅支持5和10s 使用视频编辑功能（“refer_type”:“base”）时，输出结果与传入视频时长相同，此时当前参数无效；此时，按输入视频时长四舍五入取整计量计费
external_task_id	string	可选	空	自定义任务ID 用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询请注意，单用户下需要保证唯一性

调用示例

curl --location 'https://kspmas.ksyun.com/v1/videos/omni-video' \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $KSC_API_KEY" \
-d '{
    "model_name": "kling-video-o1",
    "prompt": "宇航员躺下睡着了",
    "mode": "std",
    "aspect_ratio": "16:9",
    "duration": "5"
}'

响应体

{
  "code": 0, //错误码；具体定义见错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data":{
  	"task_id": "string", //任务ID，系统生成
    "task_info":{ //任务创建时的参数信息
       "external_task_id": "string"//客户自定义任务ID
    }, 
    "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

查询任务

查询任务（单个）参数

字段

类型

必填

默认值

描述

task_id

string

可选

无

图生视频的任务ID

请求路径参数，直接将值填写在请求路径中，与external_task_id两种查询方式二选一

external_task_id

string

可选

无

图生视频的自定义任务ID

创建任务时填写的external_task_id，与task_id两种查询方式二选一

查询任务（单个）调用示例

适用于kling-v2-1-master、kling-v2-5-turbo

curl --location 'http://kspmas.ksyun.com/v1/videos/text2video/{task_id}' \
--header 'Authorization: Bearer $KSC_API_KEY' \

适用于kling-v2-6、kling-video-o1

curl --location 'http://kspmas.ksyun.com/v1/videos/text2video/{task_id}?kling_model={model_name}' \
--header 'Authorization: Bearer $KSC_API_KEY' \

查询任务（单个）响应体

{
  "code": 0, //错误码；具体定义见错误码
  "message": "string", //错误信息
  "request_id": "string", //请求ID，系统生成，用于跟踪请求、排查问题
  "data":{
      "task_id": "string", //任务ID，系统生成
    "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "task_status_msg": "string", //任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
    "task_info": { //任务创建时的参数信息
      "external_task_id": "string"//客户自定义任务ID
    },
    "task_result":{
      "videos":[
        {
            "id": "string", //生成的视频ID；全局唯一
              "url": "string", //生成视频的URL，例如https://p1.a.kwimgs.com/bs2/upload-ylab-stunt/special-effect/output/HB1_PROD_ai_web_46554461/-2878350957757294165/output.mp4（请注意，为保障信息安全，生成的图片/视频会在30天后被清理，请及时转存）
              "duration": "string" //视频总时长，单位s
        }
      ]
    }
    "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708, //任务更新时间，Unix时间戳、单位ms
  }
}

文档导读

上一篇：视频生成模型

下一篇：图片生成模型

纯净模式常规模式

纯净模式

点击可全屏预览文档内容