---
title: "QuickMLエンドポイントの実行"
url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/quickml/execute-quickml-endpoints/
description: "このページでは、PythonアプリケーションでQuickMLエンドポイントを実行する方法をサンプルコードスニペットと共に説明します。"
last_updated: 2026-03-30T08:10:30Z
service: QuickML
type: general
related_links:
  - name: "QuickML Help"
    url: /ja/quickml/
  - name: "QuickML Pipeline Endpoints"
    url: /ja/quickml/help/pipeline-endpoints/
  - name: "SDK Scopes"
    url: /ja/sdk/python/v1/sdk-scopes
---

# Catalyst QuickML

[Catalyst QuickML](https://docs.catalyst.zoho.com/ja/quickml/)は、ノーコードの機械学習パイプラインビルダーサービスで、事前構築されたMLアルゴリズム、操作、データ前処理技術のホストを実装し、データセットに接続してMLモデルを構築および公開できます。MLパイプラインを公開した後、認証済みのエンドポイントで作成したモデルにアクセスできます。

### QuickMLエンドポイントの実行

以下のコードスニペットを使用すると、公開された[QuickMLエンドポイント](https://docs.catalyst.zoho.com/ja/quickml/help/pipeline-endpoints/)に入力データを渡し、MLモデルの処理に基づいて結果を予測できます。出力は、MLパイプライン作成時に定義されたターゲット列の値の予測を返します。

> **注意:** 

1. 以下のコードスニペットで結果を予測するには、Catalystコンソールを使用してプロジェクト内でMLパイプラインとモデルのエンドポイントを構成および公開しておく必要があります。

2. QuickMLは現在、JP、SA、またはCAデータセンターからアクセスするCatalystユーザーには利用できません。

`quickml`コンポーネントインスタンスは以下のように作成されます。これはサーバーサイドの呼び出しを実行しません。モデルのエンドポイントにキーバリューペアとして入力データを渡すデータディクショナリを作成する必要があります。以下の`endpoint_key`は、プロジェクトで構成されたMLモデルに対して公開されたエンドポイントの一意のIDです。エンドポイントキーと入力データは、実行のために`predict()`メソッドに渡されます。以下のコードで使用されている`app`リファレンスは、SDK初期化時にレスポンスとして返される[Pythonオブジェクト](https://docs.catalyst.zoho.com/ja/sdk/python/v1/setup/#initializing-the-sdk)です。

**使用パラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`endpoint_key`</td>
			<td>**必須**パラメータ。MLモデルに対して公開されたエンドポイントの一意のIDを格納します。</td>
		</tr>
    <tr>
			<td>`input_data`</td>
			<td>**必須**パラメータ。QuickMLエンドポイントに公開するデータを格納します。</td>
		</tr>
	</tbody>
</table>

```python
# 入力データ辞書
input_data = {
    # データセットに応じてカラム名と値を指定する
    "column_name1": "value1",
    "column_name2": "value2",
    "column_name3": "value3",
}
#QuickMLインスタンスを作成する
quickml = app.quick_ml()
#メソッドを実行する
result = quickml.predict("{endpoint_key}", input_data)
#{endpoint_key}をCatalystコンソールからコピーしたエンドポイントキーに置き換える
print(result)

```

受信される出力の構文を以下に示します：

```json
{
   "status":"success",
   "result":[
      "results....."
   ]
}
```

> **情報：** 上記の操作を実行するために必要な権限レベルを確認するには、[SDKスコープの表](https://docs.catalyst.zoho.com/ja/sdk/python/v1/sdk-scopes)を参照してください。