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

# Kling 2.6 Motion Control

> Advanced motion transfer with character animation

<Tip>
  1. After submission, a `task_id` will be returned. If you provided a `callback_url`, when the task status becomes `finished` or `failed`, a POST request will be sent to the `callback_url`.
  2. Regardless of whether `callback_url` is provided, you can retrieve the response result through the unified [Query Task Status](/api-manual/task-management/status) endpoint.
</Tip>

# Kling 2.6 Motion Control

Transfer motion from reference videos to character images with precise motion control. Create dynamic character animations by combining static images with motion reference videos while controlling scene details through text prompts.

## Available Model

* **kling-2.6-motion-control** - Motion transfer from video to character image

## Key Features

* **Motion Transfer**: Transfer real human motion, gestures, and expressions from reference videos to character images
* **Character Animation**: Animate static characters with dynamic motion patterns
* **Character Orientation Control**: Choose between matching image orientation (max 10s output) or video orientation (max 30s output)
* **Scene Control**: Control scene details and environment through optional text prompts
* **Flexible Resolution**: Choose between 720p (standard) or 1080p (high quality) output

## Required Parameters

* **image\_urls**: Single character image showing the subject's head, shoulders, and torso
* **video\_urls**: Single reference video (3-30 seconds) for motion transfer
* **character\_orientation**:
  * `"image"` - Matches the person's orientation in the photograph (maximum 10-second output)
  * `"video"` - Maintains consistency with character orientation from the reference video (maximum 30-second output)
* **mode**: Output resolution (`"720p"` or `"1080p"`)

## Optional Parameters

* **prompt**: Text description of the desired output scene (max 2,500 characters)


## OpenAPI

````yaml /api-manual/video-series/kling-2.6-motion-control.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: Vidgo API - Kling 2.6 Motion Control API
  description: Advanced Motion Transfer with Character Animation
  version: 1.0.0
servers:
  - url: https://api.vidgo.ai
    description: Production server
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Kling 2.6 Motion Control
      summary: Submit Kling 2.6 Motion Control Task
      description: >-
        Transfer motion from reference videos to character images with precise
        motion control
      operationId: submitKling26MotionControlTask
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              kling-2.6-motion-control:
                summary: Kling 2.6 Motion Control
                value:
                  model: kling-2.6-motion-control
                  callback_url: https://your-domain.com/callback
                  input:
                    prompt: The cartoon character is dancing gracefully in a studio
                    image_urls:
                      - https://example.com/character-image.jpg
                    video_urls:
                      - https://example.com/dance-reference.mp4
                    character_orientation: video
                    mode: 1080p
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
              examples:
                success:
                  summary: Successful submission
                  value:
                    code: 200
                    data:
                      task_id: task-unified-1757165031-uyujaw3d
                      status: not_started
                      created_time: '2025-11-12T10:30:00'
components:
  schemas:
    SubmitRequest:
      type: object
      required:
        - model
      properties:
        model:
          type: string
          description: Kling 2.6 Motion Control model identifier
          enum:
            - kling-2.6-motion-control
        callback_url:
          type: string
          format: uri
          description: Webhook callback URL for result notifications
          example: https://your-domain.com/callback
        input:
          type: object
          required:
            - image_urls
            - video_urls
            - character_orientation
            - mode
          description: Input parameters for motion control generation
          properties:
            prompt:
              type: string
              description: Text description of the desired output scene (optional)
              maxLength: 2500
              example: The cartoon character is dancing gracefully in a studio
            image_urls:
              type: array
              items:
                type: string
                format: uri
              minItems: 1
              maxItems: 1
              description: >-
                Single character image URL (JPEG, PNG, WEBP, max 10MB). Must
                clearly show the subject's head, shoulders, and torso
              example:
                - https://example.com/character-image.jpg
            video_urls:
              type: array
              items:
                type: string
                format: uri
              minItems: 1
              maxItems: 1
              description: >-
                Single reference video URL for motion transfer (MP4, MOV, MKV,
                max 100MB, 3-30 seconds). Must clearly show the subject's head,
                shoulders, and torso
              example:
                - https://example.com/dance-reference.mp4
            character_orientation:
              type: string
              description: >-
                Character orientation mode: 'image' matches the person's
                orientation in the photograph (max 10 seconds output), 'video'
                maintains consistency with character orientation from the
                reference video (max 30 seconds output)
              enum:
                - image
                - video
              example: video
            mode:
              type: string
              description: >-
                Output video resolution. 720p for standard quality, 1080p for
                higher visual quality
              enum:
                - 720p
                - 1080p
              example: 1080p
    SubmitResponse:
      type: object
      required:
        - code
        - data
      properties:
        code:
          type: integer
          example: 200
          description: HTTP status code
        data:
          type: object
          required:
            - task_id
            - status
            - created_time
          properties:
            task_id:
              type: string
              example: task-unified-1757165031-uyujaw3d
              description: Unique task identifier for status tracking
            status:
              type: string
              enum:
                - not_started
              example: not_started
              description: Initial task status
            created_time:
              type: string
              format: date-time
              example: '2025-11-12T10:30:00'
              description: ISO 8601 timestamp when the task was created
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        All API endpoints require Bearer Token authentication


        Get your API Key:


        Visit the [API Key Management
        Page](https://vidgo.ai/apis/dashboard/api-key) to get your API Key


        Add it to the request header:


        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````