Panggil Qwen-MT via API OpenAI & DashScope untuk Aplikasi Multibahasa - Model Studio

Topik ini menjelaskan parameter input dan output untuk memanggil Qwen-MT melalui antarmuka yang Kompatibel dengan OpenAI atau API DashScope.

Referensi: Penerjemahan mesin (Qwen-MT)

Kompatibel dengan OpenAI

Wilayah Singapura

base_url untuk SDK: https://dashscope-intl.aliyuncs.com/compatible-mode/v1

Titik akhir HTTP: POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions

Wilayah Virginia

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

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

Wilayah Beijing

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

Titik akhir HTTP: POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

Anda harus terlebih dahulu membuat Kunci API dan mengonfigurasi Kunci API sebagai Variabel lingkungan. Jika Anda menggunakan SDK OpenAI untuk melakukan panggilan, Anda perlu menginstal SDK.

Body permintaan

Penggunaan dasar

Python

import os
from openai import OpenAI

client = OpenAI(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Berikut ini adalah base_url untuk wilayah Singapura.
    base_url="https://dashscope-intl.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

// Diperlukan Node.js v18 atau versi lebih baru. Jalankan kode dalam lingkungan ES Module.
import OpenAI from "openai";

const openai = new OpenAI(
    {
        // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: apiKey: "sk-xxx",
        apiKey: process.env.DASHSCOPE_API_KEY,
        // Berikut ini adalah base_url untuk wilayah Singapura.
        baseURL: "https://dashscope-intl.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

Setiap wilayah memiliki titik akhir permintaan dan Kunci API yang berbeda. Berikut ini adalah titik akhir permintaan untuk wilayah Singapura.

curl -X POST https://dashscope-intl.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"
      }
}'

Intervensi istilah

Python

import os
from openai import OpenAI

client = OpenAI(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Berikut ini adalah base_url untuk wilayah Singapura.
    base_url="https://dashscope-intl.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",  # Contoh ini menggunakan qwen-mt-plus. Anda dapat mengganti nama model sesuai kebutuhan.
    messages=messages,
    extra_body={
        "translation_options": translation_options
    }
)
print(completion.choices[0].message.content)

Node.js

// Diperlukan Node.js v18 atau versi lebih baru. Jalankan kode dalam lingkungan ES Module.
import OpenAI from "openai";

const openai = new OpenAI(
    {
        // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: apiKey: "sk-xxx",
        apiKey: process.env.DASHSCOPE_API_KEY,
        // Berikut ini adalah base_url untuk wilayah Singapura.
        baseURL: "https://dashscope-intl.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

Setiap wilayah memiliki titik akhir permintaan dan Kunci API yang berbeda. Berikut ini adalah titik akhir permintaan untuk wilayah Singapura.

curl -X POST https://dashscope.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"
      }
    ]
  }
}'

Memori terjemahan

Python

import os
from openai import OpenAI

client = OpenAI(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Berikut ini adalah base_url untuk wilayah Singapura.
    base_url="https://dashscope-intl.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",  # Contoh ini menggunakan qwen-mt-plus. Anda dapat mengganti nama model sesuai kebutuhan.
    messages=messages,
    extra_body={
        "translation_options": translation_options
    }
)
print(completion.choices[0].message.content)

Node.js

// Diperlukan Node.js v18 atau versi lebih baru. Jalankan kode dalam lingkungan ES Module.
import OpenAI from "openai";

const openai = new OpenAI(
    {
        // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: apiKey: "sk-xxx",
        apiKey: process.env.DASHSCOPE_API_KEY,
        // Berikut ini adalah base_url untuk wilayah Singapura.
        baseURL: "https://dashscope-intl.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

Setiap wilayah memiliki titik akhir permintaan dan Kunci API yang berbeda. Berikut ini adalah titik akhir permintaan untuk wilayah Singapura.

curl -X POST https://dashscope-intl.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:"}
    ]
  }
}'

Pemberian petunjuk domain

Python

import os
from openai import OpenAI

client = OpenAI(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan kunci API Model Studio Anda: api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # base_url berikut adalah untuk wilayah Singapura.
    base_url="https://dashscope-intl.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": "Kalimat ini berasal dari domain IT Ali Cloud. Sebagian besar isinya terkait pengembangan perangkat lunak dan metode penggunaan komputer, termasuk banyak istilah yang berhubungan dengan perangkat lunak dan perangkat keras komputer. Saat menerjemahkan, perhatikan terminologi pemecahan masalah profesional dan pola kalimat. Terjemahkan dengan gaya domain IT ini."
}

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 atau yang lebih baru diperlukan. Jalankan kode di lingkungan Modul ES.
import OpenAI from "openai";

const openai = new OpenAI(
    {
        // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan kunci API Model Studio Anda: apiKey: "sk-xxx",
        apiKey: process.env.DASHSCOPE_API_KEY,
        // Berikut ini adalah base_url untuk wilayah Singapura.
        baseURL: "https://dashscope-intl.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: "Kalimat ini berasal dari domain IT Ali Cloud. Ini terutama melibatkan pengembangan perangkat lunak dan metode penggunaan yang terkait dengan komputer, termasuk banyak istilah yang terkait dengan perangkat lunak dan perangkat keras komputer. Perhatikan terminologi pemecahan masalah profesional dan pola kalimat saat menerjemahkan. Terjemahkan ke dalam gaya domain IT ini."
    }
});
console.log(JSON.stringify(completion));

curl

Setiap wilayah memiliki titik akhir permintaan dan Kunci API yang berbeda. Berikut ini adalah titik akhir permintaan untuk wilayah Singapura.

curl -X POST https://dashscope-intl.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 (Wajib)

Nama model. Model yang didukung: qwen-mt-plus, qwen-mt-flash, qwen-mt-lite, dan qwen-mt-turbo.

messages array (Wajib)

Array pesan yang memberikan konteks kepada model. Hanya pesan dari pengguna yang didukung.

Jenis Pesan

Pesan Pengguna object (Wajib)

Pesan pengguna yang berisi kalimat yang akan diterjemahkan.

Properti

content string (Wajib)

Kalimat yang akan diterjemahkan.

role string (Wajib)

Peran pesan pengguna. Nilai ini harus diatur ke user.

stream boolean (Opsional) Default ke false.

Menentukan apakah respons dikembalikan dalam mode keluaran streaming.

Nilai yang valid:

false: Seluruh respons dikembalikan setelah sepenuhnya dihasilkan.
true: Respons dikembalikan dalam potongan data saat dihasilkan. Klien harus membaca potongan-potongan tersebut untuk merekonstruksi respons lengkap.

Catatan

Saat ini, hanya model qwen-mt-flash dan qwen-mt-lite yang mendukung pengembalian data secara inkremental. Setiap potongan data yang dikembalikan hanya berisi konten yang baru dihasilkan. Model qwen-mt-plus dan qwen-mt-turbo mengembalikan data secara non-inkremental. Setiap potongan data yang dikembalikan berisi seluruh urutan yang telah dihasilkan hingga saat itu. Perilaku ini tidak dapat diubah. Contohnya:

I didn

I didn't

I didn't laugh

I didn't laugh after

...

stream_options object (Opsional)

Item konfigurasi untuk keluaran streaming. Parameter ini hanya berlaku ketika stream diatur ke true.

Properti

include_usage boolean (Opsional) Default ke false.

Menentukan apakah informasi konsumsi token disertakan dalam potongan data terakhir.

Nilai yang valid:

true
false

max_tokens integer (Opsional)

Jumlah maksimum token yang akan dihasilkan. Jika konten yang dihasilkan melebihi nilai ini, respons akan dipotong.

Nilai default dan maksimum sama dengan panjang output maksimum model. Untuk informasi selengkapnya, lihat Pemilihan Model.

seed integer (Opsional)

Bilangan acak seed. Ini memastikan bahwa hasilnya dapat direproduksi dengan input dan parameter yang sama. Jika Anda menggunakan seed dan parameter lain yang sama dalam suatu panggilan, model akan mengembalikan hasil yang sama secara konsisten.

Rentang nilai: [0, 2<sup>31</sup>-1].

temperature float (Opsional) Default ke 0.65.

Suhu pengambilan sampel, yang mengontrol keragaman teks yang dihasilkan.

Nilai suhu yang lebih tinggi menghasilkan teks yang lebih beragam. Nilai suhu yang lebih rendah menghasilkan teks yang lebih deterministik.

Rentang nilai: [0, 2)

Baik temperature maupun top_p mengontrol keragaman teks yang dihasilkan. Atur hanya salah satu dari keduanya.

top_p float (Opsional) Default ke 0.8.

Ambang batas probabilitas untuk pengambilan sampel inti, yang mengontrol keragaman teks yang dihasilkan.

Nilai top_p yang lebih tinggi menghasilkan teks yang lebih beragam. Nilai top_p yang lebih rendah menghasilkan teks yang lebih deterministik.

Rentang nilai: (0, 1.0]

Baik temperature maupun top_p mengontrol keragaman teks yang dihasilkan. Atur hanya salah satu dari keduanya.

top_k integer (Opsional) Default ke 1.

Ukuran set kandidat untuk pengambilan sampel selama generasi. Misalnya, jika Anda mengatur parameter ini ke 50, hanya 50 token dengan skor tertinggi dalam satu generasi yang digunakan untuk membentuk set kandidat untuk pengambilan sampel acak. Nilai yang lebih besar meningkatkan keacakan. Nilai yang lebih kecil meningkatkan determinisme. Jika nilainya None atau lebih besar dari 100, kebijakan top_k dinonaktifkan dan hanya kebijakan top_p yang berlaku.

Nilai harus lebih besar dari atau sama dengan 0.

Parameter ini bukan parameter standar OpenAI. Saat Anda menggunakan SDK Python, letakkan parameter ini dalam objek extra_body. Contohnya: extra_body={"top_k": xxx}. Saat Anda menggunakan SDK Node.js atau melakukan panggilan HTTP, kirimkan sebagai parameter tingkat atas.

repetition_penalty float (Opsional) Default ke 1.0.

Hukuman terhadap pengulangan dalam urutan berturut-turut selama generasi model. Nilai repetition_penalty yang lebih tinggi mengurangi pengulangan. Nilai 1.0 menunjukkan tidak ada hukuman. Nilai harus lebih besar dari 0, tetapi tidak ada rentang nilai yang ketat.

Parameter ini bukan parameter standar OpenAI. Saat Anda menggunakan SDK Python, letakkan parameter ini dalam objek extra_body. Contohnya: extra_body={"repetition_penalty": xxx}. Saat Anda menggunakan SDK Node.js atau melakukan panggilan HTTP, kirimkan sebagai parameter tingkat atas.

translation_options object (Wajib)

Parameter terjemahan yang akan dikonfigurasi.

Properti

source_lang string (Wajib)

Nama lengkap bahasa sumber dalam bahasa Inggris. Untuk informasi selengkapnya, lihat Bahasa yang Didukung. Jika Anda mengatur ini ke auto, model akan secara otomatis mendeteksi bahasa input.

target_lang string (Wajib)

Nama lengkap bahasa target dalam bahasa Inggris. Untuk informasi selengkapnya, lihat Bahasa yang Didukung.

terms arrays (Opsional)

Array istilah yang diatur saat Anda menggunakan fitur Intervensi Istilah.

Properti

source string (Wajib)

Istilah dalam bahasa sumber.

target string (Wajib)

Istilah dalam bahasa target.

tm_list arrays (Opsional)

Array memori terjemahan yang diatur saat Anda menggunakan fitur Memori Terjemahan.

Properti

source string (Wajib)

Pernyataan dalam bahasa sumber.

target string (Wajib)

Pernyataan dalam bahasa target.

domains string (Opsional)

Petunjuk domain yang diatur saat Anda menggunakan fitur Pemberian Petunjuk Domain.

Petunjuk domain harus dalam bahasa Inggris.

Parameter ini bukan parameter standar OpenAI. Saat Anda menggunakan SDK Python, letakkan parameter ini dalam objek extra_body. Contohnya: extra_body={"translation_options": xxx}. Saat Anda menggunakan SDK Node.js atau melakukan panggilan HTTP, kirimkan sebagai parameter tingkat atas.

Objek respons chat (keluaran non-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 unik permintaan.
choices `array` Array konten yang dihasilkan oleh model. Properti finish_reason `string` Alasan model berhenti menghasilkan konten. Berlaku dua skenario berikut: `stop`: Output telah selesai. `length`: Generasi dihentikan karena mencapai batas panjang output. index `integer` Indeks objek saat ini dalam array `choices`. message `object` Pesan yang dikeluarkan oleh model. Properti content `string` Hasil terjemahan dari model. refusal `string` Parameter ini saat ini bernilai `null`. role `string` Peran pesan. Nilainya selalu `assistant`. audio `object` Parameter ini saat ini bernilai `null`. function_call `object` Parameter ini saat ini bernilai `null`. tool_calls `array` Parameter ini saat ini bernilai `null`.
created `integer` Stempel waktu UNIX saat permintaan dibuat.
model `string` Model yang digunakan untuk permintaan.
object `string` Ini selalu `chat.completion`.
service_tier `string` Parameter ini saat ini bernilai `null`.
system_fingerprint `string` Parameter ini saat ini bernilai `null`.
usage `object` Informasi konsumsi token untuk permintaan. Properti completion_tokens `integer` Jumlah token dalam output model. prompt_tokens `integer` Jumlah token dalam input. total_tokens `integer` Total token yang dikonsumsi, yaitu jumlah dari `prompt_tokens` dan `completion_tokens`. completion_tokens_details `object` Parameter ini saat ini bernilai `null`. prompt_tokens_details `object` Parameter ini saat ini bernilai `null`.

Objek potongan respons chat (keluaran streaming)	Keluaran inkremental {"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}} Keluaran non-inkremental {"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 unik dari panggilan. Setiap objek potongan memiliki ID yang sama.
choices `array` Array konten yang dihasilkan oleh model. Jika `include_usage` diatur ke `true`, array ini kosong pada potongan terakhir. Properti delta `object` Konten output yang dikembalikan dalam mode streaming. Properti content `string` Hasil terjemahan. Model qwen-mt-flash dan qwen-mt-lite memberikan pembaruan inkremental, sedangkan qwen-mt-plus dan qwen-mt-turbo memberikan pembaruan non-inkremental. function_call `object` Parameter ini saat ini selalu bernilai `null`. refusal `object` Parameter ini saat ini selalu bernilai `null`. role `string` Peran objek pesan. Nilai ini hanya muncul pada potongan pertama. finish_reason `string` Model berhenti menghasilkan karena salah satu dari tiga alasan berikut: Saat output selesai, nilainya adalah `stop`. Nilainya adalah `null` selama proses generasi. `length`: Generasi berhenti karena mencapai batas panjang output. index `integer` Indeks respons saat ini dalam array `choices`.
created `integer` Stempel waktu UNIX saat permintaan dibuat. Setiap potongan memiliki stempel waktu yang sama.
model `string` Model yang digunakan untuk permintaan.
object `string` Nilai ini selalu `chat.completion.chunk`.
service_tier `string` Parameter ini saat ini selalu bernilai `null`.
system_fingerprint `string` Parameter ini saat ini selalu bernilai `null`.
usage `object` Token yang dikonsumsi oleh permintaan. Informasi ini hanya dikembalikan pada potongan terakhir ketika `include_usage` bernilai `true`. Properti completion_tokens `integer` Jumlah token dalam output model. prompt_tokens `integer` Jumlah token input. total_tokens `integer` Jumlah total token, yaitu jumlah dari `prompt_tokens` dan `completion_tokens`. completion_tokens_details `object` Parameter ini saat ini selalu bernilai `null`. prompt_tokens_details `object` Parameter ini saat ini selalu bernilai `null`.

DashScope

Singapura

Titik akhir HTTP: POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation

Atur base_url ke:

Kode Python

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

Kode Java

Metode 1:

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

Metode 2:

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

Virginia

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

Atur base_url ke:

Kode Python

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

Kode Java

Metode 1:

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

Metode 2:

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

Beijing

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

Anda tidak perlu mengonfigurasi base_url untuk panggilan SDK. Nilai default-nya adalah https://dashscope.aliyuncs.com/api/v1.

Anda harus membuat Kunci API dan mengekspor Kunci API sebagai variabel lingkungan. Jika menggunakan SDK DashScope, instal SDK DashScope.

Body permintaan	Penggunaan dasar Python import os import dashscope # Berikut ini adalah base_url untuk wilayah Singapura. dashscope.base_http_api_url = 'https://dashscope-intl.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( # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # Contoh ini menggunakan qwen-mt-plus. Anda dapat mengganti nama model sesuai kebutuhan. messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) Java // Diperlukan DashScope SDK 2.20.6 atau versi lebih baru. 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; public class Main { public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // Berikut ini adalah base_url untuk wilayah Singapura. Generation gen = new Generation(Protocol.HTTP.getValue(), "https://dashscope-intl.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() // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: .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) { 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 Setiap wilayah memiliki titik akhir permintaan dan Kunci API yang berbeda. Berikut ini adalah titik akhir permintaan untuk wilayah Singapura. `curl -X POST https://dashscope-intl.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" } } }'` Intervensi istilah Python import os import dashscope # Berikut ini adalah base_url untuk wilayah Singapura. dashscope.base_http_api_url = 'https://dashscope-intl.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( # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # Contoh ini menggunakan qwen-mt-plus. Anda dapat mengganti nama model sesuai kebutuhan. messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) Java // Diperlukan DashScope SDK 2.20.6 atau versi lebih baru. 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; public class Main { public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // Berikut ini adalah base_url untuk wilayah Singapura. Generation gen = new Generation(Protocol.HTTP.getValue(), "https://dashscope-intl.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("health status of the body") .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 Setiap wilayah memiliki titik akhir permintaan dan Kunci API yang berbeda. Berikut ini adalah titik akhir permintaan untuk wilayah Singapura. curl -X POST https://dashscope-intl.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" } ] } }' Memori terjemahan Python import os import dashscope # Berikut ini adalah base_url untuk wilayah Singapura. dashscope.base_http_api_url = 'https://dashscope-intl.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( # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # Contoh ini menggunakan qwen-mt-plus. Anda dapat mengganti nama model sesuai kebutuhan. messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) Java // Diperlukan DashScope SDK 2.20.6 atau versi lebih baru. 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; public class Main { public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // Berikut ini adalah base_url untuk wilayah Singapura. Generation gen = new Generation(Protocol.HTTP.getValue(), "https://dashscope-intl.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 Setiap wilayah memiliki titik akhir permintaan dan Kunci API yang berbeda. Berikut ini adalah titik akhir permintaan untuk wilayah Singapura. curl -X POST https://dashscope-intl.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:"} ] } }' Pemberian petunjuk domain Python import os import dashscope # Berikut adalah base_url untuk wilayah Singapura. dashscope.base_http_api_url = 'https://dashscope-intl.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( # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan kunci API Model Studio Anda: 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 // Diperlukan DashScope SDK 2.20.6 atau versi lebih baru. 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; public class Main { public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // Berikut ini adalah base_url untuk wilayah Singapura. Generation gen = new Generation(Protocol.HTTP.getValue(), "https://dashscope-intl.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) { 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 Setiap wilayah memiliki titik akhir permintaan dan Kunci API yang berbeda. Berikut ini adalah titik akhir permintaan untuk wilayah Singapura. curl -X POST https://dashscope-intl.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` (Wajib) Nama model. Model yang didukung: qwen-mt-plus, qwen-mt-flash, qwen-mt-lite, dan qwen-mt-turbo.
messages `array` (Wajib) Array pesan yang memberikan konteks kepada model. Hanya pesan dari pengguna yang didukung. Jenis pesan Pesan Pengguna `object` (Wajib) Pesan pengguna yang berisi kalimat yang akan diterjemahkan. Properti content `string` (Wajib) Kalimat yang akan diterjemahkan. role `string` (Wajib) Peran pesan pengguna. Nilai ini harus diatur ke `user`.
max_tokens `integer` (Opsional) Jumlah maksimum token yang akan dihasilkan. Jika konten yang dihasilkan melebihi nilai ini, respons akan dipotong. Nilai default dan maksimum sama dengan panjang output maksimum model. Untuk informasi selengkapnya, lihat Pemilihan model. Dalam SDK Java, parameter ini adalah maxTokens. Untuk panggilan HTTP, letakkan max_tokens dalam objek parameters.
seed `integer` (Opsional) Bilangan acak seed. Ini memastikan bahwa hasilnya dapat direproduksi dengan input dan parameter yang sama. Jika Anda menggunakan `seed` dan parameter lain yang sama dalam suatu panggilan, model akan mengembalikan hasil yang sama secara konsisten. Rentang nilai: `[0, 2<sup>31</sup>-1]`. Saat Anda melakukan panggilan HTTP, letakkan seed dalam objek parameters.
temperature `float` (Opsional) Default ke 0,65. Suhu pengambilan sampel, yang mengontrol keragaman teks yang dihasilkan. Nilai suhu yang lebih tinggi menghasilkan teks yang lebih beragam. Nilai suhu yang lebih rendah menghasilkan teks yang lebih deterministik. Rentang nilai: [0, 2) Baik temperature maupun top_p mengontrol keragaman teks yang dihasilkan. Atur hanya salah satu dari keduanya. Saat Anda melakukan panggilan HTTP, letakkan temperature dalam objek parameters.
top_p `float` (Opsional) Default ke 0,8. Ambang batas probabilitas untuk pengambilan sampel inti, yang mengontrol keragaman teks yang dihasilkan. Nilai top_p yang lebih tinggi menghasilkan teks yang lebih beragam. Nilai top_p yang lebih rendah menghasilkan teks yang lebih deterministik. Rentang nilai: (0, 1,0] Baik temperature maupun top_p mengontrol keragaman teks yang dihasilkan. Atur hanya salah satu dari keduanya. Dalam Java SDK, parameternya berupa objek topPparameters.
repetition_penalty `float` (Opsional) Default ke 1,0. Hukuman terhadap pengulangan dalam urutan berturut-turut selama generasi model. Nilai repetition_penalty yang lebih tinggi mengurangi pengulangan. Nilai 1,0 menunjukkan tidak ada hukuman. Nilai harus lebih besar dari 0, tetapi tidak ada rentang nilai yang ketat. Dalam SDK Java, parameter ini adalah repetitionPenalty. Untuk panggilan HTTP, tambahkan repetition_penalty ke objek parameters.
top_k `integer` (Opsional) Default ke 1. Ukuran set kandidat untuk pengambilan sampel selama generasi. Misalnya, jika Anda mengatur parameter ini ke 50, hanya 50 token dengan skor tertinggi dalam satu generasi yang digunakan untuk membentuk set kandidat untuk pengambilan sampel acak. Nilai yang lebih besar meningkatkan keacakan. Nilai yang lebih kecil meningkatkan determinisme. Jika nilainya None atau lebih besar dari 100, kebijakan top_k dinonaktifkan dan hanya kebijakan top_p yang berlaku. Nilai harus lebih besar dari atau sama dengan 0. Dalam SDK Java, parameter ini adalah topK. Saat Anda melakukan panggilan HTTP, atur top_k dalam objek parameters.
stream `boolean` (Opsional) Menentukan apakah respons dikembalikan dalam mode keluaran streaming. Nilai yang valid: `false`: Seluruh respons dikembalikan setelah sepenuhnya dihasilkan. `true`: Respons dikembalikan dalam potongan data saat dihasilkan. Klien harus membaca potongan-potongan tersebut untuk merekonstruksi respons lengkap. Catatan Saat ini, hanya model qwen-mt-flash dan qwen-mt-lite yang mendukung pengembalian data secara inkremental. Setiap potongan data yang dikembalikan hanya berisi konten yang baru dihasilkan. Model qwen-mt-plus dan qwen-mt-turbo mengembalikan data secara non-inkremental. Setiap potongan data yang dikembalikan berisi seluruh urutan yang telah dihasilkan hingga saat itu. Perilaku ini tidak dapat diubah. Contohnya: I I didn I didn't I didn't laugh I didn't laugh after ... Parameter ini hanya didukung oleh SDK Python. Untuk menerapkan keluaran streaming dengan SDK Java, panggil antarmuka `streamCall`. Untuk menerapkan keluaran streaming dengan panggilan HTTP, atur `X-DashScope-SSE` ke `enable` dalam header.
translation_options `object` (Wajib) Parameter terjemahan yang akan dikonfigurasi. Properti source_lang `string` (Wajib) Nama lengkap bahasa sumber dalam bahasa Inggris. Untuk informasi selengkapnya, lihat Bahasa yang didukung. Jika Anda mengatur ini ke `auto`, model akan secara otomatis mendeteksi bahasa input. target_lang `string` (Wajib) Nama lengkap bahasa target dalam bahasa Inggris. Untuk informasi selengkapnya, lihat Bahasa yang didukung. terms `arrays` (Opsional) Array istilah yang diatur saat Anda menggunakan fitur Intervensi istilah. Properti source `string` (Wajib) Istilah dalam bahasa sumber. target `string` (Wajib) Istilah dalam bahasa target. tm_list `arrays` (Opsional) Array memori terjemahan yang diatur saat Anda menggunakan fitur Memori terjemahan. Properti source `string` (Wajib) Pernyataan dalam bahasa sumber. target `string` (Wajib) Pernyataan dalam bahasa target. domains `string` (Opsional) Petunjuk domain yang diatur saat Anda menggunakan fitur Pemberian petunjuk domain. Petunjuk domain harus dalam bahasa Inggris. Dalam SDK Java, parameter ini adalah `translationOptions`. Saat Anda melakukan panggilan HTTP, letakkan translation_options dalam objek parameters.

Objek respons chat (sama untuk keluaran streaming dan non-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` Kode status permintaan. Nilai 200 menunjukkan bahwa permintaan berhasil. Jika tidak, permintaan gagal. SDK Java tidak mengembalikan parameter ini. Jika panggilan gagal, pengecualian dilemparkan. Pesan pengecualian berisi konten status_code dan message.
request_id `string` ID unik dari panggilan. Dalam SDK Java, parameter yang dikembalikan adalah requestId.
code `string` Kode kesalahan. Parameter ini kosong jika panggilan berhasil. Hanya SDK Python yang mengembalikan parameter ini.
output `object` Informasi tentang hasil panggilan. Properti text `string` Parameter ini saat ini tetap `null`. finish_reason `string` Alasan mengapa model berhenti menghasilkan konten. Nilai yang valid: Nilainya adalah `null` selama generasi. `stop`: Model berhenti menghasilkan konten secara alami. `length`: Generasi berhenti karena mencapai batas panjang output. choices `array` Informasi output dari model. Properti finish_reason `string` Pertimbangkan situasi berikut: Nilainya adalah `null` selama generasi. `stop`: Model berhenti menghasilkan konten secara alami. `length`: Generasi berhenti karena mencapai batas panjang output. message `object` Objek pesan yang dikeluarkan oleh model. Properti role `string` Peran pesan output. Nilai ini tetap `assistant`. content `string` Hasil terjemahan. model_name `string` Nama model yang digunakan untuk permintaan ini.
usage `object` Informasi penggunaan token untuk permintaan. Properti input_tokens `integer` Jumlah token input. output_tokens `integer` Jumlah token output. total_tokens `integer` Jumlah total token. Nilai ini adalah jumlah dari input_tokens dan output_tokens.

Kode kesalahan

Jika panggilan model gagal dan pesan kesalahan dikembalikan, lihat Pesan kesalahan untuk menyelesaikan masalah.

Kompatibel dengan OpenAI

Wilayah Singapura

Wilayah Virginia

Wilayah Beijing

Body permintaan

Penggunaan dasar

Python

Node.js

curl

Intervensi istilah

Python

Node.js

curl

Memori terjemahan

Python

Node.js

curl

Pemberian petunjuk domain

Python

Node.js

curl

Objek respons chat (keluaran non-streaming)

Objek potongan respons chat (keluaran streaming)

Keluaran inkremental

Keluaran non-inkremental

DashScope

Singapura

Kode Python

Kode Java

Virginia

Kode Python

Kode Java

Beijing

Body permintaan

Penggunaan dasar

Python

Java

curl

Intervensi istilah

Python

Java

curl

Memori terjemahan

Python

Java

curl

Pemberian petunjuk domain

Python

Java

curl

Objek respons chat (sama untuk keluaran streaming dan non-streaming)

Kode kesalahan