> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapon.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 多图参考生视频

> 接口与可灵官网一致；支持多张参考图片生成视频

* 路径 `POST /kling/v1/videos/multi-image2video`
* 与官网一致：本页所有请求体、字段命名与返回结构与可灵官网保持一致
* 字段详解：请参考[官网权威文档](https://klingai.com/document-api/quickStart/productIntroduction/overview)

请求参数

| 参数                 | 类型     | 必填    | 说明                                    |
| ------------------ | ------ | ----- | ------------------------------------- |
| `model_name`       | string | 否     | 模型名称，仅支持 `kling-v1-6`，默认 `kling-v1-6` |
| `image_list`       | array  | **是** | 图片列表，1-4 张                            |
| `prompt`           | string | **是** | 正向文本提示词                               |
| `negative_prompt`  | string | 否     | 负向文本提示词                               |
| `mode`             | string | 否     | 生成模式：`std`、`pro`，默认 `std`             |
| `duration`         | string | 否     | 视频时长：`5`、`10`，默认 `5`                  |
| `aspect_ratio`     | string | 否     | 画面纵横比：`16:9`、`9:16`、`1:1`，默认 `16:9`   |
| `callback_url`     | string | 否     | 回调通知地址                                |
| `external_task_id` | string | 否     | 自定义任务ID                               |

image\_list 格式

```json theme={null}
{
  "image_list": [
    {"image": "https://example.com/image1.jpg"},
    {"image": "https://example.com/image2.jpg"}
  ]
}
```

补充约束

* `image_list` 最多 4 张图片；
* `duration` 仅支持 `5`/`10`；
* `aspect_ratio` 仅支持 `16:9`/`9:16`/`1:1`。

### 场景：多张参考图生成视频

```bash theme={null}
curl --request POST \
  --url https://models.kapon.cloud/kling/v1/videos/multi-image2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-v1-6",
    "image_list": [
      {"image": "https://example.com/character-front.jpg"},
      {"image": "https://example.com/character-side.jpg"}
    ],
    "prompt": "The character turns around and waves at the camera",
    "mode": "std",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'
```

示例响应

```json theme={null}
{
  "code": 0,
  "message": "success",
  "request_id": "req_1735558800_multi123",
  "data": {
    "task_id": "task_01JGHN...",
    "task_status": "submitted",
    "created_at": 1735558800000,
    "updated_at": 1735558800000
  }
}
```

任务查询

```bash theme={null}
# 查询单个任务
curl "https://models.kapon.cloud/kling/v1/videos/multi-image2video/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.kapon.cloud/kling/v1/videos/multi-image2video?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"
```


## OpenAPI

````yaml POST /kling/v1/videos/multi-image2video
openapi: 3.0.3
info:
  title: Kling API
  version: '2026-09-07'
  description: API 2.0 与 Legacy 分开定义；请求使用 Kapon Token。
servers:
  - url: https://models.kapon.cloud
security:
  - BearerAuth: []
paths:
  /kling/v1/videos/multi-image2video:
    post:
      tags:
        - Kling
      summary: Multi-image to video
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/kling.OfficialMultiImage2VideoRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/kling.OfficialResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    kling.OfficialMultiImage2VideoRequest:
      type: object
      properties:
        aspect_ratio:
          description: 画面纵横比：16:9, 9:16, 1:1
          type: string
        callback_url:
          description: 回调通知地址
          type: string
        duration:
          description: 视频时长：5, 10
          type: string
        external_task_id:
          description: 自定义任务ID
          type: string
        image_list:
          description: 图片列表，最多4张
          type: array
          items:
            $ref: '#/components/schemas/kling.ImageListItem'
        mode:
          description: 生成模式：std, pro
          type: string
        model_name:
          description: 模型名称，默认kling-v1-6
          type: string
        negative_prompt:
          description: 负向文本提示词
          type: string
        prompt:
          description: 正向文本提示词，必须
          type: string
    kling.OfficialResponse:
      type: object
      properties:
        code:
          description: 错误码
          type: integer
        data:
          description: 单个任务数据
          allOf:
            - $ref: '#/components/schemas/kling.OfficialTaskData'
        data_list:
          description: 任务列表数据（用于列表查询）
          type: array
          items:
            $ref: '#/components/schemas/kling.OfficialTaskData'
        message:
          description: 错误信息
          type: string
        request_id:
          description: 请求ID
          type: string
    kling.ImageListItem:
      type: object
      properties:
        image:
          description: 图片URL或Base64编码
          type: string
    kling.OfficialTaskData:
      type: object
      properties:
        created_at:
          description: 任务创建时间，Unix时间戳、单位ms
          type: integer
        final_balance_deduction:
          type: object
        final_unit_deduction:
          description: 实际扣减积分
          type: string
        platform_id:
          description: One-Hub 平台统一追踪 ID（video_<ULID>）
          type: string
        task_id:
          description: 任务ID — 上游原始任务 ID
          type: string
        task_info:
          description: 任务创建时的参数信息
          allOf:
            - $ref: '#/components/schemas/kling.OfficialTaskInfo'
        task_result:
          description: 任务结果
          allOf:
            - $ref: '#/components/schemas/kling.OfficialTaskResult'
        task_status:
          description: 任务状态
          type: string
        task_status_msg:
          description: 任务状态信息
          type: string
        updated_at:
          description: 任务更新时间，Unix时间戳、单位ms
          type: integer
        watermark_info:
          description: 水印信息
          allOf:
            - $ref: '#/components/schemas/kling.OfficialWatermarkInfo'
    kling.OfficialTaskInfo:
      type: object
      properties:
        external_task_id:
          description: 客户自定义任务ID
          type: string
    kling.OfficialTaskResult:
      type: object
      properties:
        videos:
          type: array
          items:
            $ref: '#/components/schemas/kling.OfficialVideoResult'
    kling.OfficialWatermarkInfo:
      type: object
      properties:
        enabled:
          description: 是否生成含水印结果
          type: boolean
    kling.OfficialVideoResult:
      type: object
      properties:
        duration:
          description: 视频总时长，单位s
          type: string
        id:
          description: 生成的视频ID
          type: string
        url:
          description: 生成视频的URL
          type: string
        watermark_url:
          description: 含水印视频下载URL
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````