Skip to main content

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.

Model ID 
kling-3-motion-control

​
kling-3-motion-control API Usage Guide

​
Overview

kling-3-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: 
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

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-3-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

ParameterTypeRequiredDescriptionDefaultConstraints
image_urlstringYesCharacter/reference image URL. The character should be clearly visible.-JPG/PNG/WebP, max 10MB
video_urlstringYesMotion reference video URL containing the motion to transfer.-MP4/MOV/MKV, 3-30 seconds, max 100MB
character_orientationstringYesHow character orientation is determined.videoOptions: video (up to 30s), image (up to ~10s)
modestringYesQuality mode affecting price.stdOptions: std, pro
keep_original_soundstringNoWhether to preserve audio from reference video.yesOptions: yes, no
promptstringNoText prompt for background, lighting, style. Does NOT control motion.-Max 2500 chars

​
Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "kling-3-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)

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "kling-3-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
}