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

# kling-2.6-motion-control

> API usage guide for kling-2.6-motion-control.

{/* source_model_id: kling-2.6-motion-control */}

{/* source_updated_at: 1782169259 */}

**Model ID**

```bash theme={null}
kling-2.6-motion-control
```

**Calling method:** async

# kling-2.6-motion-control API Usage Guide

## Overview

**kling-2.6-motion-control** transfers motion from a reference video to a static character image. Upload a character image and a motion reference video (3-30 seconds), and the model will animate the character following the motion in the video.

## Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit Motion Control Request

### Base URL

```
https://console.gmicloud.ai
```

### Endpoint

```
POST /api/v1/ie/requestqueue/apikey/requests
```

### Request Format

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-2.6-motion-control",
    "payload": {
      "image_url": "https://example.com/character.jpg",
      "video_url": "https://example.com/motion-reference.mp4",
      "character_orientation": "video",
      "mode": "std",
      "keep_original_sound": "yes",
      "prompt": "cinematic lighting, professional studio background"
    }
  }'
```

### Request Parameters

| Parameter               | Type   | Required | Description                                                             | Default | Constraints                                     |
| ----------------------- | ------ | -------- | ----------------------------------------------------------------------- | ------- | ----------------------------------------------- |
| `image_url`             | string | Yes      | Character/reference image URL. The character should be clearly visible. | -       | JPG/PNG/WebP, max 10MB                          |
| `video_url`             | string | Yes      | Motion reference video URL containing the motion to transfer.           | -       | MP4/MOV/MKV, 3-30 seconds, max 100MB            |
| `character_orientation` | string | Yes      | How character orientation is determined.                                | video   | Options: video (up to 30s), image (up to \~10s) |
| `mode`                  | string | Yes      | Quality mode affecting price.                                           | std     | Options: std, pro                               |
| `keep_original_sound`   | string | No       | Whether to preserve audio from reference video.                         | yes     | Options: yes, no                                |
| `prompt`                | string | No       | Text prompt for background, lighting, style. Does NOT control motion.   | -       | Max 2500 chars                                  |

### Response

```json theme={null}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "kling-2.6-motion-control",
  "status": "queued",
  "created_at": 1750442925,
  "updated_at": 1750442925,
  "queued_at": 1750442925
}
```

## Check Request Status

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

### Response (Success)

```json theme={null}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "kling-2.6-motion-control",
  "status": "success",
  "payload": {
    "image_url": "https://example.com/character.jpg",
    "video_url": "https://example.com/motion-reference.mp4",
    "character_orientation": "video",
    "mode": "std"
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/generated-video.mp4",
    "thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg"
  },
  "created_at": 1750442925,
  "updated_at": 1750442930
}
```

## Pricing

* **Standard (std)**: \$0.07 per second
* **Pro**: \$0.112 per second

Example: 10-second video in Standard mode = \$0.70