Referência da API para o modelo Qwen-MT - Alibaba Cloud Model Studio: Central de Documentação do Alibaba Cloud

Parâmetros de entrada e saída para chamar o Qwen-MT por meio da interface compatível com OpenAI ou da API do DashScope.

Referências: Tradução automática (Qwen-MT)

Compatível com OpenAI

Região de Pequim

base_url para SDK: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

Endpoint HTTP: POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions

Região de Singapura

base_url para SDK: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

Endpoint HTTP: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions

Região da Virgínia

base_url para SDK: https://dashscope-us.aliyuncs.com/compatible-mode/v1

Endpoint HTTP: POST https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions

Região de Singapura

base_url para SDK: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

Endpoint HTTP: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions

Região da Virgínia

base_url para SDK: https://dashscope-us.aliyuncs.com/compatible-mode/v1

Endpoint HTTP: POST https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions

Região de Pequim

base_url para SDK: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

Endpoint HTTP: POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions

Importante

O Model Studio lançou domínios específicos por workspace para as regiões China (Pequim), Singapura e China (Hong Kong). Os novos domínios dedicados oferecem desempenho superior e maior estabilidade para solicitações de inferência. Recomendamos a migração para os novos domínios:

China (Pequim): de https://dashscope.aliyuncs.com para https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
Singapura: de https://dashscope-intl.aliyuncs.com para https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
China (Hong Kong): de https://cn-hongkong.dashscope.aliyuncs.com para https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com

{WorkspaceId} é o ID do seu workspace, disponível na página Workspace Details no console do Model Studio. O domínio existente permanece totalmente funcional.

Primeiro, crie uma chave de API e configure-a como variável de ambiente . Se você usar o SDK da OpenAI, instale o SDK .

Corpo da solicitação

Uso básico

Python

import os
    from openai import OpenAI

    client = OpenAI(
        # Replace with your Model Studio API key if the environment variable is not set: api_key="sk-xxx"
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region.
        base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
    )
    messages = [
        {
            "role": "user",
            "content": "No me reí después de ver este video"
        }
    ]
    translation_options = {
        "source_lang": "auto",
        "target_lang": "English"
    }

    completion = client.chat.completions.create(
        model="qwen-mt-plus",
        messages=messages,
        extra_body={
            "translation_options": translation_options
        }
    )
    print(completion.choices[0].message.content)

Node.js

// Node.js v18 or later is required. Run the code in an ES Module environment.
        import OpenAI from "openai";

        const openai = new OpenAI(
            {
                // Replace with your Model Studio API key if the environment variable is not set: apiKey: "sk-xxx"
                apiKey: process.env.DASHSCOPE_API_KEY,
                // The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region.
                baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
            }
        );
        const completion = await openai.chat.completions.create({
            model: "qwen-mt-plus", 
            messages: [
                { role: "user", content: "No me reí después de ver este video" }
            ],
            translation_options: {
                source_lang: "auto",
                target_lang: "English"
            }
        });
        console.log(JSON.stringify(completion));

curl

Endpoints and API keys differ by region. The following is the Singapore endpoint.

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \
        -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
            "model": "qwen-mt-plus",
            "messages": [{"role": "user", "content": "No me reí después de ver este video"}],
            "translation_options": {
              "source_lang": "auto",
              "target_lang": "English"
              }
        }'

Intervenção de termos

Python

import os
    from openai import OpenAI

    client = OpenAI(
        # Replace with your Model Studio API key if the environment variable is not set: api_key="sk-xxx"
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region.
        base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
    )
    messages = [
        {
            "role": "user",
            "content": "Este conjunto de biosensores utiliza grafeno, un material novedoso. Su objetivo son los elementos químicos. Su agudo «sentido del olfato» le permite reflejar el estado de salud del cuerpo de forma más profunda y precisa."
        }
    ]
    translation_options = {
        "source_lang": "auto",
        "target_lang": "English",
        "terms": [
            {
                "source": "biosensor",
                "target": "biological sensor"
            },
            {
                "source": "grafeno",
                "target": "graphene"
            },
            {
                "source": "elementos químicos",
                "target": "chemical elements"
            },
            {
                "source": "estado de salud del cuerpo",
                "target": "health status of the body"
            }
        ]
    }

    completion = client.chat.completions.create(
        model="qwen-mt-plus",  # This example uses qwen-mt-plus. You can replace the model name as needed.
        messages=messages,
        extra_body={
            "translation_options": translation_options
        }
    )
    print(completion.choices[0].message.content)

Node.js

// Node.js v18 or later is required. Run the code in an ES Module environment.
        import OpenAI from "openai";

        const openai = new OpenAI(
            {
                // Replace with your Model Studio API key if the environment variable is not set: apiKey: "sk-xxx"
                apiKey: process.env.DASHSCOPE_API_KEY,
                // The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region.
                baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
            }
        );
        const completion = await openai.chat.completions.create({
            model: "qwen-mt-plus",
            messages: [
                { role: "user", content: "Este conjunto de biosensores utiliza grafeno, un material novedoso. Su objetivo son los elementos químicos. Su agudo «sentido del olfato» le permite reflejar el estado de salud del cuerpo de forma más profunda y precisa." }
            ],
            translation_options: {
                source_lang: "auto",
                target_lang: "English",
                terms: [
                    {
                        "source": "biosensor",
                        "target": "biological sensor"
                    },
                    {
                        "source": "grafeno",
                        "target": "graphene"
                    },
                    {
                        "source": "elementos químicos",
                        "target": "chemical elements"
                    },
                    {
                        "source": "estado de salud del cuerpo",
                        "target": "health status of the body"
                    }
                ]
            }
        });
        console.log(JSON.stringify(completion));

curl

Endpoints and API keys differ by region. The following is the Singapore endpoint.

# The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region.
    curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \
        -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "qwen-mt-plus",
          "messages": [
            {
              "role": "user",
              "content": "Este conjunto de biosensores utiliza grafeno, un material novedoso. Su objetivo son los elementos químicos. Su agudo «sentido del olfato» le permite reflejar el estado de salud del cuerpo de forma más profunda y precisa."
            }
          ],
          "translation_options": {
            "source_lang": "auto",
            "target_lang": "English",
            "terms": [
              {
                "source": "biosensor",
                "target": "biological sensor"
              },
              {
                "source": "grafeno",
                "target": "graphene"
              },
              {
                "source": "elementos químicos",
                "target": "chemical elements"
              },
              {
                "source": "estado de salud del cuerpo",
                "target": "health status of the body"
              }
            ]
          }
        }'

Memória de tradução

Python

import os
    from openai import OpenAI

    client = OpenAI(
        # Replace with your Model Studio API key if the environment variable is not set: api_key="sk-xxx"
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region.
        base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
    )
    messages = [
        {
            "role": "user",
            "content": "El siguiente comando muestra la información de la versión de Thrift instalada."
        }
    ]
    translation_options = {
        "source_lang": "auto",
        "target_lang": "English",
        "tm_list": [
            {
                "source": "Puede utilizar uno de los siguientes métodos para consultar la versión del motor de un clúster:",
                "target": "You can use one of the following methods to query the engine version of a cluster:"
            },
            {
                "source": "La versión de Thrift utilizada por nuestro HBase en la nube es la 0.9.0. Por lo tanto, recomendamos que la versión del cliente también sea la 0.9.0. Puede descargar Thrift 0.9.0 desde aquí. El paquete de código fuente descargado se utilizará posteriormente. Primero debe instalar el entorno de compilación de Thrift. Para la instalación desde el código fuente, puede consultar el sitio web oficial de Thrift.",
                "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website."
            },
            {
                "source": "Puede instalar el SDK a través de PyPI. El comando de instalación es el siguiente:",
                "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:"
            }
        ]
    }

    completion = client.chat.completions.create(
        model="qwen-mt-plus",  # This example uses qwen-mt-plus. You can replace the model name as needed.
        messages=messages,
        extra_body={
            "translation_options": translation_options
        }
    )
    print(completion.choices[0].message.content)

Node.js

// Node.js v18 or later is required. Run the code in an ES Module environment.
        import OpenAI from "openai";

        const openai = new OpenAI(
            {
                // Replace with your Model Studio API key if the environment variable is not set: apiKey: "sk-xxx"
                apiKey: process.env.DASHSCOPE_API_KEY,
                // The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region.
                baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
            }
        );
        const completion = await openai.chat.completions.create({
            model: "qwen-mt-plus",
            messages: [
                { role: "user", content: "El siguiente comando muestra la información de la versión de Thrift instalada." }
            ],
            translation_options: {
                source_lang: "auto",
                target_lang: "English",
                tm_list: [
                    {
                        "source": "Puede utilizar uno de los siguientes métodos para consultar la versión del motor de un clúster:",
                        "target": "You can use one of the following methods to query the engine version of a cluster:"
                    },
                    {
                        "source": "La versión de Thrift utilizada por nuestro HBase en la nube es la 0.9.0. Por lo tanto, recomendamos que la versión del cliente también sea la 0.9.0. Puede descargar Thrift 0.9.0 desde aquí. El paquete de código fuente descargado se utilizará posteriormente. Primero debe instalar el entorno de compilación de Thrift. Para la instalación desde el código fuente, puede consultar el sitio web oficial de Thrift.",
                        "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website."
                    },
                    {
                        "source": "Puede instalar el SDK a través de PyPI. El comando de instalación es el siguiente:",
                        "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:"
                    }
                ]
            }
        });
        console.log(JSON.stringify(completion));

curl

Endpoints and API keys differ by region. The following is the Singapore endpoint.

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \
        -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "qwen-mt-plus",
          "messages": [
            {
              "role": "user",
              "content": "El siguiente comando muestra la información de la versión de Thrift instalada."
            }
          ],
          "translation_options": {
            "source_lang": "auto",
            "target_lang": "English",
            "tm_list":[
                  {"source": "Puede utilizar uno de los siguientes métodos para consultar la versión del motor de un clúster:", "target": "You can use one of the following methods to query the engine version of a cluster:"},
                  {"source": "La versión de Thrift utilizada por nuestro HBase en la nube es la 0.9.0. Por lo tanto, recomendamos que la versión del cliente también sea la 0.9.0. Puede descargar Thrift 0.9.0 desde aquí. El paquete de código fuente descargado se utilizará posteriormente. Primero debe instalar el entorno de compilación de Thrift. Para la instalación desde el código fuente, puede consultar el sitio web oficial de Thrift.", "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website."},
                  {"source": "Puede instalar el SDK a través de PyPI. El comando de instalación es el siguiente:", "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:"}
            ]
          }
        }'

Prompt de domínio

Python

import os
    from openai import OpenAI

    client = OpenAI(
        # Replace with your Model Studio API key if the environment variable is not set: api_key="sk-xxx"
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region.
        base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
    )
    messages = [
        {
            "role": "user",
            "content": "La segunda instrucción SELECT devuelve un número que indica la cantidad de filas que habría devuelto la primera instrucción SELECT si no se hubiera utilizado la cláusula LIMIT."
        }
    ]
    translation_options = {
        "source_lang": "auto",
        "target_lang": "English",
        "domains": "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style."
    }

    completion = client.chat.completions.create(
        model="qwen-mt-plus",  
        messages=messages,
        extra_body={
            "translation_options": translation_options
        }
    )
    print(completion.choices[0].message.content)

Node.js

// Node.js v18 or later is required. Run the code in an ES Module environment.
        import OpenAI from "openai";

        const openai = new OpenAI(
            {
                // Replace with your Model Studio API key if the environment variable is not set: apiKey: "sk-xxx"
                apiKey: process.env.DASHSCOPE_API_KEY,
                // The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region.
                baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
            }
        );
        const completion = await openai.chat.completions.create({

            model: "qwen-mt-plus",
            messages: [
                { role: "user", content: "La segunda instrucción SELECT devuelve un número que indica la cantidad de filas que habría devuelto la primera instrucción SELECT si no se hubiera utilizado la cláusula LIMIT." }
            ],
            translation_options: {
                source_lang: "auto",
                target_lang: "English",
                domains: "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style."
            }
        });
        console.log(JSON.stringify(completion));

curl

Endpoints and API keys differ by region. The following is the Singapore endpoint.

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \
        -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
        -H "Content-Type: application/json" \
        -d '{
          "model": "qwen-mt-plus",
          "messages": [
            {
              "role": "user",
              "content": "La segunda instrucción SELECT devuelve un número que indica la cantidad de filas que habría devuelto la primera instrucción SELECT si no se hubiera utilizado la cláusula LIMIT."
            }
          ],
          "translation_options": {
            "source_lang": "auto",
            "target_lang": "English",
            "domains": "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style."
          }
        }'

model string (Obrigatório)

Nome do modelo. Suportados: qwen-mt-plus, qwen-mt-flash, qwen-mt-lite, qwen-mt-turbo.

messages array (Obrigatório)

Array de mensagens que fornecem contexto ao modelo. Apenas mensagens de usuário são suportadas.

Tipo de mensagem

Mensagem do Usuário object (Obrigatório)

Uma mensagem do usuário contendo a frase a ser traduzida.

Propriedades

content string (Obrigatório)

Frase a ser traduzida.

role string (Obrigatório)

Função da mensagem do usuário. Deve ser definida como user.

stream boolean (Opcional) O padrão é false.

Ativa o modo de saída em streaming.

Valores válidos:

false: Retorna a resposta completa após a geração.
true: Retorna a resposta em partes conforme gerada. O cliente reconstrói a resposta completa a partir das partes.

Nota

Os modelos qwen-mt-flash e qwen-mt-lite retornam dados incrementalmente (cada parte contém apenas conteúdo novo). Já os modelos qwen-mt-plus e qwen-mt-turbo retornam dados não incrementalmente (cada parte contém toda a sequência até o momento). Esse comportamento não pode ser alterado. Exemplo:

I didn

I didn't

I didn't laugh

I didn't laugh after

...

stream_options object (Opcional)

Itens de configuração para saída em streaming. Este parâmetro só tem efeito quando stream está definido como true.

Propriedades

include_usage boolean (Opcional) O padrão é false.

Inclui informações de consumo de tokens na última parte dos dados.

Valores válidos:

true
false

max_tokens integer (Opcional)

Número máximo de tokens a serem gerados. Se a saída exceder esse valor, a resposta será truncada.

Os valores padrão e máximo correspondem ao comprimento máximo de saída do modelo. Para mais informações, consulte Seleção de modelo.

seed integer (Opcional)

Semente de número aleatório para resultados reproduzíveis. Usar a mesma seed e os mesmos parâmetros gera uma saída consistente.

Intervalo de valores: [0, 2³¹-1].

temperature float (Opcional) O padrão é 0,65.

Temperatura de amostragem que controla a diversidade do texto gerado.

Valores mais altos produzem texto mais diversificado. Valores mais baixos resultam em texto mais determinístico.

Intervalo de valores: [0, 2)

Tanto temperature quanto top_p controlam a diversidade do texto. Defina apenas um deles.

top_p float (Opcional) O padrão é 0,8.

Limiar de probabilidade para amostragem de núcleo que controla a diversidade do texto gerado.

Valores mais altos produzem texto mais diversificado. Valores mais baixos resultam em texto mais determinístico.

Intervalo de valores: (0, 1,0]

Tanto temperature quanto top_p controlam a diversidade do texto. Defina apenas um deles.

top_k integer (Opcional) O padrão é 1.

Tamanho do conjunto de candidatos para amostragem durante a geração. Por exemplo, definir isso como 50 significa que apenas os 50 principais tokens por pontuação formarão o pool de amostragem. Valores maiores aumentam a aleatoriedade; valores menores aumentam o determinismo. Se o valor for None ou maior que 100, top_k é desativado e apenas top_p tem efeito.

O valor deve ser maior ou igual a 0.

Parâmetro não padrão da OpenAI. SDK Python: coloque no objeto extra_body extra_body={"top_k": xxx}. SDK Node.js ou chamadas HTTP: passe como parâmetro de nível superior.

repetition_penalty float (Opcional) O padrão é 1,0.

Penalidade para repetição em sequências consecutivas. Valores mais altos reduzem a repetição. Um valor de 1,0 não aplica penalidade. Deve ser maior que 0, sem limite superior estrito.

Parâmetro não padrão da OpenAI. SDK Python: coloque no objeto extra_body extra_body={"repetition_penalty": xxx}. SDK Node.js ou chamadas HTTP: passe como parâmetro de nível superior.

translation_options object (Obrigatório)

Parâmetros de tradução.

Propriedades

source_lang string (Obrigatório)

Nome completo em inglês do idioma de origem. Para mais informações, consulte Idiomas suportados. Se você definir isso como auto, o modelo detectará automaticamente o idioma de entrada.

target_lang string (Obrigatório)

Nome completo em inglês do idioma de destino. Para mais informações, consulte Idiomas suportados.

terms arrays (Opcional)

Array de termos a serem definidos ao usar o recurso de Intervenção de termos.

Propriedades

source string (Obrigatório)

O termo no idioma de origem.

target string (Obrigatório)

O termo no idioma de destino.

tm_list arrays (Opcional)

Array de memórias de tradução a serem definidas ao usar o recurso de Memória de tradução.

Propriedades

source string (Obrigatório)

A frase no idioma de origem.

target string (Obrigatório)

A frase no idioma de destino.

domains string (Opcional)

Prompt de domínio a ser definido ao usar o recurso de Prompt de domínio.

Os prompts de domínio devem estar em inglês.

Parâmetro não padrão da OpenAI. SDK Python: coloque no objeto extra_body extra_body={"translation_options": xxx}. SDK Node.js ou chamadas HTTP: passe como parâmetro de nível superior.

Objeto de resposta de chat (saída não streaming)	{ "id": "chatcmpl-999a5d8a-f646-4039-968a-167743ae0f22", "choices": [ { "finish_reason": "stop", "index": 0, "logprobs": null, "message": { "content": "I didn't laugh after watching this video.", "refusal": null, "role": "assistant", "annotations": null, "audio": null, "function_call": null, "tool_calls": null } } ], "created": 1762346157, "model": "qwen-mt-plus", "object": "chat.completion", "service_tier": null, "system_fingerprint": null, "usage": { "completion_tokens": 9, "prompt_tokens": 53, "total_tokens": 62, "completion_tokens_details": null, "prompt_tokens_details": null } }
id `string` ID exclusivo da solicitação.
choices `array` Array de conteúdo gerado pelo modelo. Propriedades finish_reason `string` Motivo pelo qual o modelo parou de gerar conteúdo. Valores possíveis: `stop`: A saída está completa. `length`: Limite de comprimento da saída atingido. index `integer` Índice do objeto atual no array `choices`. message `object` Mensagem de saída do modelo. Propriedades content `string` Resultado da tradução. refusal `string` Atualmente fixo como `null`. role `string` A função da mensagem. Fixo como `assistant`. audio `object` Atualmente fixo como `null`. function_call `object` Atualmente fixo como `null`. tool_calls `array` Atualmente fixo como `null`.
created `integer` Timestamp UNIX de criação da solicitação.
model `string` Modelo usado na solicitação.
object `string` Sempre é `chat.completion`.
service_tier `string` Atualmente fixo como `null`.
system_fingerprint `string` Atualmente fixo como `null`.
usage `object` Consumo de tokens da solicitação. Propriedades completion_tokens `integer` Número de tokens na saída do modelo. prompt_tokens `integer` Número de tokens na entrada. total_tokens `integer` Total de tokens consumidos, igual a `prompt_tokens` + `completion_tokens`. completion_tokens_details `object` Atualmente fixo como `null`. prompt_tokens_details `object` Atualmente fixo como `null`.

Objeto de parte de resposta de chat (saída em streaming)	Saída incremental {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": "", "function_call": null, "refusal": null, "role": "assistant", "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": "I", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " didn", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": "'t", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " laugh", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " after", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " watching", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " this", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " video", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": ".", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": "", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": "stop", "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": "", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": "stop", "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": {"completion_tokens": 9, "prompt_tokens": 56, "total_tokens": 65, "completion_tokens_details": null, "prompt_tokens_details": null}} Saída não incremental {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"","function_call":null,"refusal":null,"role":"assistant","tool_calls":null},"finish_reason":null,"index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":null,"index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I didn","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":null,"index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I didn’t","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":null,"index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I didn’t laugh","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":null,"index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I didn’t laugh after","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":null,"index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I didn’t laugh after watching","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":null,"index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I didn’t laugh after watching this","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":null,"index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I didn’t laugh after watching this video","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":null,"index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I didn’t laugh after watching this video.","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":null,"index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I didn’t laugh after watching this video.","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":"stop","index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[{"delta":{"content":"I didn’t laugh after watching this video.","function_call":null,"refusal":null,"role":null,"tool_calls":null},"finish_reason":"stop","index":0,"logprobs":null}],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":null} {"id":"chatcmpl-478e183e-cbdc-4ea0-aeae-4c2ba1d03e4d","choices":[],"created":1762346453,"model":"qwen-mt-plus","object":"chat.completion.chunk","service_tier":null,"system_fingerprint":null,"usage":{"completion_tokens":9,"prompt_tokens":56,"total_tokens":65,"completion_tokens_details":null,"prompt_tokens_details":null}}
id `string` ID exclusivo da chamada. Cada objeto de parte possui o mesmo ID.
choices `array` Um array de conteúdo gerado pelo modelo. Se `include_usage` estiver definido como `true`, este array estará vazio na última parte. Propriedades delta `object` Conteúdo de saída retornado no modo streaming. Propriedades content `string` Resultado da tradução. Os modelos qwen-mt-flash e qwen-mt-lite fornecem atualizações incrementais. Já os modelos qwen-mt-plus e qwen-mt-turbo fornecem atualizações não incrementais. function_call `object` Atualmente fixo como `null`. refusal `object` Atualmente fixo como `null`. role `string` Função do objeto de mensagem. Possui valor apenas na primeira parte. finish_reason `string` O modelo para de gerar por um destes três motivos: Quando a saída está completa, o valor é `stop`. O valor é `null` durante a geração. `length`: A geração parou porque o limite de comprimento da saída foi atingido. index `integer` Índice da resposta atual no array `choices`.
created `integer` Timestamp UNIX de criação da solicitação. Cada parte possui o mesmo timestamp.
model `string` Modelo usado na solicitação.
object `string` Sempre é `chat.completion.chunk`.
service_tier `string` Atualmente fixo como `null`.
system_fingerprint `string` Atualmente fixo como `null`.
usage `object` Tokens consumidos pela solicitação. Retornado na última parte apenas quando `include_usage` é `true`. Propriedades completion_tokens `integer` Número de tokens na saída do modelo. prompt_tokens `integer` Número de tokens de entrada. total_tokens `integer` Número total de tokens. Corresponde à soma de `prompt_tokens` e `completion_tokens`. completion_tokens_details `object` Atualmente fixo como `null`. prompt_tokens_details `object` Atualmente fixo como `null`.

DashScope

Beijing

Endpoint HTTP: POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation

Não é necessário configurar base_url para chamadas de SDK. O valor padrão é https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1.

Singapore

Endpoint HTTP: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation

Defina base_url como:

Python code

dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

Java code

Método 1:

import com.alibaba.dashscope.protocol.Protocol;
Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1");

Método 2:

import com.alibaba.dashscope.utils.Constants;
Constants.baseHttpApiUrl="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";

Virginia

Endpoint HTTP: POST https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation

Defina base_url como:

Python code

dashscope.base_http_api_url = 'https://dashscope-us.aliyuncs.com/api/v1'

Java code

Método 1:

import com.alibaba.dashscope.protocol.Protocol;
Generation gen = new Generation(Protocol.HTTP.getValue(), "https://dashscope-us.aliyuncs.com/api/v1");

Método 2:

import com.alibaba.dashscope.utils.Constants;
Constants.baseHttpApiUrl="https://dashscope-us.aliyuncs.com/api/v1";

Singapore

Endpoint HTTP: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation

Defina base_url como:

Python code

dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

Java code

Método 1:

import com.alibaba.dashscope.protocol.Protocol;
Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1");

Método 2:

import com.alibaba.dashscope.utils.Constants;
Constants.baseHttpApiUrl="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";

Virginia

Endpoint HTTP: POST https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation

Defina base_url como:

Python code

dashscope.base_http_api_url = 'https://dashscope-us.aliyuncs.com/api/v1'

Java code

Método 1:

import com.alibaba.dashscope.protocol.Protocol;
Generation gen = new Generation(Protocol.HTTP.getValue(), "https://dashscope-us.aliyuncs.com/api/v1");

Método 2:

import com.alibaba.dashscope.utils.Constants;
Constants.baseHttpApiUrl="https://dashscope-us.aliyuncs.com/api/v1";

Beijing

Endpoint HTTP: POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation

Não é necessário configurar base_url para chamadas via SDK. O valor padrão é https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1.

É obrigatório criar uma chave de API e exportar a chave de API como variável de ambiente . Se utilizar o DashScope SDK, instale o DashScope SDK .

Corpo da requisição	Uso básico Python import os import dashscope # The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region. dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "No me reí después de ver este video" } ] translation_options = { "source_lang": "auto", "target_lang": "English", } response = dashscope.Generation.call( # Replace with your Model Studio API key if the environment variable is not set: api_key="sk-xxx" api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # This example uses qwen-mt-plus. You can replace the model name as needed. messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) Java // DashScope SDK 2.20.6 or later is required. import java.lang.System; import java.util.Collections; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // The following is the base_url for the Beijing region. Replace WorkspaceId with your actual workspace ID. Configurations vary by region. Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region. Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("No me reí después de ver este video") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .build(); GenerationParam param = GenerationParam.builder() // If you have not configured the environment variable, replace the following line with your Model Studio API key: .apiKey("sk-xxx") .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { // The following is the base_url for the Beijing region. Replace WorkspaceId with your actual workspace ID. Configurations vary by region. Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("Error message: "+e.getMessage()); e.printStackTrace(); } finally { System.exit(0); } } } curl Os endpoints e as chaves de API diferem por região. A seguir, apresentamos o endpoint de Singapura. `curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "No me reí después de ver este video", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "auto", "target_lang": "English" } } }'` Intervenção de termos Python import os import dashscope # The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region. dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "Este conjunto de biosensores utiliza grafeno, un material novedoso. Su objetivo son los elementos químicos. Su agudo «sentido del olfato» le permite reflejar el estado de salud del cuerpo de forma más profunda y precisa." } ] translation_options = { "source_lang": "auto", "target_lang": "English", "terms": [ { "source": "biosensor", "target": "biological sensor" }, { "source": "grafeno", "target": "graphene" }, { "source": "elementos químicos", "target": "chemical elements" }, { "source": "estado de salud del cuerpo", "target": "health status of the body" } ] } response = dashscope.Generation.call( # Replace with your Model Studio API key if the environment variable is not set: api_key="sk-xxx" api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # This example uses qwen-mt-plus. You can replace the model name as needed. messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) Java // DashScope SDK 2.20.6 or later is required. import java.lang.System; import java.util.Collections; import java.util.Arrays; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.aigc.generation.TranslationOptions.Term; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // The following is the base_url for the Beijing region. Replace WorkspaceId with your actual workspace ID. Configurations vary by region. Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region. Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("Este conjunto de biosensores utiliza grafeno, un material novedoso. Su objetivo son los elementos químicos. Su agudo «sentido del olfato» le permite reflejar el estado de salud del cuerpo de forma más profunda y precisa.") .build(); Term term1 = Term.builder() .source("biosensor") .target("biological sensor") .build(); Term term2 = Term.builder() .source("estado de salud del cuerpo") .target("health status of the body") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .terms(Arrays.asList(term1, term2)) .build(); GenerationParam param = GenerationParam.builder() .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("Error message: "+e.getMessage()); } System.exit(0); } } curl Os endpoints e as chaves de API diferem por região. A seguir, apresentamos o endpoint de Singapura. curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "Este conjunto de biosensores utiliza grafeno, un material novedoso. Su objetivo son los elementos químicos. Su agudo «sentido del olfato» le permite reflejar el estado de salud del cuerpo de forma más profunda y precisa.", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "auto", "target_lang": "English", "terms": [ { "source": "biosensor", "target": "biological sensor" }, { "source": "estado de salud del cuerpo", "target": "health status of the body" } ] } } }' Memória de tradução Python import os import dashscope # The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region. dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "El siguiente comando muestra la información de la versión de Thrift instalada." } ] translation_options = { "source_lang": "auto", "target_lang": "English", "tm_list": [ { "source": "Puede utilizar uno de los siguientes métodos para consultar la versión del motor de un clúster:", "target": "You can use one of the following methods to query the engine version of a cluster:" }, { "source": "La versión de Thrift utilizada por nuestro HBase en la nube es la 0.9.0. Por lo tanto, recomendamos que la versión del cliente también sea la 0.9.0. Puede descargar Thrift 0.9.0 desde aquí. El paquete de código fuente descargado se utilizará posteriormente. Primero debe instalar el entorno de compilación de Thrift. Para la instalación desde el código fuente, puede consultar el sitio web oficial de Thrift.", "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website." }, { "source": "Puede instalar el SDK a través de PyPI. El comando de instalación es el siguiente:", "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:" } ]} response = dashscope.Generation.call( # Replace with your Model Studio API key if the environment variable is not set: api_key="sk-xxx" api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # This example uses qwen-mt-plus. You can replace the model name as needed. messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) Java // DashScope SDK 2.20.6 or later is required. import java.lang.System; import java.util.Collections; import java.util.Arrays; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.aigc.generation.TranslationOptions.Tm; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // The following is the base_url for the Beijing region. Replace WorkspaceId with your actual workspace ID. Configurations vary by region. Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region. Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("El siguiente comando muestra la información de la versión de Thrift instalada.") .build(); Tm tm1 = Tm.builder() .source("Puede utilizar uno de los siguientes métodos para consultar la versión del motor de un clúster:") .target("You can use one of the following methods to query the engine version of a cluster:") .build(); Tm tm2 = Tm.builder() .source("La versión de Thrift utilizada por nuestro HBase en la nube es la 0.9.0. Por lo tanto, recomendamos que la versión del cliente también sea la 0.9.0. Puede descargar Thrift 0.9.0 desde aquí. El paquete de código fuente descargado se utilizará posteriormente. Primero debe instalar el entorno de compilación de Thrift. Para la instalación desde el código fuente, puede consultar el sitio web oficial de Thrift.") .target("The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website.") .build(); Tm tm3 = Tm.builder() .source("Puede instalar el SDK a través de PyPI. El comando de instalación es el siguiente:") .target("You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .tmList(Arrays.asList(tm1, tm2, tm3)) .build(); GenerationParam param = GenerationParam.builder() .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("Error message: "+e.getMessage()); } System.exit(0); } } curl Os endpoints e as chaves de API diferem por região. A seguir, apresentamos o endpoint de Singapura. curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "El siguiente comando muestra la información de la versión de Thrift instalada.", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "auto", "target_lang": "English", "tm_list":[ {"source": "Puede utilizar uno de los siguientes métodos para consultar la versión del motor de un clúster:", "target": "You can use one of the following methods to query the engine version of a cluster:"}, {"source": "La versión de Thrift utilizada por nuestro HBase en la nube es la 0.9.0. Por lo tanto, recomendamos que la versión del cliente también sea la 0.9.0. Puede descargar Thrift 0.9.0 desde aquí. El paquete de código fuente descargado se utilizará posteriormente. Primero debe instalar el entorno de compilación de Thrift. Para la instalación desde el código fuente, puede consultar el sitio web oficial de Thrift.", "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website."}, {"source": "Puede instalar el SDK a través de PyPI. El comando de instalación es el siguiente:", "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:"} ] } } }' Prompting de domínio Python import os import dashscope # The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region. dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "La segunda instrucción SELECT devuelve un número que indica la cantidad de filas que habría devuelto la primera instrucción SELECT si no se hubiera utilizado la cláusula LIMIT." } ] translation_options = { "source_lang": "auto", "target_lang": "English", "domains": "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style." } response = dashscope.Generation.call( # Replace with your Model Studio API key if the environment variable is not set: api_key="sk-xxx" api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) Java // DashScope SDK 2.20.6 or later is required. import java.lang.System; import java.util.Collections; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // The following is the base_url for the Beijing region. Replace WorkspaceId with your actual workspace ID. Configurations vary by region. Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // The following URL is for the Singapore region. When calling, replace WorkspaceId with your actual workspace ID. URLs vary by region. Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("La segunda instrucción SELECT devuelve un número que indica la cantidad de filas que habría devuelto la primera instrucción SELECT si no se hubiera utilizado la cláusula LIMIT.") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .domains("The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style.") .build(); GenerationParam param = GenerationParam.builder() .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { // The following is the base_url for the Beijing region. Replace WorkspaceId with your actual workspace ID. Configurations vary by region. Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("Error message: "+e.getMessage()); } System.exit(0); } } curl Os endpoints e as chaves de API diferem por região. A seguir, apresentamos o endpoint de Singapura. curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "La segunda instrucción SELECT devuelve un número que indica la cantidad de filas que habría devuelto la primera instrucción SELECT si no se hubiera utilizado la cláusula LIMIT.", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "auto", "target_lang": "English", "domains": "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style."} } }'
model `string` (Obrigatório) Nome do modelo. Suportados: qwen-mt-plus, qwen-mt-flash, qwen-mt-lite, qwen-mt-turbo.
messages `array` (Obrigatório) Array de mensagens que fornecem contexto ao modelo. Apenas mensagens de usuário são suportadas. Tipo de mensagem Mensagem do usuário `object` (Obrigatório) Uma mensagem do usuário contendo a frase a ser traduzida. Propriedades content `string` (Obrigatório) Frase a ser traduzida. role `string` (Obrigatório) Função da mensagem do usuário. Deve ser definida como `user`.
max_tokens `integer` (Opcional) Número máximo de tokens a gerar. Se a saída exceder esse valor, a resposta será truncada. Os valores padrão e máximo correspondem ao comprimento máximo de saída do modelo. Para mais informações, consulte Seleção de modelo. No SDK Java, o parâmetro é maxTokens. Para chamadas HTTP, coloque max_tokens no objeto parameters.
seed `integer` (Opcional) Semente de número aleatório para resultados reproduzíveis. Usar o mesmo `seed` e os mesmos parâmetros gera uma saída consistente. Intervalo de valores: `[0, 2³¹-1]`. Ao fazer uma chamada HTTP, coloque seed no objeto parameters.
temperature `float` (Opcional) O padrão é 0,65. Temperatura de amostragem que controla a diversidade do texto gerado. Valores mais altos produzem texto mais diversificado. Valores mais baixos resultam em texto mais determinístico. Intervalo de valores: [0, 2) Tanto `temperature` quanto `top_p` controlam a diversidade do texto. Defina apenas um deles. Ao fazer uma chamada HTTP, coloque temperature no objeto parameters.
top_p `float` (Opcional) O padrão é 0,8. Limiar de probabilidade para amostragem de núcleo que controla a diversidade do texto gerado. Valores mais altos produzem texto mais diversificado. Valores mais baixos resultam em texto mais determinístico. Intervalo de valores: (0, 1,0] Tanto `temperature` quanto `top_p` controlam a diversidade do texto. Defina apenas um deles. No SDK Java, o parâmetro é topPparameters object.
repetition_penalty `float` (Opcional) O padrão é 1,0. Penalidade para repetição em sequências consecutivas. Valores mais altos reduzem a repetição. Um valor de 1,0 não aplica penalidade. Deve ser maior que 0, sem limite superior estrito. No SDK Java, o parâmetro é repetitionPenalty. Para chamadas HTTP, adicione repetition_penalty ao objeto parameters.
top_k `integer` (Opcional) O padrão é 1. Tamanho do conjunto de candidatos para amostragem durante a geração. Por exemplo, definir isso como 50 significa que apenas os 50 principais tokens por pontuação formam o pool de amostragem. Valores maiores aumentam a aleatoriedade; valores menores aumentam o determinismo. Se o valor for None ou maior que 100, top_k é desativado e apenas top_p tem efeito. O valor deve ser maior ou igual a 0. No SDK Java, o parâmetro é topK. Ao fazer uma chamada HTTP, defina top_k no objeto parameters.
stream `boolean` (Opcional) Ativa o modo de saída em streaming. Valores válidos: `false`: Retorna a resposta completa após a geração. `true`: Retorna a resposta em partes conforme é gerada. O cliente reconstrói a resposta completa a partir das partes. Nota qwen-mt-flash e qwen-mt-lite retornam dados incrementalmente (cada parte contém apenas conteúdo novo). qwen-mt-plus e qwen-mt-turbo retornam dados de forma não incremental (cada parte contém toda a sequência até o momento). Esse comportamento não pode ser alterado. Exemplo: I I didn I didn't I didn't laugh I didn't laugh after ... Esse parâmetro é suportado apenas pelo SDK Python. Para implementar saída em streaming com o SDK Java, chame a interface `streamCall`. Para implementar saída em streaming com uma chamada HTTP, defina `X-DashScope-SSE` como `enable` no cabeçalho.
translation_options `object` (Obrigatório) Parâmetros de tradução. Propriedades source_lang `string` (Obrigatório) O nome completo em inglês do idioma de origem. Para mais informações, consulte Idiomas suportados. Se você definir isso como `auto`, o modelo detectará automaticamente o idioma de entrada. target_lang `string` (Obrigatório) O nome completo em inglês do idioma de destino. Para mais informações, consulte Idiomas suportados. terms `arrays` (Opcional) O array de termos a ser definido quando você usa o recurso de Intervenção de termos. Propriedades source `string` (Obrigatório) O termo no idioma de origem. target `string` (Obrigatório) O termo no idioma de destino. tm_list `arrays` (Opcional) O array de memórias de tradução a ser definido quando você usa o recurso de Memória de tradução. Propriedades source `string` (Obrigatório) A declaração no idioma de origem. target `string` (Obrigatório) A declaração no idioma de destino. domains `string` (Opcional) O prompt de domínio a ser definido quando você usa o recurso de Prompting de domínio. Os prompts de domínio devem estar em inglês. No SDK Java, o parâmetro é `translationOptions`. Ao fazer uma chamada HTTP, coloque translation_options no objeto parameters.

Objeto de resposta de chat (igual para saída em streaming e não streaming)	`{ "status_code": 200, "request_id": "9b4ec3b2-6d29-40a6-a08b-7e3c9a51c289", "code": "", "message": "", "output": { "text": null, "finish_reason": "stop", "choices": [ { "finish_reason": "stop", "message": { "role": "assistant", "content": "I didn't laugh after watching this video." } } ], "model_name": "qwen-mt-plus" }, "usage": { "input_tokens": 53, "output_tokens": 9, "total_tokens": 62 } }`
status_code `string` Código de status da requisição. 200 indica sucesso; outros valores indicam falha. O SDK Java não retorna esse parâmetro. Se a chamada falhar, uma exceção será lançada. A mensagem da exceção contém o conteúdo de status_code e message.
request_id `string` ID único da requisição. No SDK Java, o parâmetro retornado é requestId.
code `string` Código de erro. Vazio em caso de sucesso. Apenas o SDK Python retorna esse parâmetro.
output `object` Resultado da chamada. Propriedades text `string` Atualmente fixado como `null`. finish_reason `string` Motivo pelo qual o modelo parou de gerar conteúdo. Valores válidos: O valor é `null` durante a geração. `stop`: O modelo parou de gerar conteúdo naturalmente. `length`: A geração parou porque o limite de comprimento de saída foi atingido. choices `array` Saída do modelo. Propriedades finish_reason `string` Valores válidos: O valor é `null` durante a geração. `stop`: O modelo parou de gerar conteúdo naturalmente. `length`: A geração parou porque o limite de comprimento de saída foi atingido. message `object` Mensagem de saída do modelo. Propriedades role `string` Função da mensagem de saída. Fixada como `assistant`. content `string` Resultado da tradução. model_name `string` Modelo usado nesta requisição.
usage `object` Uso de tokens para a requisição. Propriedades input_tokens `integer` Número de tokens de entrada. output_tokens `integer` Número de tokens de saída. total_tokens `integer` Total de tokens, igual a input_tokens + output_tokens.

Códigos de erro

Se a chamada falhar, consulte Códigos de erro para resolver o problema.

Compatível com OpenAI

Região de Pequim

Região de Singapura

Região da Virgínia

Região de Singapura

Região da Virgínia

Região de Pequim

Corpo da solicitação

Uso básico

Python

Node.js

curl

Intervenção de termos

Python

Node.js

curl

Memória de tradução

Python

Node.js

curl

Prompt de domínio

Python

Node.js

curl

Objeto de resposta de chat (saída não streaming)

Objeto de parte de resposta de chat (saída em streaming)

Saída incremental

Saída não incremental

DashScope

Beijing

Singapore

Python code

Java code

Virginia

Python code

Java code

Singapore

Python code

Java code

Virginia

Python code

Java code

Beijing

Corpo da requisição

Uso básico

Python

Java

curl

Intervenção de termos

Python

Java

curl

Memória de tradução

Python

Java

curl

Prompting de domínio

Python

Java

curl

Objeto de resposta de chat (igual para saída em streaming e não streaming)

Códigos de erro