{
  "opencollection": "1.0.0",
  "info": {
    "name": "Kling AI Open Platform API",
    "version": "1.0",
    "description": "Asynchronous generative video and image API for Kuaishou's Kling models. Create a task with POST, then poll the matching GET endpoint by task_id. Auth is a short-lived HS256 JWT passed as a Bearer token."
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{jwtToken}}"
    }
  },
  "items": [
    {
      "info": { "name": "Text-to-Video", "type": "folder" },
      "items": [
        {
          "info": { "name": "Create text-to-video task", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://api.klingai.com/v1/videos/text2video",
            "body": { "type": "json", "data": "{\n  \"model_name\": \"kling-v2-6\",\n  \"prompt\": \"A cinematic drone shot flying over a neon city at night\",\n  \"mode\": \"std\",\n  \"aspect_ratio\": \"16:9\",\n  \"duration\": \"5\"\n}" }
          },
          "docs": "Submit a text prompt to generate a video. Returns a task_id to poll."
        },
        {
          "info": { "name": "Query text-to-video task", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.klingai.com/v1/videos/text2video/:task_id",
            "params": [
              { "name": "task_id", "value": "", "type": "path", "description": "The task id returned by create." }
            ]
          },
          "docs": "Poll until task_status is succeed to retrieve the generated video URL."
        }
      ]
    },
    {
      "info": { "name": "Image-to-Video", "type": "folder" },
      "items": [
        {
          "info": { "name": "Create image-to-video task", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://api.klingai.com/v1/videos/image2video",
            "body": { "type": "json", "data": "{\n  \"model_name\": \"kling-v2-6\",\n  \"image\": \"https://example.com/start.jpg\",\n  \"prompt\": \"the subject slowly turns and smiles\",\n  \"mode\": \"std\",\n  \"duration\": \"5\"\n}" }
          },
          "docs": "Animate a start image (and optional end image) with a motion prompt."
        },
        {
          "info": { "name": "Query image-to-video task", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.klingai.com/v1/videos/image2video/:task_id",
            "params": [
              { "name": "task_id", "value": "", "type": "path", "description": "The task id returned by create." }
            ]
          },
          "docs": "Poll for the generated video URL."
        },
        {
          "info": { "name": "Create multi-image-to-video task", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://api.klingai.com/v1/videos/multi-image2video",
            "body": { "type": "json", "data": "{\n  \"model_name\": \"kling-v1-6\",\n  \"image_list\": [\"https://example.com/a.jpg\", \"https://example.com/b.jpg\"],\n  \"prompt\": \"the two characters meet and shake hands\",\n  \"duration\": \"5\"\n}" }
          },
          "docs": "Compose a video from multiple reference images plus a prompt."
        }
      ]
    },
    {
      "info": { "name": "Video Extension", "type": "folder" },
      "items": [
        {
          "info": { "name": "Create video-extend task", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://api.klingai.com/v1/videos/video-extend",
            "body": { "type": "json", "data": "{\n  \"video_id\": \"ORIGIN_TASK_ID\",\n  \"prompt\": \"continue the camera push forward\"\n}" }
          },
          "docs": "Extend a previously generated video by its origin task/video id."
        },
        {
          "info": { "name": "Query video-extend task", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.klingai.com/v1/videos/video-extend/:task_id",
            "params": [
              { "name": "task_id", "value": "", "type": "path", "description": "The task id returned by create." }
            ]
          },
          "docs": "Poll for the extended video URL."
        }
      ]
    },
    {
      "info": { "name": "Lip-Sync", "type": "folder" },
      "items": [
        {
          "info": { "name": "Create lip-sync task", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://api.klingai.com/v1/videos/lip-sync",
            "body": { "type": "json", "data": "{\n  \"video_id\": \"ORIGIN_TASK_ID\",\n  \"mode\": \"text2video\",\n  \"text\": \"Hello and welcome to the show\",\n  \"voice_id\": \"en_female_1\"\n}" }
          },
          "docs": "Sync a video subject's lips to supplied text (TTS) or an audio file."
        },
        {
          "info": { "name": "Query lip-sync task", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.klingai.com/v1/videos/lip-sync/:task_id",
            "params": [
              { "name": "task_id", "value": "", "type": "path", "description": "The task id returned by create." }
            ]
          },
          "docs": "Poll for the lip-synced video URL."
        }
      ]
    },
    {
      "info": { "name": "Video Effects", "type": "folder" },
      "items": [
        {
          "info": { "name": "Create video-effects task", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://api.klingai.com/v1/videos/effects",
            "body": { "type": "json", "data": "{\n  \"effect_scene\": \"hug\",\n  \"model_name\": \"kling-v1-6\",\n  \"images\": [\"https://example.com/p1.jpg\", \"https://example.com/p2.jpg\"],\n  \"duration\": \"5\"\n}" }
          },
          "docs": "Apply a preset creative effect to one or more input images."
        },
        {
          "info": { "name": "Query video-effects task", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.klingai.com/v1/videos/effects/:task_id",
            "params": [
              { "name": "task_id", "value": "", "type": "path", "description": "The task id returned by create." }
            ]
          },
          "docs": "Poll for the effect video URL."
        }
      ]
    },
    {
      "info": { "name": "Image Generation", "type": "folder" },
      "items": [
        {
          "info": { "name": "Create image-generation task", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://api.klingai.com/v1/images/generations",
            "body": { "type": "json", "data": "{\n  \"model_name\": \"kling-v2-1\",\n  \"prompt\": \"a photorealistic red panda barista, studio lighting\",\n  \"n\": 1,\n  \"aspect_ratio\": \"1:1\"\n}" }
          },
          "docs": "Generate still images from a text prompt with the Kolors models."
        },
        {
          "info": { "name": "Query image-generation task", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.klingai.com/v1/images/generations/:task_id",
            "params": [
              { "name": "task_id", "value": "", "type": "path", "description": "The task id returned by create." }
            ]
          },
          "docs": "Poll for the generated image URLs."
        }
      ]
    },
    {
      "info": { "name": "Virtual Try-On", "type": "folder" },
      "items": [
        {
          "info": { "name": "Create virtual try-on task", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://api.klingai.com/v1/images/kolors-virtual-try-on",
            "body": { "type": "json", "data": "{\n  \"model_name\": \"kolors-virtual-try-on-v1-5\",\n  \"human_image\": \"https://example.com/person.jpg\",\n  \"cloth_image\": \"https://example.com/shirt.jpg\"\n}" }
          },
          "docs": "Composite a garment image onto a person/model image."
        },
        {
          "info": { "name": "Query virtual try-on task", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.klingai.com/v1/images/kolors-virtual-try-on/:task_id",
            "params": [
              { "name": "task_id", "value": "", "type": "path", "description": "The task id returned by create." }
            ]
          },
          "docs": "Poll for the try-on image URLs."
        }
      ]
    },
    {
      "info": { "name": "Account", "type": "folder" },
      "items": [
        {
          "info": { "name": "Query resource-pack balances", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.klingai.com/account/costs"
          },
          "docs": "Return remaining prepaid resource-pack balances and consumption."
        }
      ]
    }
  ]
}