Referência da API para o modelo Qwen-MT - : 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 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

ImportanteO 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.

ObservaçãoOs 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 31 -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

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 31 -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.

Observaçãoqwen-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 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.