创建视频生成任务

提交视频生成任务，支持文生视频和图生视频。

返回任务 ID，可通过 GET 接口查询任务状态。

回调通知

可选传入顶层 callback_url。任务进入 SUCCESS 或 FAILURE 终态后，系统会向该地址发送 POST 请求，无需持续轮询查询接口。

callback_url 必须是绝对 http 或 https URL，不能包含用户名、密码或 URL 片段，最大长度为 2048 字节；不传或传空字符串时不启用回调。

回调请求头为 Content-Type: application/json，请求超时为 10 秒；仅 HTTP 2xx 视为投递成功，重定向不会自动跟随。

回调请求 body 与 GET /v1/video/generations/{task_id} 成功响应中的 data 字段完全一致，只移除外层 code、message、data 包装，不增加、删除或重命名任何任务字段。

首次投递失败会在 30 秒后重试，第二次失败后在 60 秒后重试，后续失败间隔为 300 秒；总投递次数受运营设置 VideoCallbackMaxAttempts 控制，默认 3 次（包含首次）。

日志关联：视频生成是异步任务，请优先使用响应体 task_id 查询消耗明细。同一个 task_id 最多会有两条使用明细：一条任务提交时的预扣费记录，一条视频生成成功后的补扣费记录，或失败/差额结算后的退费记录。

curl --location 'https://tk.wxdatas.cn/v1/video/generations' \ --header 'Authorization: Bearer sk-xxxxxx' \ --header 'Content-Type: application/json' \ --data '{ "model": "kling-v1", "prompt": "宇航员站起身走了", "image": "https://example.com/image.jpg", "callback_url": "https://client.example.com/hooks/video", "duration": 5, "width": 1280, "height": 720, "fps": 30, "seed": 20231234, "n": 1, "response_format": "url", "user": "user-1234", "metadata": { "property1": "string", "property2": "string" } }'

回调通知

请求参数

返回响应

创建视频生成任务

回调通知#

请求参数

返回响应

回调通知