Parámetros de entrada y salida para llamar a Qwen-MT a través de la interfaz compatible con OpenAI o la API de DashScope.
Referencias: Traducción automática (Qwen-MT)
Compatible con OpenAI
- Región de Singapore
- Región de Virginia
- Región de Pekín
base_url para el SDK: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1Endpoint HTTP: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completionsPrimero, cree una clave API y configúrela como variable de entorno . Si utiliza el SDK de OpenAI, instale el SDK .
Cuerpo de la solicitud |
|
model string (Obligatorio)Nombre del modelo. Compatibles: qwen-mt-plus, qwen-mt-flash, qwen-mt-lite. | |
messages array (Obligatorio)Matriz de mensajes que proporcionan contexto al modelo. Solo se admiten mensajes de usuario.
Tipo de mensaje Mensaje de usuario object (Obligatorio)Un mensaje de usuario que contiene la oración a traducir.
Propiedades content string (Obligatorio)Oración a traducir.role string (Obligatorio)Rol del mensaje de usuario. Debe definirse como user. | |
stream boolean (Opcional) El valor predeterminado es false.Habilita el modo de salida en streaming.Valores válidos:
qwen-mt-flash y qwen-mt-lite devuelven datos de forma incremental (cada fragmento contiene solo contenido nuevo). qwen-mt-plus devuelve datos de forma no incremental (cada fragmento contiene la secuencia completa hasta la fecha). Este comportamiento no se puede cambiar. Ejemplo:II didnI didn'tI didn't laughI didn't laugh after... | |
stream_options object (Opcional)Los elementos de configuración para la salida en streaming. Este parámetro solo tiene efecto cuando stream está establecido en true.
Propiedades include_usage boolean (Opcional) El valor predeterminado es false.Incluya información sobre el consumo de tokens en el último fragmento de datos.Valores válidos:
| |
max_tokens integer (Opcional)Número máximo de tokens a generar. Si la salida excede este valor, la respuesta se trunca.Los valores predeterminado y máximo corresponden a la longitud máxima de salida del modelo. Para obtener más información, consulte Selección de modelos. | |
seed integer (Opcional)Semilla de número aleatorio para resultados reproducibles. Usar la misma seed y los mismos parámetros produce una salida consistente.Rango de valores: [0, 2 31 -1]. | |
temperature float (Opcional) El valor predeterminado es 0.65.Temperatura de muestreo que controla la diversidad del texto generado.Valores más altos producen texto más diverso. Valores más bajos producen texto más determinista.Rango de valores: [0, 2)Tanto temperature como top_p controlan la diversidad del texto. Defina solo uno de ellos. | |
top_p float (Opcional) El valor predeterminado es 0.8.Umbral de probabilidad para el muestreo de núcleo que controla la diversidad del texto generado.Valores más altos producen texto más diverso. Valores más bajos producen texto más determinista.Rango de valores: (0, 1.0]Tanto temperature como top_p controlan la diversidad del texto. Defina solo uno de ellos. | |
top_k integer (Opcional) El valor predeterminado es 1.Tamaño del conjunto de candidatos para el muestreo durante la generación. Por ejemplo, configurar esto como 50 significa que solo los 50 tokens principales por puntuación forman el grupo de muestreo. Los valores más grandes aumentan la aleatoriedad; los valores más pequeños aumentan el determinismo. Si el valor es None o mayor que 100, top_k se desactiva y solo top_p surte efecto.El valor debe ser mayor o igual a 0.Parámetro no estándar de OpenAI. SDK de Python: colóquelo en el objeto extra_body extra_body={"top_k": xxx}. SDK de Node.js o llamadas HTTP: páselo como parámetro de nivel superior. | |
repetition_penalty float (Opcional) El valor predeterminado es 1.0.Penalización por repetición en secuencias consecutivas. Los valores más altos reducen la repetición. Un valor de 1.0 no aplica ninguna penalización. Debe ser mayor que 0, sin límite superior estricto.Parámetro no estándar de OpenAI. SDK de Python: colóquelo en el objeto extra_body extra_body={"repetition_penalty": xxx}. SDK de Node.js o llamadas HTTP: páselo como parámetro de nivel superior. | |
translation_options object (Obligatorio)Parámetros de traducción.
Propiedades source_lang string (Obligatorio)El nombre completo en inglés del idioma de origen. Para obtener más información, consulte Idiomas compatibles. Si configura esto como auto, el modelo detecta automáticamente el idioma de entrada.target_lang string (Obligatorio)El nombre completo en inglés del idioma de destino. Para obtener más información, consulte Idiomas compatibles.terms arrays (Opcional)La matriz de términos a definir cuando utiliza la función Intervención de términos.
Propiedades source string (Obligatorio)El término en el idioma de origen.target string (Obligatorio)El término en el idioma de destino.arrays (Opcional)La matriz de memorias de traducción a definir cuando utiliza la función Memoria de traducción.
Propiedades source string (Obligatorio)La declaración en el idioma de origen.target string (Obligatorio)La declaración en el idioma de destino.string (Opcional)El prompt de dominio a definir cuando utiliza la función Prompting de dominio.Los prompts de dominio deben estar en inglés. extra_body={"translation_options": xxx}. SDK de Node.js o llamadas HTTP: páselo como parámetro de nivel superior. |
Objeto de respuesta de chat (salida sin streaming) | |
id stringID único de solicitud. | |
choices arrayMatriz de contenido generado por el modelo.
Propiedades finish_reason stringRazón por la cual el modelo detuvo la generación de contenido.Valores posibles:
integerÍndice del objeto actual en la matriz choices.message objectMensaje de salida del modelo.
Propiedades content stringResultado de la traducción.refusal stringActualmente fijo en null.role stringEl rol del mensaje. Este valor está fijado como assistant.audio objectActualmente fijo en null.function_call objectActualmente fijo en null.tool_calls arrayActualmente fijo en null. | |
created integerLa marca de tiempo UNIX cuando se creó la solicitud. | |
model stringEl modelo utilizado para la solicitud. | |
object stringEste valor siempre es chat.completion. | |
service_tier stringActualmente fijo en null. | |
system_fingerprint stringActualmente fijo en null. | |
usage objectConsumo de tokens para la solicitud.
Propiedades completion_tokens integerNúmero de tokens en la salida del modelo.prompt_tokens integerNúmero de tokens en la entrada.total_tokens integerTotal de tokens consumidos, igual a prompt_tokens + completion_tokens.completion_tokens_details objectActualmente fijo en null.prompt_tokens_details objectActualmente fijo en null. |
Objeto de fragmento de respuesta de chat (salida en streaming) | |
id stringEl ID único de la llamada. Cada objeto de fragmento tiene el mismo ID. | |
choices arrayUna matriz de contenido generado por el modelo. Si include_usage se define como true, esta matriz está vacía en el último fragmento.
Propiedades delta objectEl contenido de salida devuelto en modo streaming.
Propiedades content stringEl resultado de la traducción. qwen-mt-flash y qwen-mt-lite proporcionan actualizaciones incrementales. qwen-mt-plus proporciona actualizaciones no incrementales.function_call objectActualmente fijo en null.refusal objectActualmente fijo en null.role stringEl rol del objeto de mensaje. Este tiene un valor solo en el primer fragmento.stringEl modelo deja de generar por una de tres razones:
integerEl índice de la respuesta actual en la matriz choices. | |
created integerLa marca de tiempo UNIX cuando se creó la solicitud. Cada fragmento tiene la misma marca de tiempo. | |
model stringEl modelo utilizado para la solicitud. | |
object stringEste valor siempre es chat.completion.chunk. | |
service_tier stringActualmente fijo en null. | |
system_fingerprint stringActualmente fijo en null. | |
usage objectLos tokens consumidos por la solicitud. Esto se devuelve en el último fragmento solo cuando include_usage es true.
Propiedades completion_tokens integerEl número de tokens en la salida del modelo.prompt_tokens integerEl número de tokens de entrada.total_tokens integerEl número total de tokens. Esta es la suma de prompt_tokens y completion_tokens.completion_tokens_details objectActualmente fijo en null.prompt_tokens_details objectActualmente fijo en null. |
DashScope
- Singapore
- Virginia
- Beijing
Endpoint HTTP:
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generationDefina base_url como:- Código Python
- Código Java
Debe crear una clave API y exportar la clave API como variable de entorno . Si utiliza el SDK de DashScope, instale el SDK de DashScope .
Cuerpo de la solicitud |
|
model string (Obligatorio)Nombre del modelo. Compatibles: qwen-mt-plus, qwen-mt-flash, qwen-mt-lite. | |
messages array (Obligatorio)Matriz de mensajes que proporcionan contexto al modelo. Solo se admiten mensajes de usuario.
Tipo de mensaje Mensaje de usuario object (Obligatorio)Un mensaje de usuario que contiene la oración a traducir.
Propiedades content string (Obligatorio)Oración a traducir.role string (Obligatorio)Rol del mensaje de usuario. Debe definirse como user. | |
max_tokens integer (Opcional)Número máximo de tokens a generar. Si la salida excede este valor, la respuesta se trunca.Los valores predeterminado y máximo corresponden a la longitud máxima de salida del modelo. Para obtener más información, consulte Selección de modelos.En el SDK de Java, el parámetro es maxTokens. Para llamadas HTTP, coloque max_tokens en el objeto parameters. | |
seed integer (Opcional)Semilla de número aleatorio para resultados reproducibles. Usar la misma seed y los mismos parámetros produce una salida consistente.Rango de valores: [0, 2 31 -1].Cuando realice una llamada HTTP, coloque seed en el objeto parameters. | |
temperature float (Opcional) El valor predeterminado es 0.65.Temperatura de muestreo que controla la diversidad del texto generado.Valores más altos producen texto más diverso. Valores más bajos producen texto más determinista.Rango de valores: [0, 2)Tanto temperature como top_p controlan la diversidad del texto. Defina solo uno de ellos.Cuando realice una llamada HTTP, coloque temperature en el objeto parameters. | |
top_p float (Opcional) El valor predeterminado es 0.8.Umbral de probabilidad para el muestreo de núcleo que controla la diversidad del texto generado.Valores más altos producen texto más diverso. Valores más bajos producen texto más determinista.Rango de valores: (0, 1.0]Tanto temperature como top_p controlan la diversidad del texto. Defina solo uno de ellos.En el SDK de Java, el parámetro es el objeto topPparameters. | |
repetition_penalty float (Opcional) El valor predeterminado es 1.0.Penalización por repetición en secuencias consecutivas. Los valores más altos reducen la repetición. Un valor de 1.0 no aplica ninguna penalización. Debe ser mayor que 0, sin límite superior estricto.En el SDK de Java, el parámetro es repetitionPenalty. Para llamadas HTTP, agregue repetition_penalty al objeto parameters. | |
top_k integer (Opcional) El valor predeterminado es 1.Tamaño del conjunto de candidatos para el muestreo durante la generación. Por ejemplo, configurar esto como 50 significa que solo los 50 tokens principales por puntuación forman el grupo de muestreo. Los valores más grandes aumentan la aleatoriedad; los valores más pequeños aumentan el determinismo. Si el valor es None o mayor que 100, top_k se desactiva y solo top_p surte efecto.El valor debe ser mayor o igual a 0.En el SDK de Java, el parámetro es topK. Cuando realice una llamada HTTP, configure top_k en el objeto parameters. | |
stream boolean (Opcional)Habilita el modo de salida en streaming.Valores válidos:
qwen-mt-flash y qwen-mt-lite devuelven datos de forma incremental (cada fragmento contiene solo contenido nuevo). qwen-mt-plus devuelve datos de forma no incremental (cada fragmento contiene la secuencia completa hasta la fecha). Este comportamiento no se puede cambiar. Ejemplo:II didnI didn'tI didn't laughI didn't laugh after... Este parámetro solo es compatible con el SDK de Python. Para implementar la salida por streaming con el SDK de Java, llame a la interfaz | |
translation_options object (Obligatorio)Parámetros de traducción.
Propiedades source_lang string (Obligatorio)El nombre completo en inglés del idioma de origen. Para obtener más información, consulte Idiomas compatibles. Si configura esto como auto, el modelo detecta automáticamente el idioma de entrada.target_lang string (Obligatorio)El nombre completo en inglés del idioma de destino. Para obtener más información, consulte Idiomas compatibles.terms arrays (Opcional)La matriz de términos a definir cuando utiliza la función Intervención de términos.
Propiedades source string (Obligatorio)El término en el idioma de origen.target string (Obligatorio)El término en el idioma de destino.arrays (Opcional)La matriz de memorias de traducción a definir cuando utiliza la función Memoria de traducción.
Propiedades source string (Obligatorio)La declaración en el idioma de origen.target string (Obligatorio)La declaración en el idioma de destino.string (Opcional)El prompt de dominio a definir cuando utiliza la función Prompting de dominio.Los prompts de dominio deben estar en inglés.
En el SDK de Java, el parámetro es |
Objeto de respuesta de chat (igual para salida en streaming y sin streaming) | |
status_code stringCódigo de estado de la solicitud. 200 indica éxito; otros valores indican fallo.El SDK de Java no devuelve este parámetro. Si la llamada falla, se lanza una excepción. El mensaje de excepción contiene el contenido de status_code y message. | |
request_id stringID único de solicitud.En el SDK de Java, el parámetro devuelto es requestId. | |
code stringCódigo de error. Vacío en caso de éxito.Solo el SDK de Python devuelve este parámetro. | |
output objectResultado de la llamada.
Propiedades text stringActualmente fijo en null.finish_reason stringRazón por la cual el modelo detuvo la generación de contenido. Valores válidos:
arraySalida del modelo.
Propiedades finish_reason stringValores válidos:
objectMensaje de salida del modelo.
Propiedades role stringRol del mensaje de salida. Fijo como assistant.content stringResultado de la traducción.stringModelo utilizado para esta solicitud. | |
usage objectUso de tokens para la solicitud.
Propiedades input_tokens integerNúmero de tokens de entrada.output_tokens integerNúmero de tokens de salida.total_tokens integerTotal de tokens, igual a input_tokens + output_tokens. |