提交任务(可灵格式)
与可灵官方 API 结构一致:文生 / 图生视频分别调用对应端点,全能模型 kling-video-v3-omni / kling-video-o1 也用同一对端点(网关按模型自动路由到全能生成入口,查询 / 计费方式不变),动作控制模型 kling-video-motion-control-v3.0 / v2.6 同样走此入口(见动作控制)。image_tail / negative_prompt / resolution 等字段顶层或 metadata 内均可;可灵官方 API 独有的 cfg_scale / camera_control / static_mask / dynamic_masks 等字段上游不支持,传了会被忽略。
端点
- 文生视频:
POST /kling/v1/videos/text2video - 图生视频:
POST /kling/v1/videos/image2video
除可灵格式外,也可使用通用端点 POST /v1/video/generations(OpenAI 风格,见创建视频生成任务)与 POST /v1/responses(Responses 格式,产物以 <video> 标签渲染)。
请求体
提交前网关会按模型预校验 resolution / duration / audio / multi_shot 等参数,非法值直接返回 400 并附合法取值提示,按提示修正即可。这是为保护你的余额:上游对这些参数并不报错,而是静默按默认值生成并照常扣费。
模型 × 参数速查
补充约束(上游实测):v2.5 / v2.6 系首帧 + 尾帧仅支持 1080p(自动改档);元素素材 ≤ 3 个(v3 / v3-omni / o1)、音色素材 ≤ 2 个;元素 / 音色的创建与引用见元素与音色。
请求示例
旧版代码无需修改即可使用:旧站的 mode(std / pro)、原生 settings 对象、metadata 内 image_tail / negative_prompt 隧道等写法均兼容,行为不变。但有两点差异:mode: "mock" 不再可用(返回 400,零成本测试请用站内「自用模式」);非法参数组合从静默丢弃改为 400 拦截(防止上游静默按默认档扣费)。旧版写法细节见旧版使用指南(v2.5-turbo)。
响应体
提交成功返回任务对象,data.task_id(顶层 task_id 同值)用于查询,task_status 起始为 submitted。
响应示例
查询状态与下载见查询与下载。
