文生视频

POST /text-to-video/{model}：可灵 3.0 / 3.0 Turbo 文生视频，异步，用 GET /tasks 查询

POST/text-to-video/{model}

用提示词生成视频。

项	值
模型	`kling-3.0-turbo` / `kling-3.0`
模式	异步（提交 → 轮询 `GET /tasks`，见查询任务）
计费	按输出视频时长（秒）结算

快速开始

curl https://api.vibelab.me/text-to-video/kling-3.0-turbo \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只金色的猫咪在阳光下的草地上奔跑，慢动作，电影质感",
    "settings": {
      "resolution": "720p",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
  "data": {
    "id": "893605946402811985",
    "status": "submitted",
    "create_time": 1781080778802,
    "update_time": 1781080778802,
    "external_id": "your-id"
  }
}

请求参数

请求头

参数	类型	必填	默认	说明
`Authorization`	string	是	-	`Bearer $LOOPTOKEN_API_KEY`
`Content-Type`	string	是	-	`application/json`

路径参数

参数	类型	必填	默认	说明
`model`	string	是	-	`kling-3.0-turbo`（固定有声，720p/1080p）或 `kling-3.0`（720p/1080p/4k，声音可选）

请求体

参数	类型	必填	默认	说明
`prompt`	string	是	-	提示词，不超过 3072 个字符
`settings.resolution`	string	否	`720p`	`720p`、`1080p`；仅 `kling-3.0` 支持 `4k`
`settings.aspect_ratio`	string	否	`16:9`	`16:9`、`9:16`、`1:1`
`settings.duration`	integer	否	`5`	`3`–`15` 秒
`settings.audio`	string	否	`off`	仅 `kling-3.0`：`native` 或 `off`；`kling-3.0-turbo` 固定有声，不可传
`settings.multi_shot`	boolean	否	`true`	仅 `kling-3.0`
`options.callback_url`	string	否	-	任务状态变化时的 HTTPS 回调地址，见概览
`options.external_task_id`	string	否	-	自定义任务 ID，同一账号下不可重复
`options.watermark_info.enabled`	boolean	否	`false`	是否同时生成含水印结果

响应

字段	类型	说明
`code`	integer	`0` 表示成功，其余见错误
`message`	string	错误信息
`request_id`	string	请求 ID，排查问题时提供
`data.id`	string	任务 ID
`data.status`	string	`submitted`、`processing`、`succeeded`、`failed`
`data.create_time`、`data.update_time`	integer	Unix 毫秒时间戳
`data.external_id`	string	创建时传入的 `options.external_task_id`，没传则无此字段

计费

按输出视频时长（秒）结算，价格以定价页为准；任务失败全额退回。

错误

本页参数校验返回 400 / 1201，message 原文如下：

HTTP	`code`	触发场景	处理
404	`1203`	`model not found`（路径 `{model}` 不是已上架的可灵模型）	路径写 `kling-3.0-turbo` 或 `kling-3.0`
400	`1201`	`prompt is required and must be a string`	传非空字符串 `prompt`
400	`1201`	`prompt must not exceed 3072 characters`	缩短提示词
400	`1201`	`settings must be an object`	`settings` 传对象
400	`1201`	`settings.resolution "..." is not supported for ...`	`kling-3.0-turbo` 只支持 `720p`/`1080p`；`4k` 仅 `kling-3.0`
400	`1201`	`settings.duration must be an integer`	传整数
400	`1201`	`settings.duration must be between 3 and 15`	传 `3`–`15`
400	`1201`	`settings.audio "..." is not supported for ...`	`kling-3.0` 只接受 `native`/`off`；`kling-3.0-turbo` 不能传 `settings.audio`
400	`1201`	`options must be an object`	`options` 传对象

通用错误（鉴权、余额、并发、回调地址、上游错误）见 Kling 错误。

注意事项

路径写 kling-4.0 → 按 4.0 规则校验，见 Kling 4.0 视频生成。
多镜头 → 写在提示词里：镜头 1, 3, 提示词; 镜头 2, 2, 提示词;，最多 6 个分镜，分镜时长之和等于 duration。

文生视频

本页内容