Skip to main content

モデルの権限の更新

POST /api/v1/models/permissions エンドポイントを呼び出して、指定されたワークスペースにおけるモデルの認可 (推論、ファインチューニング、デプロイメント) を更新します。モデルごとの認可と「一括認可」モードの両方がサポートされています。

前提条件

API キーが作成され、環境変数 DASHSCOPE_API_KEY として設定されている必要があります。詳細については、「環境変数での API キーの設定」をご参照ください。

リクエスト

  • HTTP メソッド: POST
  • リクエスト URL
    {WorkspaceId} をお使いのワークスペース ID に置き換えてください。

    リージョン

    エンドポイント

    China (Beijing)

    https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/permissions

  • 認証: リクエストヘッダーに Authorization: Bearer {API_KEY} を設定します。

リクエストパラメーター

すべてのパラメーターはリクエストボディに含めます。

パラメーター

型

必須

説明

models

Array[Object]

条件付きで必須

モデルごとの認可アイテムのリスト。 access_all_entities が OPEN または CLOSE の場合は空にできます。 KEEP の場合、または指定されていない場合は必須となり、アイテム数は 1~20 にする必要があります。例: [{"model":"qwen-plus","inference":true}]

models[].model

String

はい

モデル ID。 空にすることはできません。例: qwen-plus、 qwen-max。

models[].inference

Boolean

いいえ

モデル呼び出しの権限。 true の場合は推論の権限を付与し、 false の場合は取り消します。指定しない場合は変更されません。デフォルト値:null (変更なし)。

models[].finetune

Boolean

いいえ

モデルトレーニングの権限。 true の場合はファインチューニングの権限を付与し、 false の場合は取り消します。指定しない場合は変更されません。デフォルト値:null (変更なし)。

models[].deploy

Boolean

いいえ

モデルデプロイの権限。 true の場合はデプロイメントの権限を付与し、 false の場合は取り消します。指定しない場合は変更されません。デフォルト値:null (変更なし)。

access_all_entities

String

いいえ

「一括認可」スイッチ。有効値:

  • OPEN: 現在のワークスペース内のすべての推論モデルを一括で認可します (後で追加されるモデルも含む)。

  • CLOSE: 「一括認可」をキャンセルし、過去の推論の認可をクリアします。

  • KEEP: 元のモデルごとの認可設定を維持します (デフォルト)。

OPEN または CLOSE が渡された場合、 models は省略できます。デフォルト値: KEEP。例: OPEN

レスポンスパラメーター

パラメーター

型

説明

request_id

String

リクエスト ID。 例: d5f5201f-ee7a-9e3d-8569-bc0eedec21f9

code

String

エラーコード。 成功した場合は null が返されます。

message

String

エラーメッセージ。 成功した場合は null が返されます。

success

Boolean

呼び出しが成功したかどうかを示します。例: true

output

Object

ビジネスデータ。 このエンドポイントでは null です。

サンプルリクエスト

例 1: モデルごとの認可
curl -X POST "https://dashscope.aliyuncs.com/api/v1/models/permissions" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{
        "models": [
            {"model": "qwen-plus", "inference": true, "finetune": true, "deploy": false},
            {"model": "qwen-max", "inference": true}
        ]
    }'
例 2: 一括認可
curl -X POST "https://dashscope.aliyuncs.com/api/v1/models/permissions" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{"access_all_entities": "OPEN"}'

サンプルレスポンス

成功例:
{
    "code": null,
    "message": null,
    "success": true,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}
失敗例:
{
    "code": "InvalidParameter",
    "message": "Model qwen-xxx is not authorized for Inference",
    "success": false,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

エラーコード

呼び出しが失敗した場合、エラーメッセージが返されます。 エラーコードと解決策の詳細については、「エラーメッセージ」をご参照ください。