Models - List

サービス:

Azure AI Services

API バージョン:

2024-10-21

Azure OpenAI リソースからアクセスできるすべてのモデルの一覧を取得します。 これには、基本モデルと、Azure OpenAI リソースが所有するすべての正常に完了した微調整済みモデルが含まれます。

GET {endpoint}/openai/models?api-version=2024-10-21

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string (url)	サポートされている Cognitive Services エンドポイント (プロトコルとホスト名など: https://aoairesource.openai.azure.com。"aoairesource" を Azure OpenAI アカウント名に置き換えます)。
api-version	query	True	string	要求された API バージョン。

要求ヘッダー

名前	必須	型	説明
api-key	True	string	コグニティブ サービスの Azure OpenAI アカウント キーをここで指定します。

応答

名前	型	説明
200 OK	ModelList	成功
Other Status Codes	ErrorResponse	エラーが発生しました。

セキュリティ

api-key

コグニティブ サービスの Azure OpenAI アカウント キーをここで指定します。

型: apiKey
/: header

例

Getting all models owned by account.

要求のサンプル

HTTP

GET https://aoairesource.openai.azure.com/openai/models?api-version=2024-10-21

応答のサンプル

状態コード:

200

{
  "data": [
    {
      "status": "succeeded",
      "capabilities": {
        "fine_tune": true,
        "inference": true,
        "completion": true,
        "chat_completion": false,
        "embeddings": false
      },
      "lifecycle_status": "generally-available",
      "deprecation": {
        "fine_tune": 1677662127,
        "inference": 1709284527
      },
      "id": "curie",
      "created_at": 1646126127,
      "object": "model"
    },
    {
      "status": "succeeded",
      "model": "curie",
      "fine_tune": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
      "capabilities": {
        "fine_tune": false,
        "inference": true,
        "completion": true,
        "chat_completion": false,
        "embeddings": false
      },
      "lifecycle_status": "generally-available",
      "deprecation": {
        "inference": 1709284527
      },
      "id": "curie.ft-72a2792ef7d24ba7b82c7fe4a37e379f",
      "created_at": 1646126127,
      "object": "model"
    }
  ],
  "object": "list"
}

定義

名前	説明
Capabilities	資格
Deprecation	廃止
Error	エラー
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
LifeCycleStatus	LifeCycleStatus
Model	モデル
ModelList	ModelList
TypeDiscriminator	TypeDiscriminator

Capabilities

Object

資格

名前	型	説明
chat_completion	boolean	モデルがチャット完了をサポートしているかどうかを示す値。
completion	boolean	モデルが完了をサポートしているかどうかを示す値。
embeddings	boolean	モデルが埋め込みをサポートしているかどうかを示す値。
fine_tune	boolean	モデルを微調整に使用できるかどうかを示す値。
inference	boolean	モデルをデプロイできるかどうかを示す値。

Deprecation

Object

廃止

名前	型	説明
fine_tune	integer (unixtime)	このモデルの微調整サポートの終了日。 モデルを微調整するために null されます。
inference	integer (unixtime)	このモデルの推論サポートの終了日。

Error

Object

エラー

名前	型	説明
code	ErrorCode	ErrorCode Microsoft REST ガイドライン (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses) で定義されているエラー コード。
details	Error[]	エラーの詳細 (使用可能な場合)。
innererror	InnerError	InnerError Microsoft REST ガイドライン (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses) で定義されている内部エラー。
message	string minLength: 1	このエラーのメッセージ。
target	string	エラーが発生した場所 (使用可能な場合)。

ErrorCode

列挙

ErrorCode

値	説明
conflict	要求された操作が現在のリソースの状態と競合しています。
contentFilter	安全システムの結果、画像の生成に失敗しました。
fileImportFailed	ファイルのインポートに失敗しました。
forbidden	この操作は、現在のユーザー/API キーでは禁止されています。
internalFailure	内部エラー。 再試行してください。
invalidPayload	要求データがこの操作に対して無効です。
itemDoesAlreadyExist	項目は既に存在します。
jsonlValidationFailed	jsonl データの検証に失敗しました。
notFound	リソースが見つかりません。
quotaExceeded	クォータを超えました。
serviceUnavailable	このサービスは現在使用できません。
tooManyRequests	要求が多すぎます。 後で再試行してください。
unauthorized	現在のユーザー/API キーは、操作に対して承認されていません。
unexpectedEntityState	この操作は、現在のリソースの状態では実行できません。

ErrorResponse

Object

ErrorResponse

名前	型	説明
error	Error	エラー Microsoft REST ガイドライン (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses) で定義されているエラー コンテンツ。

FineTuningState

列挙

FineTuningState

値	説明
cancelled	操作が取り消され、不完全です。 これは、終了状態として分類できます。
created	操作が作成されました。 この状態は Azure OpenAI によって返されず、互換性のためにのみ公開されます。 非アクティブな状態として分類できます。
failed	操作はエラーで処理を完了しており、それ以上使用することはできません。 これは、終了状態として分類できます。
pending	この操作は、今後処理されるキューにまだありません。 非アクティブな状態として分類できます。
running	操作の処理が開始されました。 アクティブな状態として分類できます。
succeeded	操作が正常に処理され、使用する準備が整いました。 これは、終了状態として分類できます。

InnerError

Object

InnerError

名前	型	説明
code	InnerErrorCode	InnerErrorCode Microsoft REST ガイドライン (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses) で定義されている内部エラー コード。
innererror	InnerError	InnerError Microsoft REST ガイドライン (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses) で定義されている内部エラー。

InnerErrorCode

列挙

InnerErrorCode

値	説明
invalidPayload	要求データがこの操作に対して無効です。

LifeCycleStatus

列挙

LifeCycleStatus

値	説明
generally-available	モデルは一般提供されています。
preview	モデルはプレビュー段階であり、サービス プレビューの用語でカバーされています。

Model

Object

モデル

名前	型	説明
capabilities	Capabilities	資格 基本モデルまたは微調整モデルの機能。
created_at	integer (unixtime)	このジョブまたは項目が作成されたときのタイムスタンプ (unix エポック)。
deprecation	Deprecation	廃止 モデルのさまざまなユース ケースの非推奨の日付を定義します。 通常、基本モデルでは、作成後 1 年間の微調整がサポートされます。 推論は、通常、基本モデルまたは微調整されたモデルの作成から 2 年後にサポートされます。 正確な日付はプロパティで指定されます。
fine_tune	string	微調整モデルの場合の微調整ジョブ ID (微調整 ID)。それ以外の場合は null。
id	string	この項目の ID。
lifecycle_status	LifeCycleStatus	LifeCycleStatus モデルのライフ サイクルの状態。 注: モデルは "プレビュー" から "一般公開" に昇格できますが、"一般公開" から "プレビュー" に昇格することはできません。
model	string	これが微調整モデルの場合の基本モデル ID (model-id)。それ以外の場合は null。
object	TypeDiscriminator	TypeDiscriminator オブジェクトの型を定義します。
status	FineTuningState	FineTuningState 微調整オブジェクトまたは微調整ジョブの状態。

ModelList

Object

ModelList

名前	型	説明
data	Model[]	項目の一覧。
object	TypeDiscriminator	TypeDiscriminator オブジェクトの型を定義します。

TypeDiscriminator

列挙

TypeDiscriminator

値	説明
batch	このオブジェクトはバッチを表します。
file	このオブジェクトはファイルを表します。
fine_tuning.job	このオブジェクトは、微調整ジョブを表します。
fine_tuning.job.checkpoint	このオブジェクトは、微調整ジョブのチェックポイントを表します。
fine_tuning.job.event	このオブジェクトは、微調整ジョブのイベントを表します。
list	このオブジェクトは、他のオブジェクトの一覧を表します。
model	このオブジェクトは、モデルを表します (基本モデルまたは微調整ジョブの結果を指定できます)。
upload	このオブジェクトは、ファイルのアップロードを表します。
upload.part	このオブジェクトは、ファイルのアップロードの一部を表します。