Referensi API untuk model Qwen-MT - Alibaba Cloud Model Studio

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://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

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

Wilayah Virginia

base_url untuk SDK: https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1

Titik akhir HTTP: POST https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions

Wilayah Beijing

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

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

PentingAlibaba Cloud Model Studio telah merilis domain khusus ruang kerja untuk wilayah China (Beijing), Singapura, dan China (Hong Kong). Domain khusus baru ini memberikan performa lebih unggul dan stabilitas lebih tinggi untuk permintaan inferensi. Kami merekomendasikan migrasi ke domain baru berikut:

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

{WorkspaceId} adalah ID ruang kerja Anda, yang dapat ditemukan pada halaman Detail Ruang Kerja di Konsol Alibaba Cloud Model Studio. Domain lama tetap berfungsi sepenuhnya.

Pertama, buat Kunci API dan konfigurasikan sebagai Variabel lingkungan. Jika Anda menggunakan SDK OpenAI, instal SDK.

Body permintaan

Penggunaan dasar

Python

import os
from openai import OpenAI

client = OpenAI(
    # Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
    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

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

    const openai = new OpenAI(
        {
            // Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: apiKey: "sk-xxx"
            apiKey: process.env.DASHSCOPE_API_KEY,
            // URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
            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

Titik akhir dan Kunci API berbeda tergantung wilayah. Berikut adalah titik akhir Singapura.

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

Intervensi istilah

Python

import os
from openai import OpenAI

client = OpenAI(
    # Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
    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",  # 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(
        {
            // Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: apiKey: "sk-xxx"
            apiKey: process.env.DASHSCOPE_API_KEY,
            // URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
            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

Titik akhir dan Kunci API berbeda tergantung wilayah. Berikut adalah titik akhir Singapura.

# URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
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"
          }
        ]
      }
    }'

Memori penerjemahan

Python

import os
from openai import OpenAI

client = OpenAI(
    # Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
    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",  # 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(
        {
            // Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: apiKey: "sk-xxx"
            apiKey: process.env.DASHSCOPE_API_KEY,
            // URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
            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

Titik akhir dan Kunci API berbeda tergantung wilayah. Berikut adalah titik akhir Singapura.

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:"}
        ]
      }
    }'

Pemberian petunjuk domain

Python

import os
from openai import OpenAI

client = OpenAI(
    # Ganti dengan kunci API Model Studio Anda jika variabel lingkungan tidak diatur: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # URL berikut adalah untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja Anda yang sebenarnya. URL bervariasi menurut wilayah.
    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": "Kalimat ini berasal dari domain IT Ali Cloud. Kalimat 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."
}

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(
        {
            // Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: apiKey: "sk-xxx"
            apiKey: process.env.DASHSCOPE_API_KEY,
            // URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
            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

Titik akhir dan Kunci API berbeda tergantung wilayah. Berikut adalah titik akhir Singapura.

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 (Wajib)

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

messages array (Wajib)

Array pesan yang memberikan konteks kepada model. Hanya pesan 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. Harus diatur ke user.

stream boolean (Opsional). Nilai default: false.

Aktifkan mode keluaran streaming.

Nilai valid:

false: Mengembalikan respons lengkap setelah generasi selesai.
true: Mengembalikan respons dalam potongan saat dihasilkan. Klien menyusun kembali respons lengkap dari potongan-potongan tersebut.

Catatanqwen-mt-flash dan qwen-mt-lite mengembalikan data secara inkremental (setiap potongan hanya berisi konten baru). qwen-mt-plus dan qwen-mt-turbo mengembalikan data secara non-inkremental (setiap potongan berisi seluruh urutan hingga saat itu). Perilaku ini tidak dapat diubah. Contoh:

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). Nilai default: false.

Sertakan informasi konsumsi token dalam potongan data terakhir.

Nilai valid:

true
false

max_tokens integer (Opsional)

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

Nilai default dan maksimum mengikuti panjang output maksimum model. Untuk informasi lebih lanjut, lihat Pemilihan Model.

seed integer (Opsional)

Bibit angka acak untuk hasil yang dapat direproduksi. Menggunakan seed dan parameter yang sama menghasilkan output yang konsisten.

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

temperature float (Opsional). Nilai default: 0,65.

Suhu pengambilan sampel yang mengontrol keragaman teks yang dihasilkan.

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

Rentang nilai: [0, 2)

Baik temperature maupun top_p mengontrol keragaman teks. Atur hanya salah satunya.

top_p float (Opsional). Nilai default: 0,8.

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

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

Rentang nilai: (0, 1,0]

Baik temperature maupun top_p mengontrol keragaman teks. Atur hanya salah satunya.

top_k integer (Opsional). Nilai default: 1.

Ukuran set kandidat untuk pengambilan sampel selama generasi. Misalnya, mengatur nilai ini ke 50 berarti hanya 50 token teratas berdasarkan skor yang membentuk kumpulan pengambilan sampel. Nilai yang lebih besar meningkatkan keacakan; nilai yang lebih kecil meningkatkan determinisme. Jika nilainya None atau lebih besar dari 100, top_k dinonaktifkan dan hanya top_p yang berlaku.

Nilai harus lebih besar dari atau sama dengan 0.

Parameter non-standar OpenAI. SDK Python: tempatkan dalam objek extra_body extra_body={"top_k": xxx}. SDK Node.js atau panggilan HTTP: teruskan sebagai parameter tingkat atas.

repetition_penalty float (Opsional). Nilai default: 1,0.

Hukuman untuk pengulangan dalam urutan berturut-turut. Nilai yang lebih tinggi mengurangi pengulangan. Nilai 1,0 tidak menerapkan hukuman. Harus lebih besar dari 0, tanpa batas atas yang ketat.

Parameter non-standar OpenAI. SDK Python: tempatkan dalam objek extra_body extra_body={"repetition_penalty": xxx}. SDK Node.js atau panggilan HTTP: teruskan sebagai parameter tingkat atas.

translation_options object (Wajib)

Parameter penerjemahan.

Properti

source_lang string (Wajib)

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

target_lang string (Wajib)

Nama lengkap bahasa target dalam bahasa Inggris. Untuk informasi lebih lanjut, 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 penerjemahan yang diatur saat Anda menggunakan fitur Memori Penerjemahan.

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 non-standar OpenAI. SDK Python: tempatkan dalam objek extra_body extra_body={"translation_options": xxx}. SDK Node.js atau panggilan HTTP: teruskan 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 permintaan unik.

choices array

Array konten yang dihasilkan oleh model.

Properti

finish_reason string

Alasan penghentian pembuatan konten oleh model.

Nilai yang mungkin:

stop: Output selesai.
length: Batas panjang output tercapai.

index integer

Indeks objek saat ini dalam array choices.

message object

Pesan keluaran dari model.

Properti

content string

Hasil terjemahan.

refusal string

Saat ini diatur ke null.

role string

Peran pesan. Nilainya selalu assistant.

audio object

Saat ini selalu null.

function_call object

Saat ini diatur ke null.

tool_calls array

Saat ini diatur ke null.

created integer

Stempel waktu UNIX saat permintaan dibuat.

model string

Model yang digunakan dalam permintaan.

object string

Nilainya selalu chat.completion.

service_tier string

Saat ini diatur ke null.

system_fingerprint string

Saat ini selalu null.

usage object

Konsumsi token untuk permintaan tersebut.

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

Saat ini diatur ke null.

prompt_tokens_details object

Saat ini diatur ke 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 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

Saat ini selalu bernilai null.

refusal object

Saat ini selalu bernilai null.

role string

Peran objek pesan. Nilai ini hanya tersedia pada potongan pertama.

finish_reason string

Model berhenti menghasilkan karena salah satu dari tiga alasan berikut:

stop: Output telah selesai.
Nilainya adalah null saat pembuatan.
length: Generasi berhenti karena batas panjang output telah tercapai.

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

Saat ini selalu bernilai null.

system_fingerprint string

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

Saat ini selalu bernilai null.

prompt_tokens_details object

Saat ini selalu bernilai null.

DashScope

Singapura

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

Atur base_url ke:

Kode Python

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

Kode Java

Metode 1:

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

Metode 2:

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

Virginia

Titik akhir HTTP: POST https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation

Atur base_url ke:

Kode Python

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

Kode Java

Metode 1:

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

Metode 2:

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

Beijing

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

Anda tidak perlu mengonfigurasi base_url untuk panggilan SDK. Nilai default adalah https://{WorkspaceId}.cn-beijing.maas.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

# URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
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(
    # Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: 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;
import com.alibaba.dashscope.utils.Constants;

    public class Main {
        // Berikut adalah base_url untuk wilayah Beijing. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. Konfigurasi berbeda-beda tergantung wilayah.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";
        public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
            // URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
            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()
                    // 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) {
        // Berikut adalah base_url untuk wilayah Beijing. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. Konfigurasi berbeda-beda tergantung wilayah.
        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

Titik akhir dan Kunci API berbeda tergantung wilayah. Berikut adalah titik akhir 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"
        }
      }
    }'

Intervensi istilah

Python

import os
import dashscope

# URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
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(
    # Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: 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;
import com.alibaba.dashscope.utils.Constants;

    public class Main {
        // Berikut adalah base_url untuk wilayah Beijing. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. Konfigurasi berbeda-beda tergantung wilayah.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";
        public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
            // URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
            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

Titik akhir dan Kunci API berbeda tergantung wilayah. Berikut adalah titik akhir 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"
            }
          ]
        }
      }
    }'

Memori penerjemahan

Python

import os
import dashscope

# URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
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 instalasi dari kode sumber, Anda dapat mengunjungi situs resmi 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(
    # Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: 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;
import com.alibaba.dashscope.utils.Constants;

    public class Main {
        // Berikut adalah base_url untuk wilayah Beijing. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. Konfigurasi berbeda-beda tergantung wilayah.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";
        public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
            // URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
            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 instalasi dari kode sumber, Anda dapat mengunjungi situs resmi 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

Titik akhir dan Kunci API berbeda tergantung wilayah. Berikut adalah titik akhir 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 instalasi dari kode sumber, Anda dapat mengunjungi situs resmi 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

# URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
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(
    # Ganti dengan Kunci API Model Studio Anda jika variabel lingkungan tidak disetel: 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;
import com.alibaba.dashscope.utils.Constants;

    public class Main {
        // Berikut adalah base_url untuk wilayah Beijing. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. Konfigurasi berbeda-beda tergantung wilayah.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";
        public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
            // URL berikut untuk wilayah Singapura. Saat memanggil, ganti WorkspaceId dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah.
            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) {
        // Berikut adalah base_url untuk wilayah Beijing. Ganti WorkspaceId dengan ID ruang kerja aktual Anda. Konfigurasi berbeda-beda tergantung wilayah.
        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

Titik akhir dan Kunci API berbeda tergantung wilayah. Berikut adalah titik akhir 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 (Wajib)

Nama model. Didukung: qwen-mt-plus, qwen-mt-flash, qwen-mt-lite, qwen-mt-turbo.

messages array (Wajib)

Array pesan yang memberikan konteks kepada model. Hanya pesan 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. Harus diatur ke user.

max_tokens integer (Opsional)

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

Nilai default dan maksimum adalah panjang output maksimum model. Untuk informasi lebih lanjut, lihat Pemilihan model.

Dalam SDK Java, parameter ini adalah maxTokens. Untuk panggilan HTTP, letakkan max_tokens dalam objek parameters.

seed integer (Opsional)

Bibit angka acak untuk hasil yang dapat direproduksi. Menggunakan seed dan parameter yang sama menghasilkan output yang konsisten.

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

Saat 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 yang lebih tinggi menghasilkan teks yang lebih beragam. Nilai yang lebih rendah menghasilkan teks yang lebih deterministik.

Rentang nilai: [0, 2)

Baik temperature maupun top_p mengontrol keragaman teks. Atur hanya salah satunya.

Saat 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 yang lebih tinggi menghasilkan teks yang lebih beragam. Nilai yang lebih rendah menghasilkan teks yang lebih deterministik.

Rentang nilai: (0, 1,0]

Baik temperature maupun top_p mengontrol keragaman teks. Atur hanya salah satunya.

Dalam Java SDK, parameternya adalah objek topPparameters.

repetition_penalty float (Opsional) Default ke 1,0.

Hukuman untuk pengulangan dalam urutan berturut-turut. Nilai yang lebih tinggi mengurangi pengulangan. Nilai 1,0 tidak menerapkan hukuman. Harus lebih besar dari 0, tanpa batas atas 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.

Nilai harus lebih besar dari atau sama dengan 0.

Dalam SDK Java, parameter ini adalah topK. Saat melakukan panggilan HTTP, atur top_k dalam objek parameters.

stream boolean (Opsional)

Aktifkan mode keluaran streaming.

Nilai valid:

false: Mengembalikan respons lengkap setelah generasi selesai.
true: Mengembalikan respons dalam potongan saat dihasilkan. Klien menyusun kembali respons lengkap dari potongan-potongan tersebut.

I didn

I didn't

I didn't laugh

I didn't laugh after

...

Parameter ini hanya didukung oleh SDK Python. Untuk mengimplementasikan keluaran streaming dengan SDK Java, panggil antarmuka streamCall. Untuk mengimplementasikan keluaran streaming dengan panggilan HTTP, atur X-DashScope-SSE ke enable dalam header.

translation_options object (Wajib)

Parameter penerjemahan.

Properti

source_lang string (Wajib)

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

target_lang string (Wajib)

Nama lengkap bahasa target dalam bahasa Inggris. Untuk informasi lebih lanjut, 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 penerjemahan yang diatur saat Anda menggunakan fitur Memori penerjemahan.

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 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. 200 menunjukkan keberhasilan; nilai lain menunjukkan kegagalan.

SDK Java tidak mengembalikan parameter ini. Jika panggilan gagal, pengecualian dilemparkan. Pesan pengecualian berisi konten status_code dan message.

request_id string

ID permintaan unik.

Dalam SDK Java, parameter yang dikembalikan adalah requestId.

code string

Kode error. Kosong saat berhasil.

Hanya SDK Python yang mengembalikan parameter ini.

output object

Hasil panggilan.

Properti

text string

Saat ini tetap null.

finish_reason string

Alasan mengapa model berhenti menghasilkan konten. Nilai valid:

Nilainya adalah null selama generasi.
stop: Model berhenti menghasilkan konten secara alami.
length: Generasi berhenti karena batas panjang output tercapai.

choices array

Output model.

Properti

finish_reason string

Nilai valid:

Nilainya adalah null selama generasi.
stop: Model berhenti menghasilkan konten secara alami.
length: Generasi berhenti karena batas panjang output tercapai.

message object

Pesan output model.

Properti

role string

Peran pesan output. Tetap assistant.

content string

Hasil terjemahan.

model_name string

Model yang digunakan untuk permintaan ini.

usage object

Penggunaan token untuk permintaan.

Properti

input_tokens integer

Jumlah token input.

output_tokens integer

Jumlah token output.

total_tokens integer

Total token, sama dengan input_tokens + output_tokens.

Kode error

Jika panggilan gagal, lihat Kode error untuk menyelesaikan masalah.