# Get Kling image-to-video task status

`GET /kling/v1/videos/image2video/{task_id}`

Returns the status and result of a Kling image-to-video task.

## Authorizations

Bearer authentication — send `Authorization: Bearer <token>`.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `task_id` | path | string | yes | Task ID |

## Responses

### 200 — Task status returned

```json
{
  "type": "object",
  "description": "Video task status response",
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task ID",
      "example": "abcd1234efgh"
    },
    "status": {
      "type": "string",
      "description": "Task status",
      "enum": [
        "queued",
        "in_progress",
        "completed",
        "failed"
      ],
      "example": "completed"
    },
    "url": {
      "type": "string",
      "description": "Video URL (on success)",
      "example": "https://example.com/video.mp4"
    },
    "format": {
      "type": "string",
      "description": "Video format",
      "example": "mp4"
    },
    "metadata": {
      "type": "object",
      "description": "Video task metadata",
      "properties": {
        "duration": {
          "type": "number",
          "description": "Actual duration of the generated video",
          "example": 5
        },
        "fps": {
          "type": "integer",
          "description": "Actual frame rate",
          "example": 30
        },
        "width": {
          "type": "integer",
          "description": "Actual width",
          "example": 1280
        },
        "height": {
          "type": "integer",
          "description": "Actual height",
          "example": 720
        },
        "seed": {
          "type": "integer",
          "description": "Random seed used",
          "example": 20231234
        }
      }
    },
    "error": {
      "type": "object",
      "description": "Video task error",
      "properties": {
        "code": {
          "type": "integer",
          "description": "Error code"
        },
        "message": {
          "type": "string",
          "description": "Error message"
        }
      }
    }
  }
}
```

### 404 — Task not found

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string",
          "description": "Error message"
        },
        "type": {
          "type": "string",
          "description": "Error type"
        },
        "param": {
          "type": "string",
          "description": "Related parameter",
          "nullable": true
        },
        "code": {
          "type": "string",
          "description": "Error code",
          "nullable": true
        }
      }
    }
  }
}
```