视频模型进阶用户更新于 2026-11-11

POST/v1/videos/generations

Kling 4

请求 ID kling-v4

协议

POST /v1/videos/generations · 生成视频示例
GET /v1/videos/tasks/{id} · 查询视频任务示例
GET /v1/videos/tasks/{id}/content · 下载视频示例
DELETE /v1/videos/tasks/{id} · 删除已结束的视频任务示例
POST /v1/videos/assets · 上传素材示例
DELETE /v1/videos/assets/{id} · 删除素材示例

认证

请求需要 API Key。在控制台的 API Key 管理获取密钥。发送 JSON 请求时，设置 Content-Type: application/json。

Authorization: Bearer YOUR_API_KEY

请求参数

`POST /v1/videos/generations`

参数	类型	是否必填	说明
`model`	`string`	必填	`kling-v4`. 使用本页列出的模型 ID。
`prompt`	`string`	视条件	描述画面、动作和镜头。文生视频或参考模式必填，使用首帧时可省略。
`content`	`array<object>`	视条件	参考素材和可选文本项。仅传 `prompt` 做文生视频时可省略。最多 8 张图片。参考模式最多 5 个视频，每段 3–30 秒，合计最多 30 秒。编辑或续写仅使用一个视频。
`content[].type`	`string`	必填	可用值为 `text`, `image_url`, `input_image`, `video_url`, `input_video`。
`content[].text`	`string`	视条件	当素材项的 `type` 为 `text` 时填写提示词。
`content[].role`	`string`	视条件	首帧用 `first_frame`，尾帧用 `last_frame`。尾帧要求同时提供首帧。续写可单独传一张 `last_frame` 作为目标尾帧。普通参考图用 `reference_image`。参考视频使用 `reference_video`。
`content[].asset_id`	`string`	视条件	先用 `POST /v1/videos/assets` 上传素材，再填返回的 `id`。在 multipart 表单中先填 `kind`（`image`, `video`），再填 `file`。
`resolution`	`string`	选填	可用值为 `720p`, `1080p`。默认 `720p`。
`ratio`	`string`	选填	输出宽高比，兼容字段名 `aspect_ratio`。可用值为 `16:9`, `9:16`, `1:1`, `21:9`。参考模式可传 `auto`（默认）；续写时省略。文生模式默认 `16:9`。
`duration`	`integer`	选填	输出时长，单位为秒。接受 3–30 秒的整数。编辑时省略可按源视频时长；其他模式默认 5 秒。续写时表示新增片段的时长。
`generate_audio`	`boolean`	选填	始终生成音轨。可省略或传 `true`。
`omni_reference_task_type`	`string`	选填	可用值为 `auto`, `reference`, `edit`, `extend`。默认 `auto`，按素材确定生成模式；`edit`、`extend` 均要求一个视频。

请求示例

先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY，并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时，按对应客户端指南配置。

示例中的素材 URL 和素材 ID 需要替换成自己的有效素材。

Video Generations

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4",
  "prompt": "Slow camera push toward a paper lantern swaying gently by a lake.",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true
}'

Video Generations · 首帧

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4",
  "prompt": "Slow camera push toward a paper lantern swaying gently by a lake.",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "content": [
    {
      "type": "image_url",
      "role": "first_frame",
      "asset_id": "YOUR_FIRST_FRAME_ASSET_ID"
    }
  ]
}'

Video Generations · 首尾帧

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4",
  "prompt": "Slow camera push toward a paper lantern swaying gently by a lake.",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "content": [
    {
      "type": "image_url",
      "role": "first_frame",
      "asset_id": "YOUR_FIRST_FRAME_ASSET_ID"
    },
    {
      "type": "image_url",
      "role": "last_frame",
      "asset_id": "YOUR_LAST_FRAME_ASSET_ID"
    }
  ]
}'

Video Generations · 参考视频

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4",
  "prompt": "Match the camera motion from the reference video in a lakeside lantern scene.",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "omni_reference_task_type": "reference",
  "content": [
    {
      "type": "video_url",
      "role": "reference_video",
      "asset_id": "YOUR_VIDEO_ASSET_ID"
    }
  ]
}'

Video Generations · 编辑视频

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4",
  "prompt": "Preserve the subject and change the setting to a lakeside at dusk.",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "omni_reference_task_type": "edit",
  "content": [
    {
      "type": "video_url",
      "role": "reference_video",
      "asset_id": "YOUR_VIDEO_ASSET_ID"
    }
  ]
}'

Video Generations · 续写视频

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "kling-v4",
  "prompt": "Continue the motion as the camera glides farther over the lake.",
  "resolution": "720p",
  "duration": 5,
  "generate_audio": true,
  "omni_reference_task_type": "extend",
  "content": [
    {
      "type": "video_url",
      "role": "reference_video",
      "asset_id": "YOUR_VIDEO_ASSET_ID"
    },
    {
      "type": "image_url",
      "role": "last_frame",
      "asset_id": "YOUR_LAST_FRAME_ASSET_ID"
    }
  ]
}'

查询视频任务

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

下载视频

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID/content' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -L \
  -o result.mp4

删除已结束的视频任务

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -i \
  -X DELETE

上传素材

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/assets' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -F 'kind=image' \
  -F '[email protected];type=image/png'

上传素材 · 上传视频

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/assets' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -F 'kind=video' \
  -F '[email protected];type=video/mp4'

删除素材

bash

curl -sS 'https://api.icodeeasy.cc/v1/videos/assets/YOUR_ASSET_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -i \
  -X DELETE

响应与任务

HTTP 202 · 任务已受理

json

{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "model": "kling-v4",
  "created_at": "2026-07-30T08:00:00Z",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "queued",
  "updated_at": "2026-07-30T08:00:00Z",
  "task_id": "vid_1785398400000000000"
}

HTTP 200 · 查询到已完成任务

json

{
  "id": "vid_1785398400000000000",
  "object": "video.generation.job",
  "model": "kling-v4",
  "created_at": "2026-07-30T08:00:00Z",
  "status_url": "/v1/videos/tasks/vid_1785398400000000000",
  "content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
  "status": "succeeded",
  "updated_at": "2026-07-30T08:01:00Z",
  "url": "/v1/videos/tasks/vid_1785398400000000000/content"
}

保存 id。用同一 API Key 对 status_url 发起 GET 请求，直到 status 变为 succeeded 或 failed。成功后请求 content_url 下载，并允许 HTTP 重定向。两个地址都相对于 API Base URL。

字段	类型	说明
`id / task_id`	string	任务 ID。创建响应中的 `task_id` 与 `id` 相同。
`status`	string	任务状态，可为 `queued`、`running`、`succeeded` 或 `failed`。
`progress`	integer	生成进度。服务没有进度值时会省略。
`error.code`	string	生成失败时返回错误分类。

常见错误

HTTP	错误类型	说明
400	`invalid_request`	检查模型、字段组合和参考素材是否有效。
401	`unauthorized`	检查 API Key 是否缺失、无效或已停用。
402	`insufficient_balance`	账户余额不足以提交任务。
404	`not_found`	查询遇到 404 时保留任务 ID，核对任务所属账户的 API Key 和查询地址。任务可能已完成，请勿因此重新提交。
409	`video_not_ready`	视频尚未生成完成。继续查询任务状态。
503	`submission_unknown`	无法确认提交结果。请先联系支持确认任务是否已创建，再提交新请求。

完整接入指南 · 查看完整接口指南，了解请求字段、任务状态和响应格式。

能力与限制

text_to_video · 支持
image_to_video · 支持
first_frame · 支持
last_frame · 支持
reference_images · 支持
audio · 支持
限制分辨率: 720p, 1080p · 时长: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 · 画面比例: 16:9, 9:16, 1:1, 21:9 · 参考图：最多 8 张

模型能力目录 · 查看定价

视频生成 API

使用视频生成任务 API 提交文字、首尾帧或参考素材，轮询任务状态、下载结果并在结束后按需删除任务记录。

模型能力目录

按文本、图片和视频分类查看公开模型的规范化请求 ID、兼容协议、支持客户端、工具调用、输入输出能力与限制，并根据最近核对日期判断信息新鲜度。

注册并获取 API Key

Kling 4

协议

认证

请求参数

POST /v1/videos/generations

请求示例

Video Generations

Video Generations · 首帧

Video Generations · 首尾帧

Video Generations · 参考视频

Video Generations · 编辑视频

Video Generations · 续写视频

查询视频任务

下载视频

删除已结束的视频任务

上传素材

上传素材 · 上传视频

删除素材

响应与任务

HTTP 202 · 任务已受理

HTTP 200 · 查询到已完成任务

常见错误

能力与限制

相关指南

视频生成 API

模型能力目录

`POST /v1/videos/generations`