メインコンテンツまでスキップ

API リクエスト

API 環境​

現在、mlflow 環境のみがサポートされています。

MLflow​

mlflow インファレンスサーバーは、以下のような URL を提供します。

  • /invocations: インファレンスのパスです。入力データを POST リクエストを通じて渡し、推論結果を返します。
  • /ping: ヘルスチェック用に使用されます。
  • /health: /ping と同様です。
  • /version: MLflow バージョンを返します。


詳しい内容については、以下のページを参照してください。

https://mlflow.org/docs/latest/deployment/deploy-model-locally.html#inference-server-specification

API リクエストの送信​

リクエストを行う際には、API キーを使用してリクエストする必要があります。そうでない場合、承認されていないリクエストとして処理されません。

API 情報から API URL を確認することができます。ここで確認した URL の後ろにパスを追加して使用できます。\

MLflow リクエストの送信​

上記で確認した API URL の後ろにパスを追加してリクエストできます。以下でいくつかの例を説明します。

  • /ping リクエストを送信する場合
    • API URL の後ろに /ping を追加してリクエストします。
    • https://api-cloud-function.elice.io/2ff51a26-9c2d-414c-86dc-56ae903291a5
    • /ping
  • 推論リクエストを送信する場合
    • API URL の後ろに /invocations を追加してリクエストします。
    • https://api-cloud-function.elice.io/2ff51a26-9c2d-414c-86dc-56ae903291a5/invocations


もし curl コマンドを使用してリクエストするなら、以下のような形になります。

curl --location 'https://api-cloud-function.elice.io/{{api_id}}/invocations' \
  --header 'Authorization: Bearer {{api_key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "inputs": [ {{your_data}} ]
  }'

MLflow で許可されているデータ形式について確認するには、以下の文書を参照してください。https://mlflow.org/docs/latest/deployment/deploy-model-locally.html#accepted-input-formats