特定のファイルタイプの解析メソッドを設定します。たとえば、.pdf ファイルに large モデルドキュメント解析を指定したり、.jpg ファイルに Qwen VL 解析を指定したりできます。
操作説明
- Resource Access Management (RAM) ユーザーは、この操作を呼び出す前に、Alibaba Cloud Model Studio の API 権限 を取得し(sfm:ChangeParseSetting 権限を含む
AliyunBailianDataFullAccessが必要)、ワークスペースに参加する必要があります。Alibaba Cloud アカウントは、権限付与なしでこの操作を直接呼び出せます。最新の Alibaba Cloud Model Studio SDK を使用してこの操作を呼び出してください。 - この操作は冪等ではありません。
速度制限: この操作は頻繁に呼び出されると速度制限されます。毎秒 10 回を超える呼び出しを行わないでください。速度制限された場合は、後でリトライしてください。
今すぐお試しください
この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。
RAM 認証
下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。
-
アクション:特定のリソースに対して実行可能な操作。ポリシー構文では
Action要素として指定します。 -
API:アクションを具体的に実行するための API。
-
アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。
-
リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーの
Resource要素で対応する ARN を指定してください。 - リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーの
Resource要素でアスタリスク (*) でマークされます。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーの
-
条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
-
依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。
アクション | アクセスレベル | リソースタイプ | 条件キー | 依存アクション |
|---|---|---|---|---|
sfm:ChangeParseSetting | update | *All Resource
| なし | なし |
リクエスト構文
PUT /{WorkspaceId}/datacenter/parser/settings HTTP/1.1
パスパラメーター
パラメーター | 型 | 必須 / 任意 | 説明 | 例 |
|---|---|---|---|---|
| WorkspaceId | string | 必須 | カテゴリが属するワークスペースの ID。ワークスペース ID の取得方法については、「ワークスペースの使用方法」をご参照ください。 | llm-3z7uw7fwz0vxxxx |
リクエストパラメーター
パラメーター | 型 | 必須 / 任意 | 説明 | 例 |
|---|---|---|---|---|
| CategoryId | string | 必須 | カテゴリ ID。AddCategory 操作によって返される | cate_cdd11b1b79a74e8bbd675c356a91ee35xxxxxxxx |
| FileType | string | 必須 | ファイルタイプ (拡張子)。有効な値:
| |
| Parser | string | 必須 | パーサ識別コード。異なるパーサは異なるシナリオに適用されます。詳細については、「ナレッジベース」をご参照ください。有効な値:
列挙値:
| DOCMIND |
| ParserConfig | object | 任意 | パーサ構成。このパラメーターは、パーサが Qwen VL 解析に設定されている場合にのみ必須です。 | |
| modelName | string | 任意 | モデル名。 列挙値:
| qwen3-vl-plus |
| modelPrompt | string | 任意 | Qwen VL 解析の呼び出し時に使用されるプロンプト。 | #角色 你是一个专业的图片内容标注人员,擅长识别并描述出图片中的内容。 # 任务目标 请结合输入图片,详细描述图片中的内容。 |
レスポンスフィールド
フィールド | 型 | 説明 | 例 |
|---|---|---|---|
object | 応答のスキーマ。 | ||
| RequestId | string | リクエスト ID。 | 7BA8ADD9-53D6-53F0-918F-A1E776AD230E |
| Data | object | リクエストが成功した場合に返されるビジネスデータ。 | |
| ChangeResult | boolean | 構成が変更されたかどうかを示します。有効な値:
| true |
| Status | string | 操作によって返される状態コード。 | 200 |
| Success | boolean | 呼び出しが成功したかどうかを示します。有効な値:
| true |
| Message | string | エラーメッセージ。 | User not authorized to operate on the specified resource. |
| Code | string | エラー状態コード。 | InvalidParameter |
例
成功レスポンス
JSONJSON
{
"RequestId": "7BA8ADD9-53D6-53F0-918F-A1E776AD230E",
"Data": {
"ChangeResult": true
},
"Status": "200",
"Success": true,
"Message": "User not authorized to operate on the specified resource.",
"Code": "InvalidParameter"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。