Alibaba Cloud Model Studio:ChangeParseSetting

Configura el método de análisis para tipos de archivos específicos. Por ejemplo, especifica el análisis de documentos con modelos grandes para archivos .pdf o el análisis VL de Qwen para archivos .jpg.

Descripción de la operación

• Los usuarios de Resource Access Management (RAM) deben obtener primero permisos de API para Alibaba Cloud Model Studio (requiere AliyunBailianDataFullAccess, que incluye el permiso sfm:ChangeParseSetting) y unirse a un espacio de trabajo antes de invocar esta operación. Las cuentas de Alibaba Cloud pueden invocar esta operación directamente sin autorización. Invoque esta operación utilizando la versión más reciente del SDK de Alibaba Cloud Model Studio.
• Esta operación no es idempotente.

Limitación: Esta operación se limita si se llama con demasiada frecuencia. No exceda las 10 llamadas por segundo. Si se limita, reinténtelo más tarde.

Probar ahora

Pruebe esta API en OpenAPI Explorer; no es necesaria la firma manual. Las llamadas exitosas generan automáticamente código SDK que coincide con sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Prueba

Autorización de RAM

La siguiente tabla describe la autorización necesaria para llamar a esta API. Puede definirla en una política de Resource Access Management (RAM). Las columnas de la tabla se detallan a continuación:

• Action: Las acciones se pueden utilizar en el elemento Action de las declaraciones de políticas de permisos de RAM para otorgar permisos para realizar la operación.

• API: La API que puede llamar para realizar la acción.

• Nivel de acceso: El nivel de acceso predefinido otorgado para cada API. Valores válidos: create, list, get, update y delete.

• Tipo de recurso: El tipo de recurso que admite la autorización para realizar la acción. Indica si la acción admite permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción. De lo contrario, la política será ineficaz.

  • Para las API con permisos a nivel de recurso, los tipos de recursos requeridos están marcados con un asterisco (*). Especifique el Nombre de recurso de Alibaba Cloud (ARN) correspondiente en el elemento Resource de la política.
  • Para las API sin permisos a nivel de recurso, se muestra como Todos los recursos. Utilice un asterisco (*) en el elemento Resource de la política.

• Clave de condición: Las claves de condición definidas por el servicio. La clave permite un control granular, aplicándose ya sea solo a las acciones o a las acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de claves de condición comunes aplicables a todos los servicios compatibles con RAM.

• Acción dependiente: Las acciones dependientes necesarias para ejecutar la acción. Para completar la acción, el usuario de RAM o el rol de RAM debe tener los permisos para realizar todas las acciones dependientes.

Acción	Nivel de acceso	Tipo de recurso	Clave de condición	Acción dependiente
sfm:ChangeParseSetting	update	*Todos los recursos *	None	None

Sintaxis de la solicitud

PUT /{WorkspaceId}/datacenter/parser/settings HTTP/1.1

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
WorkspaceId	string	Sí	El ID del espacio de trabajo al que pertenece la categoría. Para obtener información sobre cómo conseguir el ID del espacio de trabajo, consulte Cómo usar un espacio de trabajo.	llm-3z7uw7fwz0vxxxx

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
CategoryId	string	Sí	El ID de la categoría, que es el CategoryId devuelto por la operación AddCategory. También puede obtenerlo haciendo clic en el icono de ID junto al nombre de la categoría en la pestaña Datos de la aplicación - Datos no estructurados.	cate_cdd11b1b79a74e8bbd675c356a91ee35xxxxxxxx
FileType	string	Sí	El tipo de archivo (extensión). Valores válidos: doc docx ppt pptx xls xlsx md txt pdf png jpg jpeg bmp gif html	pdf
Parser	string	Sí	El código identificador del analizador. Los diferentes analizadores son aplicables a distintos escenarios. Para más información, consulte "Base de conocimientos". Valores válidos: DOCMIND (Análisis inteligente de documentos) DOCMIND_DIGITAL (Análisis de documentos electrónicos) DOCMIND_LLM_VERSION (Análisis de documentos con modelos grandes) DASH_QWEN_VL_PARSER (Análisis VL de Qwen) DOCMIND_LLM_VERSION_MEDIA (Análisis de audio/video) Valores válidos: DOCMIND : Análisis inteligente de documentos. DOCMIND_LLM_VERSION : Análisis de documentos con modelos grandes. DOCMIND_DIGITAL : Análisis de documentos electrónicos. DASH_QWEN_VL_PARSER : Análisis VL de Qwen.	DOCMIND
ParserConfig	object	No	La configuración del analizador. Este parámetro es obligatorio solo cuando el analizador está configurado como Análisis VL de Qwen.
modelName	string	No	El nombre del modelo. Valores válidos: qwen3-vl-plus : qwen3-vl-plus	qwen3-vl-plus
modelPrompt	string	No	El prompt utilizado al llamar al análisis VL de Qwen.	# Rol Eres un anotador profesional de contenido de imágenes, experto en reconocer y describir el contenido de las imágenes. # Objetivo de la tarea Describe detalladamente el contenido de la imagen de entrada.

Elementos de respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta
RequestId	string	El ID de la solicitud.	7BA8ADD9-53D6-53F0-918F-A1E776AD230E
Data	object	Los datos comerciales devueltos cuando la solicitud es exitosa.
ChangeResult	boolean	Indica si la configuración fue modificada. Valores válidos: true: La configuración se actualizó. false: La configuración no fue modificada. La modificación falló.	true
Status	string	El código de estado devuelto por la operación.	200
Success	boolean	Indica si la llamada se realizó correctamente. Valores válidos: true: Exitoso. false: Fallido.	true
Message	string	El mensaje de error.	Usuario no autorizado para operar en el recurso especificado.
Code	string	El código de estado de error.	InvalidParameter

Ejemplos

Respuesta exitosa

Formato JSON

{
  "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"
}

Códigos de error

Consulte Códigos de error para obtener una lista completa.

Notas de lanzamiento

Consulte Notas de lanzamiento para obtener una lista completa.