Configures the parsing method for specific file types. For example, specifies large model document parsing for .pdf files or Qwen VL parsing for .jpg files.
Operation description
- Resource Access Management (RAM) users must first obtain API permissions for Alibaba Cloud Model Studio (requires
AliyunBailianDataFullAccess, which includes the sfm:ChangeParseSetting permission), and join a workspace before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Invoke this operation by using the latest Alibaba Cloud Model Studio SDK. - This operation is not idempotent.
Try it now
Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.
Test
RAM authorization
The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:
-
Action: The actions can be used in the
Actionelement of RAM permission policy statements to grant permissions to perform the operation. - API: The API that you can call to perform the action.
- Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
-
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the
Resourceelement of the policy. - For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the
Resourceelement of the policy.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the
- Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
- Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.
Action | Access level | Resource type | Condition key | Dependent action |
|---|---|---|---|---|
sfm:ChangeParseSetting | update | *All Resource
| None | None |
Request syntax
Path Parameters
Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| WorkspaceId | string | Yes | The ID of the workspace to which the category belongs. For information about how to obtain the workspace ID, see How to use a workspace. | llm-3z7uw7fwz0vxxxx |
Request parameters
Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| CategoryId | string | Yes | The category ID, which is the | cate_cdd11b1b79a74e8bbd675c356a91ee35xxxxxxxx |
| FileType | string | Yes | The file type (extension). Valid values:
| |
| Parser | string | Yes | The parser identifier code. Different parsers are applicable to different scenarios. For more information, see "Knowledge Base". Valid values:
Valid values:
| DOCMIND |
| ParserConfig | object | No | The parser configuration. This parameter is required only when the parser is set to Qwen VL Parsing. | |
| modelName | string | No | The model name. Valid values:
| qwen-vl-max |
| modelPrompt | string | No | The prompt used when calling Qwen VL Parsing. | #角色 你是一个专业的图片内容标注人员,擅长识别并描述出图片中的内容。 # 任务目标 请结合输入图片,详细描述图片中的内容。 |
Response elements
Element | Type | Description | Example |
|---|---|---|---|
object | Schema of Response | ||
| RequestId | string | The request ID. | 7BA8ADD9-53D6-53F0-918F-A1E776AD230E |
| Data | object | The business data returned when the request is successful. | |
| ChangeResult | boolean | Indicates whether the configuration was changed. Valid values:
| true |
| Status | string | The status code returned by the operation. | 200 |
| Success | boolean | Indicates whether the call was successful. Valid values:
| true |
| Message | string | The error message. | User not authorized to operate on the specified resource. |
| Code | string | The error status code. | InvalidParameter |
Examples
Success response
JSON format