--- title: "シーン要約活用結果の照会" slug: "mi-get-transformation-result" updated: 2026-10-08T07:14:45Z published: 2026-10-08T07:14:45Z 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. # シーン要約活用結果の照会 VPC環境で利用できます。 リクエストした変換タスクの進行状況および結果を照会します。変換の状態が`TRANSFORM_COMPLETED`の場合、レスポンスにプリセットごとの変換結果(`result.output`)が含まれます。変換は非同期で処理されるため、[シーン要約活用のリクエスト](/docs/ja/mi-request-transformation)で返された変換タスク IDを使用し、完了状態になるまで照会を行います。 参考 変換結果(`result.output`)の構造は、リクエストしたプリセットによって異なります。`result.preset`の値を基準に結果の構造を区別してください。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET | /api/v1/workspaces/{workspace_name}/projects/{project_id}/assets/{asset_id}/scene-summary/transformations/{transformation_id} | ### リクエストヘッダ Media Intelligence APIで共通して使用されるヘッダの詳細は、[Media Intelligenceのリクエストヘッダ](/docs/ja/maiu-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストパスパラメータ パラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `workspace_name` | String | Required | ワークスペース名 | | `project_id` | String | Required | プロジェクト ID - [プロジェクトリストの照会](/docs/ja/maiu-list-projects)を参照 | | `asset_id` | String | Required | メディアアセット ID - [メディアアセットリストの照会](/docs/ja/mi-list-assets)を参照 | | `transformation_id` | String | Required | 変換タスク ID - [シーン要約活用変換のリクエスト](/docs/ja/mi-request-transformation)を参照 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` 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' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `code` | String | - | [API処理結果コード](/docs/ja/maiu-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C) | | `message` | String | - | [API処理結果メッセージ](/docs/ja/maiu-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C) | | `result` | Object | - | 変換の状態および結果に関する情報 | | `result.status` | String | - | 変換の状態 - `TRANSFORMING` \| `TRANSFORM_COMPLETED` \| `TRANSFORM_FAIL` - `TRANSFORMING`: 変換が進行中である状態 - `TRANSFORM_COMPLETED`: 変換が完了し、結果の照会が可能な状態 - `TRANSFORM_FAIL`: 変換中にエラーが発生し、失敗した状態 | | `result.transformStatusMessage` | String | - | 変換失敗時のエラーの詳細メッセージ - `TRANSFORM_FAIL`の場合にのみ返す | | `result.preset` | String | - | 使用された変換プリセット - `result.output`の構造を区別する基準 | | `result.locale` | String | - | 変換結果の言語 - シーン要約の言語を継承 - BCP 47形式(`ko-KR`、`en-US`、`ja-JP`) | | `result.indexId` | Integer | - | 変換に使用されたシーン要約が属するインデックス ID - 変換完了時に返す | | `result.presetVersion` | String | - | プリセット変換ポリシーのバージョン - 変換完了時に返す | | `result.engineVersion` | String | - | 変換エンジンのバージョン - 変換完了時に返す | | `result.outputFields` | Array | - | 適用された出力フィールド - `SCENE_DIGEST`プリセットで変換完了時に返す | | `result.keywordCount` | Integer | - | 適用されたシーンごとのキーワード数 - `SCENE_DIGEST`プリセットで`keywords`を含む場合に返す | | `result.paragraphCount` | Integer | - | 適用されたシーンごとの要約段落数 - `SCENE_DIGEST`プリセットで`paragraphs`を含む場合に返す | | `result.usage` | Object | - | 使用量情報 - 変換完了時、返す: [usage](/docs/ja/mi-get-transformation-result#usage) | | `result.output` | Object | - | プリセットごとの変換結果 - 変換完了時に返す - `SCENE_DIGEST`: [output (SCENE_DIGEST)](/docs/ja/mi-get-transformation-result#outputscenedigest)を参照 - `SCENE_METADATA`: [output (SCENE_METADATA)](/docs/ja/mi-get-transformation-result#outputscenemetadata)を参照 | #### `usage` `usage`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `outputTokens` | Integer | - | 課金基準の出力トークン数 | #### `output` (SCENE_DIGEST) `preset`が`SCENE_DIGEST`の場合、`output`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `scenes` | Array | - | シーンごとの要約結果リスト | | `scenes[].scene` | Integer | - | シーン ID | | `scenes[].startMs` | Integer | - | シーン開始時間(ミリ秒) | | `scenes[].endMs` | Integer | - | シーン終了時間(ミリ秒) | | `scenes[].title` | String | - | シーンの代表タイトル - `outputFields`に`title`を含む場合に返す | | `scenes[].keywords` | Array | - | シーンの重要キーワードリスト - 重要度の降順でソート - `outputFields`に`keywords`を含む場合に返す | | `scenes[].paragraphs` | Array | - | シーン要約段落リスト - `outputFields`に`paragraphs`を含む場合に返す | #### `output` (SCENE_METADATA) `preset`が`SCENE_METADATA`の場合、`output`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `scenes` | Array | - | シーンごとのメタデータリスト | | `scenes[].scene` | Integer | - | シーン ID | | `scenes[].startMs` | Integer | - | シーン開始時間 (ミリ秒) | | `scenes[].endMs` | Integer | - | シーン終了時間 (ミリ秒) | | `scenes[].timeRange` | Object | - | 表示用時間およびタイムコード情報 - 編集ツール連携のために提供される場合あり - `startTime`、`endTime`: `HH:MM:SS.mmm`形式の表示用時間 - `startTimecode`、`endTimecode`: `HH:MM:SS:FF`形式のタイムコード - `frameRate`: タイムコード計算基準の frame rate | | `scenes[].tags` | Array | - | 検索・絞り込み用タグリスト | | `scenes[].content` | Object | - | 観察ベースのシーンメタデータ: [content](/docs/ja/mi-get-transformation-result#content) | #### `content` `content`の説明は次の通りです。すべてのサブフィールドは optionalであり、シーン内で観察されなかった情報は省略されます。今後新しいフィールドが追加される可能性があるため、定義されていないフィールドは無視するように実装してください。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `objects` | Array | - | シーン内の主要なオブジェクト名リスト - 人物は含まない | | `actions` | Array | - | シーン内で観察される主要な行為リスト | | `environment` | Object | - | 背景情報 - `place`: 観察可能な場所または背景 - `locationType`: `indoor`、`outdoor`など - `timeOfDay`: `daytime`、`night`、`unknown`など | | `composition` | Object | - | 撮影構図情報 - `shotType`: ショットサイズ(例: `close_up`、`medium_shot`、`wide_shot`) - `cameraAngle`: カメラアングル(例: `eye_level`、`high_angle`、`low_angle`) - `cameraMovement`: カメラワーク(例: `static`、`pan`、`tilt`、`tracking`) | | `persons` | Array | - | ラベリングされた人物リスト - `id`: 同じアセット内の人物識別子 - `label`: 人物名 - 匿名人物は含まない | | `textInScene` | Array | - | シーン内に登場するテキスト(字幕・看板・画面表示など)の原文 | ### レスポンスステータスコード Media Intelligence APIで共通して使用されるレスポンスステータスコードの詳細は、[Media Intelligenceのレスポンスステータスコード](/docs/ja/maiu-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 変換実行中(`TRANSFORMING`)のレスポンス例です。 ``` { "code": "0", "message": "success", "result": { "status": "TRANSFORMING", "transformStatusMessage": null, "preset": "SCENE_DIGEST", "locale": "en-US" } } ``` `SCENE_DIGEST`プリセットの変換完了(`TRANSFORM_COMPLETED`)のレスポンス例です。 ``` { "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": "MCのインタビューオープニング", "keywords": ["光化門", "MC", "インタビュー", "広場", "スタート"], "paragraphs": [ "MCが光化門広場で市民インタビュー番組のスタートを告げる。" ] }, { "scene": 2, "startMs": 5000, "endMs": 12000, "title": "市民インタビューの実施", "keywords": ["市民", "日常", "インタビュー", "街頭", "会話"], "paragraphs": [ "多様な市民が登場し、それぞれの日常や考えを共有する。" ] } ] } } } ``` `SCENE_METADATA`プリセットの変換完了(`TRANSFORM_COMPLETED`)のレスポンス例です。 ``` { "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": ["オフィス", "ノート PC", "日中", "業務", "ミディアムショット], "content": { "objects": ["ノート PC", "デスク"], "actions": ["ノート PCの使用", "会話"], "environment": { "place": "オフィス", "locationType": "indoor", "timeOfDay": "daytime" }, "composition": { "shotType": "medium_shot", "cameraAngle": "eye_level" }, "persons": [ { "id": "person_1", "label": "キム・グリン" } ], "textInScene": ["Q4 REPORT"] } } ] } } } ```