Kling V3 Omni API | MindVideo API

1

Calling the API

Submit a task to MindVideo with your platform model slug. The response includes a request ID, task ID, normalized status, and estimated cost.

For production retries, send a unique Idempotency-Key per business request. Reusing the same key with the same payload returns the original task without charging again; reusing it with different input returns 409.

Submit a request

curl -X POST https://api.mindvideo.ai/api/v1/tasks \
  -H "Authorization: Bearer mv_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: task_$(date +%s)" \
  -d '{
  "model": "kling-v3-omni",
  "input": {
    "prompt": "一只金毛犬在沙滩上奔跑，日落，电影质感",
    "aspect_ratio": "16:9",
    "duration": 5,
    "mode": "std"
  }
}'

2

Authentication

Every server-side request must include an API key in the Authorization header. Keys can be created, disabled, and deleted from the dashboard.

Keep API keys server-sideDo not expose production API keys in browser code. Route user requests through your own backend before calling MindVideo.

3

Queue and polling

The platform maps runtime states into queued, processing, succeeded, failed, or cancelled so clients do not depend on model-specific fields.

Submit a request

Create an async generation task and poll the task endpoint for terminal status updates.

Fetch status

curl https://api.mindvideo.ai/api/v1/tasks/task_demo_model \
  -H "Authorization: Bearer mv_live_xxx"

Fetch task events

curl https://api.mindvideo.ai/api/v1/tasks/task_demo_model/events \
  -H "Authorization: Bearer mv_live_xxx"

Read the result

{
  "request_id": "req_demo_model",
  "task_id": "task_demo_model",
  "status": "succeeded",
  "cost_estimate": 0.0756,
  "cost_actual": 0.0756,
  "output": {
    "videos": [
      {
        "url": "https://example.com/output/demo.mp4"
      }
    ]
  }
}

4

Files

Inputs can reference hosted files or compact data URIs depending on model constraints. Production apps should prefer stable hosted URLs.

Data URI

Useful for small test assets and local playground experiments.

Hosted URL

Recommended for production workloads, retries, and larger image or video inputs.

5

Schema

Input

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "mode": {
      "enum": [
        "std",
        "pro",
        "4k"
      ],
      "type": "string",
      "title": "Mode",
      "default": "std"
    },
    "audio": {
      "type": "boolean",
      "title": "Audio",
      "default": false
    },
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "minLength": 1,
      "description": "Positive prompt. Supports <<<image_N>>> syntax to reference image_urls.",
      "x-playground": {
        "rows": 6,
        "widget": "textarea"
      }
    },
    "duration": {
      "type": "integer",
      "title": "Duration",
      "default": 5,
      "maximum": 15,
      "minimum": 3
    },
    "shot_type": {
      "enum": [
        "customize",
        "intelligence"
      ],
      "type": "string",
      "title": "Shot type",
      "x-playground": {
        "advanced": true
      }
    },
    "watermark": {
      "type": "boolean",
      "title": "Watermark",
      "default": false
    },
    "image_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Reference images",
      "description": "Image URLs referenced in prompt via <<<image_N>>> syntax.",
      "x-playground": {
        "accept": "image/*",
        "widget": "file-upload",
        "advanced": true,
        "multiple": true,
        "uploadKind": "image"
      }
    },
    "multi_shot": {
      "type": "boolean",
      "title": "Multi shot",
      "default": false,
      "x-playground": {
        "advanced": true
      }
    },
    "video_list": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "video_url"
        ],
        "properties": {
          "video_url": {
            "type": "string"
          },
          "refer_type": {
            "enum": [
              "base",
              "feature"
            ],
            "type": "string"
          },
          "keep_original_sound": {
            "enum": [
              "no",
              "yes"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "title": "Reference videos",
      "maxItems": 1,
      "description": "At most one reference video. base is video editing; feature is feature reference.",
      "x-playground": {
        "accept": "video/*",
        "widget": "file-upload",
        "advanced": true,
        "uploadKind": "video"
      }
    },
    "aspect_ratio": {
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "type": "string",
      "title": "Aspect ratio",
      "default": "16:9"
    },
    "element_list": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "title": "Element list",
      "x-playground": {
        "advanced": true
      }
    },
    "multi_prompt": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "index",
          "prompt",
          "duration"
        ],
        "properties": {
          "index": {
            "type": "integer"
          },
          "prompt": {
            "type": "string"
          },
          "duration": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      },
      "title": "Multi prompt",
      "x-playground": {
        "advanced": true
      }
    },
    "negative_prompt": {
      "type": "string",
      "title": "Negative prompt",
      "maxLength": 2500,
      "x-playground": {
        "rows": 3,
        "widget": "textarea",
        "advanced": true
      }
    },
    "image_with_roles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "role"
        ],
        "properties": {
          "url": {
            "type": "string"
          },
          "role": {
            "enum": [
              "first_frame",
              "last_frame",
              "reference"
            ],
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "title": "Images with roles",
      "description": "Recommended image-to-video input. image_urls and image_with_roles are mutually exclusive.",
      "x-playground": {
        "advanced": true
      }
    }
  },
  "additionalProperties": false
}

Output example

{
  "request_id": "req_demo_model",
  "task_id": "task_demo_model",
  "status": "succeeded",
  "cost_estimate": 0.0756,
  "cost_actual": 0.0756,
  "output": {
    "videos": [
      {
        "url": "https://example.com/output/demo.mp4"
      }
    ]
  }
}