AI 模型接口视频(Videos)可灵格式
获取 Kling 文生视频任务状态
接口
GET /kling/v1/videos/text2video/{task_id}
请求头
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <token> |
Accept | 是 | application/json |
路径参数
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
task_id | 是 | string | 任务 ID |
响应参数
application/json
| 字段 | 类型 | 说明 |
|---|---|---|
task_id | string | 任务 ID |
status | string | 任务状态,支持 queued、in_progress、completed、failed |
url | string | 视频资源 URL,任务成功完成后返回 |
format | string | 视频格式 |
metadata | object | 任务元数据 |
error | object | 错误信息 |
metadata
| 字段 | 类型 | 说明 |
|---|---|---|
duration | number | 实际生成的视频时长 |
fps | integer | 实际帧率 |
width | integer | 实际宽度 |
height | integer | 实际高度 |
seed | integer | 使用的随机种子 |
error
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 错误码 |
message | string | 错误信息 |
错误响应
404 Not Found
| 字段 | 类型 | 说明 |
|---|---|---|
error.message | string | 错误信息 |
error.type | string | 错误类型 |
error.param | string | null | 相关参数 |
error.code | string | null | 错误代码 |
说明
status用于表示任务当前进度。error字段在任务失败时提供更详细信息。
Authorization
BearerAuth
AuthorizationBearer <token>
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
In: header
Path Parameters
task_id*string
任务 ID
Response Body
application/json
application/json
curl -X GET "https://tokenfleet.cn/kling/v1/videos/text2video/string"{
"task_id": "abcd1234efgh",
"status": "completed",
"url": "https://example.com/video.mp4",
"format": "mp4",
"metadata": {
"duration": 5,
"fps": 30,
"width": 1280,
"height": 720,
"seed": 20231234
},
"error": {
"code": 0,
"message": "string"
}
}{
"error": {
"message": "string",
"type": "string",
"param": "string",
"code": "string"
}
}