> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # Vidu Motion Sync > [Core Function] Vidu Motion Sync is a video-to-video motion transfer model. [Strengths] It excels at accurately extracting physical motion from a source video (e.g., a dancing person) and applying it to a target character image, preserving the target's identity. [Best For] Highly recommended for: creating dance videos with custom characters, transferring complex choreography, and replicating specific physical actions onto avatars. [Limitations] Do NOT use this model if you want to change what a character is saying (use Lip Sync). It requires both a reference video for motion and a target image for appearance. [Routing] Use this model specifically when the user wants to copy the body movements or actions from one video onto a different character. ## OpenAPI ````yaml /model-api/vidu/vidu-v2v.json post /vidu/motion-sync openapi: 3.1.0 info: description: >- The video-to-video models API from Vidu. Includes motion sync, lip sync, and one-click trending replicate. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: Vidu Video-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The video-to-video models API from Vidu. security: - bearerAuth: [] paths: /vidu/motion-sync: post: summary: Vidu Motion Sync description: >- [Core Function] Vidu Motion Sync is a video-to-video motion transfer model. [Strengths] It excels at accurately extracting physical motion from a source video (e.g., a dancing person) and applying it to a target character image, preserving the target's identity. [Best For] Highly recommended for: creating dance videos with custom characters, transferring complex choreography, and replicating specific physical actions onto avatars. [Limitations] Do NOT use this model if you want to change what a character is saying (use Lip Sync). It requires both a reference video for motion and a target image for appearance. [Routing] Use this model specifically when the user wants to copy the body movements or actions from one video onto a different character. operationId: viduMotionSyncAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ViduMotionSyncRequest' examples: basic: summary: Character image and motion video value: image_url: https://example.com/character-portrait.jpg video_url: https://example.com/dance-reference.mp4 responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' example: code: 0 message: success data: status: pending task_id: task-vidu-msync-001 model_id: vidu/motion-sync get_result: method: GET url: https://api.modellix.ai/api/v1/tasks/task-vidu-msync-001 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: ViduMotionSyncRequest: type: object required: - image_url - video_url description: >- Vidu motion sync request. The body movements and poses from `video_url` are transferred onto the character in `image_url`. properties: image_url: type: string minLength: 1 description: >- Target character image. The character's appearance will be preserved while its movements are replaced by those from the reference video. Accepts a URL or base64 data URI. example: https://example.com/character-portrait.jpg video_url: type: string minLength: 1 description: >- Reference motion video URL. The body movements and poses from this video will be applied to the target character. example: https://example.com/dance-reference.mp4 AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier for polling example: task-abc123 model_id: type: string description: Model ID in `provider/model` format example: vidu/viduq3-mix-r2v get_result: type: object description: API information to query the task result properties: method: type: string example: GET url: type: string example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. ErrorResponse: type: object required: - code - message properties: code: type: integer example: 400 message: type: string example: 'Invalid parameters: parameter ''reference_images'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 400 message: 'Invalid parameters: parameter ''reference_images'' is required' Unauthorized: description: Unauthorized - Invalid or missing API Key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 message: 'Authentication failed: invalid API key' TooManyRequests: description: Too many requests - Rate limit exceeded headers: X-RateLimit-Limit: description: Maximum requests per minute schema: type: integer example: 100 X-RateLimit-Remaining: description: Remaining quota in current window schema: type: integer example: 0 X-RateLimit-Reset: description: Rate limit window reset time (Unix timestamp) schema: type: integer example: 1704067260 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 429 message: >- Rate limit exceeded: 100 requests per minute, retry after 60 seconds InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 500 message: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ````