--- title: "Get scene summary utilization result" slug: "mi-get-transformation-result" updated: 2026-10-08T04:14:07Z published: 2026-10-08T04:14:07Z canonical: "api.ncloud-docs.com/mi-get-transformation-result" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Get scene summary utilization result Available in VPC Get the progress and results of the requested conversion job. If the conversion status is `TRANSFORM_COMPLETED`, the response will include the conversion results for each preset (`result.output`). Since conversions are processed asynchronously, use the conversion job ID returned by the [Request scene summary utilization](/docs/en/mi-request-transformation) to check the status until it reaches the completed state. Note The structure of the conversion result (`result.output`) varies depending on the requested preset. Distinguish the result structure based on the `result.preset` value. ## Request This section describes the request format. The method and URI are as follows: | Method | URI | | --- | --- | | GET | /api/v1/workspaces/{workspace_name}/projects/{project_id}/assets/{asset_id}/scene-summary/transformations/{transformation_id} | ### Request headers For information about the request headers common to all Media Intelligence APIs, see [Media Intelligence request headers](/docs/en/maiu-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94). ### Request path parameters The following describes the parameters. | Field | Type | Required | Description | | --- | --- | --- | --- | | `workspace_name` | String | Required | Workspace name | | `project_id` | String | Required | Project ID - See [Get project list](/docs/en/maiu-list-projects). | | `asset_id` | String | Required | Media asset ID - See [Get media asset list](/docs/en/mi-list-assets). | | `transformation_id` | String | Required | Conversion job ID - See [Request scene summary utilization conversion](/docs/en/mi-request-transformation). | ### Request example The request example is as follows: ``` curl --location --request GET 'https://mi.apigw.ntruss.com/api/v1/workspaces/my-workspace/projects/1234/assets/5678/scene-summary/transformations/2001' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \ --header 'Content-Type: application/json' ``` ## Response This section describes the response format. ### Response body The response body includes the following data: | Field | Type | Required | Description | | --- | --- | --- | --- | | `code` | String | - | [API processing result code](/docs/en/maiu-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C) | | `message` | String | - | [API processing result message](/docs/en/maiu-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C) | | `result` | Object | - | Conversion status and results information | | `result.status` | String | - | Conversion status - `TRANSFORMING` \| `TRANSFORM_COMPLETED` \| `TRANSFORM_FAIL` - `TRANSFORMING`: Conversion in progress. - `TRANSFORM_COMPLETED`: Conversion is complete and results are available. - `TRANSFORM_FAIL`: Conversion failed due to an error. | | `result.transformStatusMessage` | String | - | Detailed error message when conversion fails - Returned only for `TRANSFORM_FAIL` | | `result.preset` | String | - | Used conversion preset - Criteria for distinguishing the `result.output` structure | | `result.locale` | String | - | Conversion result language - Inherits scene summary language. - BCP 47 format (`ko-KR`, `en-US`, `ja-JP`). | | `result.indexId` | Integer | - | Index ID of the scene summary used for the conversion - Returned if the conversion is complete | | `result.presetVersion` | String | - | Preset conversion policy version - Returned if the conversion is complete | | `result.engineVersion` | String | - | Coversion engine version - Returned if the conversion is complete | | `result.outputFields` | Array | - | Applied output field - Returned if the conversion is complete in the `SCENE_DIGEST` preset | | `result.keywordCount` | Integer | - | Number of keywords per applied scene - Returned if `keywords` is included in the `SCENE_DIGEST` preset | | `result.paragraphCount` | Integer | - | Number of summary paragraphs per applied scene - Returned if `paragraphs` is included in the `SCENE_DIGEST` preset | | `result.usage` | Object | - | Usage information - Returned if the conversion is complete: [usage](/docs/en/mi-get-transformation-result#usage) | | `result.output` | Object | - | Conversion results by preset - Returned if the conversion is complete. - `SCENE_DIGEST`: See [output (SCENE_DIGEST)](/docs/en/mi-get-transformation-result#outputscenedigest). - `SCENE_METADATA`: See [output (SCENE_METADATA)](/docs/en/mi-get-transformation-result#outputscenemetadata). | #### `usage` The following describes `usage`. | Field | Type | Required | Description | | --- | --- | --- | --- | | `outputTokens` | Integer | - | Number of output tokens used for billing | #### `output` (SCENE_DIGEST) The following describes the `output` when `preset` is set to `SCENE_DIGEST`. | Field | Type | Required | Description | | --- | --- | --- | --- | | `scenes` | Array | - | List of summary results by scene | | `scenes[].scene` | Integer | - | Scene ID | | `scenes[].startMs` | Integer | - | Scene start time (millisecond) | | `scenes[].endMs` | Integer | - | Scene end time (millisecond) | | `scenes[].title` | String | - | Representative scene title - Returned if `title` is included in `outputFields` | | `scenes[].keywords` | Array | - | List of key scene keywords - Sorted in descending order by importance - Returned if `keywords` is included in `outputFields` | | `scenes[].paragraphs` | Array | - | List of scene summary paragraphs - Returned if `paragraphs` is included in `outputFields` | #### `output` (SCENE_METADATA) The following describes the `output` when `preset` is set to `SCENE_METADATA`. | Field | Type | Required | Description | | --- | --- | --- | --- | | `scenes` | Array | - | List of metadata by scene | | `scenes[].scene` | Integer | - | Scene ID | | `scenes[].startMs` | Integer | - | Scene start time (millisecond) | | `scenes[].endMs` | Integer | - | Scene end time (millisecond) | | `scenes[].timeRange` | Object | - | Display time and timecode information - May be provided for integration with editing tools. - `startTime`, `endTime`: Display time in `HH:MM:SS.mmm` format. - `startTimecode`, `endTimecode`: Timecode in `HH:MM:SS:FF` format. - `frameRate`: Frame rate used to calculate the timecode. | | `scenes[].tags` | Array | - | List of tags for searching and filtering | | `scenes[].content` | Object | - | Observation-based scene metadata: [content](/docs/en/mi-get-transformation-result#content) | #### `content` The following describes `content`. All subfields are optional, and information not observed in the scene is omitted. Since new fields may be added in the future, implement your code to ignore any undefined fields. | Field | Type | Required | Description | | --- | --- | --- | --- | | `objects` | Array | - | List of names of major objects in the scene - People are not included. | | `actions` | Array | - | List of major actions observed in the scene | | `environment` | Object | - | Background information - `place`: Observable location or background - `locationType`: `indoor`, `outdoor`, etc. - `timeOfDay`: `daytime`, `night`, `unknown`, etc. | | `composition` | Object | - | Information on the shot composition - `shotType`: Shot size (e.g., `close_up`, `medium_shot`, `wide_shot`) - `cameraAngle`: Camera angle (e.g., `eye_level`, `high_angle`, `low_angle`) - `cameraMovement`: Camera movement (e.g., `static`, `pan`, `tilt`, `tracking`) | | `persons` | Array | - | List of labeled people - `id`: Identifier for a person within the same asset. - `label`: Person's name. - Does not include anonymous people. | | `textInScene` | Array | - | Original text appearing in the scene (subtitles, signs, on-screen text, etc.) | ### Response status codes For information about the response status codes common to all Media Intelligence APIs, see [Media Intelligence response status codes](/docs/en/maiu-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C). ### Response example The following is a sample response for a conversion in progress (`TRANSFORMING`). ``` { "code": "0", "message": "success", "result": { "status": "TRANSFORMING", "transformStatusMessage": null, "preset": "SCENE_DIGEST", "locale": "en-US" } } ``` The following is a sample response for a completed conversion (`TRANSFORM_COMPLETED`) of the `SCENE_DIGEST` preset. ``` { "code": "0", "message": "success", "result": { "status": "TRANSFORM_COMPLETED", "transformStatusMessage": null, "preset": "SCENE_DIGEST", "locale": "ko-KR", "indexId": 1001, "presetVersion": "1.0.0", "engineVersion": "1.0.0", "outputFields": ["title", "keywords", "paragraphs"], "keywordCount": 5, "paragraphCount": 1, "usage": { "outputTokens": 380 }, "output": { "scenes": [ { "scene": 1, "startMs": 0, "endMs": 5000, "title": "Host's interview opening", "keywords": ["Gwanghwamun", "host", "interview", "square", "start"], "paragraphs": [ "The host announces the start of a citizen interview program at Gwanghwamun Square." ] }, { "scene": 2, "startMs": 5000, "endMs": 12000, "title": "Conducting citizen interviews", "keywords": ["citizens", "daily life", "interview", "street", "conversation"], "paragraphs": [ "Various citizens appear and share their daily lives and thoughts." ] } ] } } } ``` The following is a sample response for a completed conversion (`TRANSFORM_COMPLETED`) of the `SCENE_METADATA` preset. ``` { "code": "0", "message": "success", "result": { "status": "TRANSFORM_COMPLETED", "transformStatusMessage": null, "preset": "SCENE_METADATA", "locale": "ko-KR", "indexId": 1001, "presetVersion": "1.0.0", "engineVersion": "1.0.0", "usage": { "outputTokens": 640 }, "output": { "scenes": [ { "scene": 1, "startMs": 1000, "endMs": 3000, "timeRange": { "startTime": "00:00:01.000", "endTime": "00:00:03.000", "startTimecode": "00:00:01:00", "endTimecode": "00:00:03:00", "frameRate": 29.97 }, "tags": ["office", "laptop", "weekday", "work", "medium shot"], "content": { "objects": ["laptop", "desk"], "actions": ["using laptop", "conversation"], "environment": { "place": "Office", "locationType": "indoor", "timeOfDay": "daytime" }, "composition": { "shotType": "medium_shot", "cameraAngle": "eye_level" }, "persons": [ { "id": "person_1", "label": "Green Kim" } ], "textInScene": ["Q4 REPORT"] } } ] } } } ```