---
updatedAt: 2026-02-26T07:54:19.000Z
agentTools:
  projectIndex: https://kollus-vod.readme.io/llms.txt
---

# 콘텐츠 정보

특정 콘텐츠의 상세 정보를 조회합니다.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Kollus Vod API 3.0",
    "contact": {},
    "version": "3.0.0-KR"
  },
  "servers": [
    {
      "url": "https://c-api-kr.kollus.com/api"
    }
  ],
  "paths": {
    "/media-contents/{upload_file_key}": {
      "get": {
        "tags": [
          "콘텐츠 관리"
        ],
        "summary": "콘텐츠 정보 조회",
        "description": "특정 콘텐츠의 상세 정보를 조회합니다.",
        "operationId": "3a926075eb290302ffc5c36aa97fb0fb",
        "parameters": [
          {
            "name": "upload_file_key",
            "in": "path",
            "description": "업로드 파일 키",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ApiVodMediaContent"
                    }
                  },
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Bad request"
          },
          "401": {
            "description": "Unauthenticated"
          },
          "404": {
            "description": "Not found"
          }
        },
        "security": [
          {
            "kollus_api_access_token": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ApiVodMediaContent": {
        "properties": {
          "id": {
            "description": "ID",
            "type": "integer"
          },
          "kind": {
            "description": "콘텐츠 유형 분류 코드 (`1`: 비디오, `2`: 오디오)",
            "type": "integer"
          },
          "kind_name": {
            "description": "콘텐츠 유형",
            "type": "string"
          },
          "title": {
            "description": "콘텐츠 제목",
            "type": "string"
          },
          "upload_file_key": {
            "description": "업로드 파일 키",
            "type": "string"
          },
          "duration": {
            "description": "콘텐츠 전체 길이",
            "type": "string"
          },
          "category_name": {
            "description": "카테고리 이름",
            "type": "string"
          },
          "category_key": {
            "description": "카테고리 키",
            "type": "string"
          },
          "use_encryption": {
            "description": "암호화 적용 여부",
            "type": "boolean"
          },
          "poster_url": {
            "description": "포스터 이미지 URL",
            "type": "string"
          },
          "snapshot_url": {
            "description": "스냅샷 이미지 URL",
            "type": "string"
          },
          "original_file_name": {
            "description": "원본 파일 이름",
            "type": "string"
          },
          "original_file_size": {
            "description": "원본 파일 용량",
            "type": "integer"
          },
          "media_information": {
            "description": "콘텐츠 상세 정보",
            "properties": {
              "file": {
                "description": "파일 속성 정보",
                "properties": {
                  "filesize": {
                    "description": "파일 용량",
                    "type": "string"
                  },
                  "format": {
                    "description": "컨테이너 포맷",
                    "type": "string"
                  },
                  "duration": {
                    "description": "콘텐츠 전체 길이",
                    "type": "string"
                  },
                  "raw_duration": {
                    "description": "가공되지 않은 콘텐츠 길이 정보 (밀리초)",
                    "type": "integer"
                  }
                }
              },
              "video": {
                "description": "비디오 트랙 정보",
                "properties": {
                  "video_codec": {
                    "description": "비디오 코덱",
                    "type": "string"
                  },
                  "video_bitrate": {
                    "description": "비디오 비트레이트",
                    "type": "string"
                  },
                  "video_framerate": {
                    "description": "비디오 프레임레이트",
                    "type": "string"
                  },
                  "video_screen_size": {
                    "description": "비디오 해상도",
                    "type": "string"
                  },
                  "video_framecount": {
                    "description": "비디오 프레임 수",
                    "type": "boolean"
                  },
                  "video_raw_duration": {
                    "description": "가공되지 않은 비디오 트랙 재생 시간",
                    "type": "integer"
                  }
                }
              },
              "audio": {
                "description": "오디오 트랙 정보",
                "properties": {
                  "audio_codec": {
                    "description": "오디오 코덱",
                    "type": "string"
                  },
                  "audio_bitrate": {
                    "description": "오디오 비트레이트",
                    "type": "string"
                  },
                  "audio_samplerate": {
                    "description": "오디오 샘플레이트",
                    "type": "string"
                  },
                  "audio_channel": {
                    "description": "오디오 채널 수",
                    "type": "integer"
                  },
                  "audio_raw_duration": {
                    "description": "가공되지 않은 오디오 트랙 재생 시간",
                    "type": "integer"
                  }
                }
              }
            }
          },
          "human_readable_original_file_size": {
            "description": "원본 파일 용량 (단위: K, M, G, T)",
            "type": "string"
          },
          "transcoding_stage": {
            "description": "트랜스코딩 진행 상태 코드",
            "type": "integer"
          },
          "transcoding_stage_name": {
            "description": "트랜스코딩 진행 상태",
            "type": "string"
          },
          "status": {
            "description": "활성화 상태",
            "type": "boolean"
          },
          "vr_info": {
            "description": "VR 설정 정보",
            "properties": {
              "projection_type": {
                "description": "투영 방식",
                "type": "string"
              },
              "stereo_mode": {
                "description": "사운드 모드",
                "type": "string"
              }
            },
            "type": "object"
          },
          "is_passthrough": {
            "description": "패스스루 처리 여부",
            "type": "boolean"
          },
          "media_content_keys": {
            "description": "미디어 콘텐츠 키 목록",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "transcoded_at": {
            "description": "트랜스코딩 완료 일시",
            "type": "string"
          },
          "created_at": {
            "description": "콘텐츠 등록 일시",
            "type": "string"
          },
          "updated_at": {
            "description": "콘텐츠 정보 수정 일시",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "kollus_api_access_token": {
        "type": "apiKey",
        "description": "Kollus API 접근 토큰",
        "name": "access_token",
        "in": "query"
      }
    }
  }
}
```