> ## 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. # Kling V3 Omni Video > [Core Function] Kling V3 Omni Video V2V is a multimodal video-to-video endpoint that edits or restyles existing footage using prompt plus optional image and video references. [Strengths] It focuses on source fidelity and subject consistency for Omni-style edit workflows, combining prompt guidance with images and videos inputs so changes stay grounded in the original clip. [Best For] Highly recommended for: reference-faithful video edits, restyling existing takes, keeping characters or products consistent while changing motion or scene instructions, and short-form post workflows that start from real footage. [Limitations] Do NOT use this model for pure text-to-video from scratch; use Kling V3 T2V, Kling V3 Omni T2V, or Kling V3 Turbo T2V. Do NOT use it when you only have a still image and no source video; use Kling V3 I2V or Kling V3 Omni I2V. Do NOT use it for deep physics-reasoning generation better served by Kling Video O1. [Routing] Choose Kling V3 Omni Video V2V when the user already has video to edit or transform and mentions Omni or multimodal references. Prefer Kling Video O1 when reasoning-heavy generation is the goal rather than source-based editing. ## OpenAPI ````yaml /model-api/kling/kling-v2v.json post /kling/kling-v3-omni-video openapi: 3.1.0 info: description: The video-to-video models API from Kling AI. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: Kling Video-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The video-to-video models API from Kling AI. security: - bearerAuth: [] paths: /kling/kling-v3-omni-video: post: summary: Kling V3 Omni Video description: >- [Core Function] Kling V3 Omni Video V2V is a multimodal video-to-video endpoint that edits or restyles existing footage using prompt plus optional image and video references. [Strengths] It focuses on source fidelity and subject consistency for Omni-style edit workflows, combining prompt guidance with images and videos inputs so changes stay grounded in the original clip. [Best For] Highly recommended for: reference-faithful video edits, restyling existing takes, keeping characters or products consistent while changing motion or scene instructions, and short-form post workflows that start from real footage. [Limitations] Do NOT use this model for pure text-to-video from scratch; use Kling V3 T2V, Kling V3 Omni T2V, or Kling V3 Turbo T2V. Do NOT use it when you only have a still image and no source video; use Kling V3 I2V or Kling V3 Omni I2V. Do NOT use it for deep physics-reasoning generation better served by Kling Video O1. [Routing] Choose Kling V3 Omni Video V2V when the user already has video to edit or transform and mentions Omni or multimodal references. Prefer Kling Video O1 when reasoning-heavy generation is the goal rather than source-based editing. operationId: klingV3OmniVideoAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/KlingV3OmniVideoRequest' examples: multi_shot_intelligence: summary: Omni V2V with reference video value: multi_shot: true prompt: >- A woman leaves a subway station and walks into a rainy cyberpunk street, then the camera tracks beside her videos: - https://example.com/source-video.mp4 images: - https://example.com/reference-frame.jpg resolution: 1080p audio: 'off' video_edit: summary: Video editing flow (base video) value: prompt: >- Transform the source clip into a cinematic sci-fi sequence with brighter neon lighting videos: - https://example.com/source-video.mp4 resolution: 1080p audio: original 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-v2v-def456 model_id: model-123 get_result: method: GET url: https://api.modellix.ai/api/v1/tasks/task-v2v-def456 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: KlingV3OmniVideoRequest: type: object required: - prompt - videos properties: prompt: type: string description: >- Video generation prompt. For custom multi-shot storyboards, use `shot n, m, words; shot n, m, words;` where n is the shot index (1-6), m is shot duration in seconds (each >= 1s; sum of all shot durations must equal total duration), and words is the per-shot prompt (max 512 characters). Max length 3072 (recommended <= 2500). minLength: 1 maxLength: 3072 example: >- shot 1, 2, Transform the source clip into a cinematic sci-fi sequence; shot 2, 3, Camera pushes in on the hero against neon city lights; multi_shot: type: boolean description: >- When true, the model automatically plans multi-shot transitions. When false, generates a single continuous shot. default: true example: true images: type: array description: >- Optional reference image list (first/last/refer frames flattened as URLs). Max 4 when a reference video is present. minItems: 1 maxItems: 4 items: type: string description: Reference image URL or Base64 string. minLength: 1 example: https://example.com/reference-frame.jpg videos: type: array description: >- Required reference video list (max 1). Flat URL maps to base video by default. minItems: 1 maxItems: 1 items: type: string description: Reference video URL or Base64 string. minLength: 1 example: https://example.com/source-video.mp4 audio: type: string description: >- Whether to generate audio. Official settings.audio: native | original | off. With reference video, native is not allowed; feature video requires off; base video may use original. default: 'off' enum: - native - original - 'off' example: 'off' resolution: type: string description: Output video resolution. default: 720p enum: - 720p - 1080p - 4k example: 1080p aspect_ratio: type: string description: Video aspect ratio. Optional when a reference video is provided. default: '16:9' enum: - '16:9' - '9:16' - '1:1' example: '16:9' duration: type: integer description: Video duration in seconds (3-15). default: 5 enum: - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 - 11 - 12 - 13 - 14 - 15 example: 8 description: >- Kling V3 Omni V2V — category slice of kling-v3-omni. videos required; images optional; element not exposed. Duration 3-15 with no base-video omit rule. 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 example: task-v2v-abc123 model_id: type: string description: Model ID example: model-123 get_result: type: object description: API information to query the task result properties: method: type: string description: HTTP method example: GET url: type: string description: Full URL to query the task result example: https://api.modellix.ai/api/v1/tasks/task-v2v-abc123 description: Detailed data about the submitted asynchronous task. ErrorResponse: type: object required: - code - message properties: code: type: integer description: Error code (equals HTTP status code) example: 400 message: type: string description: 'Error message in format ''Category: detail''' example: 'Invalid parameters: prompt is required when multi_shot is false' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 400 message: 'Invalid parameters: prompt is required when multi_shot is false' 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`.' ````