> ## Documentation Index > Fetch the complete documentation index at: https://docs.powertokens.ai/llms.txt > Use this file to discover all available pages before exploring further. # Kling Motion Control kling-v3 > Submit a Kling native motion control task via `/kling/v1/videos/motion-control`. ## OpenAPI ````yaml api-reference/en/zmodelVideo/kling/kling-v3-motion-control.json POST /kling/v1/videos/motion-control openapi: 3.0.1 info: title: Kling Motion Control Video Task - Submit Task (kling-v3) version: 1.0.0 description: >- Submit a Kling native motion control task via `/kling/v1/videos/motion-control`. Uses model kling-v3. servers: - url: https://api.powertokens.ai description: Current new-api gateway instance security: [] tags: - name: Kling description: Kling native async task endpoints paths: /kling/v1/videos/motion-control: post: tags: - Kling summary: Kling Motion Control Video Task (kling-v3) description: >- Submit a Kling native motion control task via `/kling/v1/videos/motion-control`. operationId: createKlingV3MotionControl parameters: - name: Content-Type in: header required: true schema: type: string default: application/json description: Data exchange format requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/KlingRequest' examples: request: summary: Request example value: model_name: kling-v3 image_url: >- https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png prompt: The girl is wearing a gray loose T-shirt and denim shorts video_url: >- https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4 keep_original_sound: 'yes' character_orientation: image mode: pro callback_url: '' external_task_id: xxx responses: '200': description: Task accepted. content: application/json: schema: $ref: '#/components/schemas/SubmitResponse' examples: response: summary: Response example value: code: 0 message: string request_id: string data: task_id: string task_info: external_task_id: string task_status: submitted created_at: 1722769557708 updated_at: 1722769557708 security: - bearerAuth: [] components: schemas: KlingRequest: type: object required: - model_name - image_url - video_url - character_orientation - mode properties: model_name: type: string description: Model name enum: - kling-v3 prompt: type: string description: >- Text prompt, can include positive and negative descriptions - Add elements to the scene or achieve camera movement effects through the prompt maxLength: 2500 image_url: type: string description: >- Reference image. The characters, background, and other elements in the generated video will be based on the reference image. - Video content requirements: * Character proportions should match the reference action proportions as much as possible; avoid using full-body actions to drive half-body characters * Characters must show clear upper body or full body limbs and head, avoid occlusion * Avoid extreme character orientations such as upside-down or lying flat; character proportion in frame must not be too low * Supports realistic/stylized characters (including humans/humanoid animals/partial animals/characters with humanoid limb proportions) - Supports image Base64 encoding or image URL (must be accessible) - Note: When using Base64, do not add any prefix (e.g., data:image/png;base64,) before the Base64 string; pass the Base64 encoded string directly. - Correct Base64 parameter: `iVBORw0KGgoAAAANSUhEUgAAAAUA...` - Incorrect Base64 parameter (includes data: prefix): `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...` - Supported image formats: .jpg / .jpeg / .png - Image file size must not exceed 10MB, image dimensions between 300px~65536px, aspect ratio between 1:2.5 ~ 2.5:1 video_url: type: string description: >- Reference video URL. The character motion in the generated video will match the reference video. - Video content requirements: * Characters must show clear upper body or full body limbs and head, avoid occlusion * Recommend uploading single-person action video; for 2+ people, the largest character action will be used * Real person actions recommended; some stylized characters/humanoid limb proportions may work * Action video should be a single continuous shot with the character always visible; avoid cuts, camera movements, etc., otherwise content will be truncated * Avoid excessively fast actions; relatively smooth actions produce better results - Video files support .mp4/.mov, file size must not exceed 100MB, both width and height must be between 340px~3850px; validation failures will return error codes - Minimum video duration is 3 seconds; maximum duration depends on character orientation reference (character_orientation): * When character orientation matches the video character: max 30 seconds * When character orientation matches the image character: max 10 seconds - If your action difficulty is high or speed is fast, there is a chance the result will be shorter than the uploaded video duration because the model can only extract valid action duration; minimum 3s of usable continuous action is needed. Note that consumed credits cannot be refunded; adjust action difficulty and speed accordingly - The system validates video content and will return error codes if issues are found element_list: type: array items: type: object required: - element_id properties: element_id: type: integer format: int64 description: Element ID from the element library. description: >- Element reference list, configured based on element IDs in the element library. - Use key:value format: ```json "element_list":[{ "element_id": 829836802793406551 }]``` - When referencing elements, the generated video can only reference the character orientation from the video - Currently only supports 1 element maxItems: 1 keep_original_sound: type: string enum: - 'yes' - 'no' default: 'yes' description: Whether to keep the original audio of the video. character_orientation: type: string enum: - image - video description: >- Character orientation in the generated video, can match the image or the video - image: Match the character orientation in the image; reference video duration must not exceed 10 seconds - video: Match the character orientation in the video; reference video duration must not exceed 30 seconds - When referencing elements, the generated video can only reference the character orientation from the video mode: type: string enum: - std - pro default: std x-options: - label: 720P value: std - label: 1080P value: pro description: |- Video generation mode - std: Standard mode, cost-effective - pro: Expert mode (high quality), better video quality watermark_info: type: object description: Whether to also generate a watermarked result. properties: enabled: type: boolean description: true to generate watermarked result, false to not generate. callback_url: type: string description: >- Callback notification URL for this task. If configured, the server will proactively notify when the task status changes. external_task_id: type: string description: >- Custom task ID. - Does not override the system-generated task ID, but supports querying by this ID. - Must be unique per user. SubmitResponse: type: object properties: code: type: integer description: Error code; see error codes for details. message: type: string description: Error message. request_id: type: string description: >- Request ID, system-generated, used for request tracking and troubleshooting. data: type: object properties: task_id: type: string description: Task ID, system-generated. task_info: type: object description: Task creation parameter information. properties: external_task_id: type: string description: Client-provided custom task ID. task_status: type: string description: >- Task status. Enum values: submitted, processing, succeed, failed. enum: - submitted - processing - succeed - failed example: submitted created_at: type: integer format: int64 description: Task creation time, Unix timestamp in milliseconds. updated_at: type: integer format: int64 description: Task update time, Unix timestamp in milliseconds. securitySchemes: bearerAuth: type: http scheme: bearer description: 'Pass `Authorization: Bearer ` in the request header.' ````