全部产品
Search

搜索本产品

    Alibaba Cloud Model Studio：Referensi API Qwen-MT

    文档中心

    Alibaba Cloud Model Studio：Referensi API Qwen-MT

    更新时间：Jan 17, 2026

    Qwen-MT-Image menerjemahkan teks dalam gambar secara akurat sekaligus mempertahankan tata letak aslinya. Model ini juga mendukung fitur kustom seperti petunjuk domain (domain hints), penyaringan kata sensitif, dan intervensi terminologi.

    Penting

    Dokumen ini hanya berlaku untuk mode penyebaran Mainland China. Anda harus menggunakan API key yang sesuai.

    Ikhtisar model

    en

    Bahasa sumber: English

    ja

    Japanese

    es

    Portuguese

    ar

    Arabic

    Model

    Deskripsi

    Spesifikasi gambar output

    qwen-mt-image

    Model terjemahan gambar Qwen

    Mendukung terjemahan antara Chinese atau English dan bahasa lainnya. Tidak mendukung terjemahan langsung antar bahasa non-Chinese atau non-English, misalnya dari Japanese ke Korean. Lihat Bahasa yang didukung.

    Format gambar: JPG.

    Prasyarat

    Anda harus mendapatkan API key dan menyetel API key sebagai variabel lingkungan.

    HTTP

    POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis

    API HTTP menggunakan mode asinkron. Pemanggilan melibatkan dua langkah:

    1. Buat task dan dapatkan task ID: Kirim permintaan untuk membuat task. Permintaan mengembalikan task ID (task_id).

    2. Kueri hasil menggunakan task ID: Gunakan task_id untuk melakukan polling status task hingga task selesai dan Anda mendapatkan URL gambar.

    Langkah 1: Buat task dan dapatkan task ID

    Catatan

    • Setelah task dibuat, gunakan task_id yang dikembalikan untuk mengkueri hasil. task_id berlaku selama 24 jam. Jangan membuat task duplikat. Sebagai gantinya, lakukan polling untuk mengambil hasil.

    • Untuk tutorial, lihat Postman.

    Parameter permintaan

    Terjemahan gambar

    curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "qwen-mt-image",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/arpjoo/p1000391.webp",
        "source_lang": "en",
        "target_lang": "ja",
        "ext": {
            "config": {
                "imageSegment": false
            }
        }
    }
}'

    Header permintaan

    Content-Type string (Wajib)

    Tipe konten permintaan. Anda harus menyetel parameter ini ke application/json.

    Authorization string (Wajib)

    Kredensial otentikasi. API ini menggunakan Model Studio API key untuk otentikasi. Contohnya, `Bearer sk-xxxx`.

    X-DashScope-Async string (Wajib)

    Parameter ini digunakan untuk mengonfigurasi pemrosesan asinkron. Karena permintaan HTTP hanya mendukung pemrosesan asinkron, Anda harus menyetel parameter ini ke enable.

    Penting

    Jika Anda tidak menyertakan header permintaan ini, pesan kesalahan "current user api does not support synchronous calls" akan dikembalikan.

    Body permintaan

    model string (Wajib)

    Nama model. Setel nilai ini ke qwen-mt-image.

    input object (Wajib)

    Objek parameter input, yang berisi bidang-bidang berikut:

    Properti

    image_url string (Wajib)

    URL publik gambar. Protokol HTTP dan HTTPS didukung.

    • Format: JPG, JPEG, PNG, BMP, PNM, PPM, TIFF, atau WEBP

    • Dimensi: Lebar dan tinggi gambar harus antara 15 hingga 8.192 piksel. Rasio aspek harus antara 1:10 hingga 10:1.

    • Ukuran: Maksimal 100 MB

    • URL tidak boleh mengandung karakter Chinese.

    • Contoh: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/arpjoo/p1000391.webp

    source_lang string (Wajib)

    Bahasa sumber.

    • Nilai yang didukung: Nama lengkap bahasa, kode bahasa, atau auto (untuk deteksi otomatis). Nilainya tidak peka huruf besar/kecil.

    • Batasan: Harus berbeda dari target_lang. Minimal salah satu dari bahasa sumber atau target harus berupa Chinese atau English.

    • Contoh: Chinese, en, atau auto

    target_lang string (Wajib)

    Bahasa target.

    • Nilai yang didukung: Nama lengkap bahasa atau kode bahasa. Nilainya tidak peka huruf besar/kecil.

    • Batasan: Harus berbeda dari source_lang. Minimal salah satu dari bahasa sumber atau target harus berupa Chinese atau English.

    • Contoh: Chinese atau en

    ext object (Opsional)

    Bidang ekstensi opsional.

    Properti

    domainHint string (Opsional)

    Petunjuk domain. Untuk menyesuaikan gaya terjemahan pada domain tertentu, gunakan bahasa Inggris untuk menjelaskan skenario, gaya terjemahan, dan persyaratan lainnya.

    Agar kualitas terjemahan terjamin, petunjuk tidak boleh melebihi 200 kata dalam bahasa Inggris.

    Penting

    Petunjuk domain saat ini hanya mendukung bahasa Inggris.

    Contoh: Kalimat-kalimat berikut berasal dari percakapan antara penjual dan pembeli di platform e-commerce B2C. Terjemahkan ke dalam bahasa layanan pelanggan yang jelas dan menarik, serta pastikan terjemahannya sesuai untuk menangani potensi masalah atau sengketa.

    sensitives array (Opsional)

    Mengonfigurasi kata sensitif yang akan disaring dari teks gambar sebelum diterjemahkan. Penyaringan dilakukan dengan exact match dan peka huruf besar/kecil.

    Bahasa kata sensitif bisa berbeda dari bahasa sumber. Semua bahasa sumber dan bahasa target didukung. Untuk menjaga kualitas terjemahan, tambahkan maksimal 50 kata sensitif per permintaan.

    Contoh: ["10% off entire store", "7-day no-questions-asked return"]

    terminologies array (Opsional)

    Menyediakan intervensi terminologi. Fitur ini memungkinkan Anda menetapkan terjemahan spesifik untuk istilah guna memenuhi kebutuhan domain tertentu. Bahasa pasangan istilah harus sesuai dengan source_lang dan target_lang.

    Properti

    src string (Wajib)

    Teks sumber istilah. Bahasanya harus sama dengan source_lang.

    tgt string (Wajib)

    Teks target istilah. Bahasanya harus sama dengan target_lang.

    Contoh: [{"src": "Application Programming Interface", "tgt": "API"}, {"src": "Machine Learning", "tgt": "ML"}]

    config object (Opsional)

    Properti

    imageSegment bool (Opsional)

    Menentukan apakah segmentasi subjek gambar diaktifkan. Jika diaktifkan, model tidak akan menerjemahkan teks pada subjek dalam gambar, seperti orang, produk, atau logo.

    • false (default): Menerjemahkan semua teks dalam gambar.

    • true: Tidak menerjemahkan teks pada subjek gambar.

    Catatan: Parameter ini sebelumnya bernama skipImgSegment (menentukan apakah segmentasi subjek gambar dilewati). Untuk kompatibilitas mundur, parameter ini masih didukung. Namun, kami merekomendasikan penggunaan parameter baru imageSegment.

    Parameter respons

    Respons sukses

    Simpan `task_id` untuk mengkueri status dan hasil task.

    {
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

    Respons kesalahan

    Pembuatan task gagal. Untuk informasi lebih lanjut, lihat Pesan kesalahan untuk menyelesaikan masalah.

    {
    "code": "InvalidApiKey",
    "message": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

    output object

    Informasi tentang output task.

    Properti

    task_id string

    ID task. Anda dapat menggunakan ID ini untuk mengkueri task hingga 24 jam.

    task_status string

    Status task.

    Enumerasi

    • PENDING

    • RUNNING

    • SUCCEEDED

    • FAILED

    • CANCELED

    • UNKNOWN: Task tidak ada atau statusnya tidak diketahui.

    request_id string

    ID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan troubleshooting masalah.

    message string

    Pesan kesalahan detail. Parameter ini hanya dikembalikan ketika permintaan gagal. Untuk informasi lebih lanjut, lihat Pesan kesalahan.

    code string

    Kode kesalahan. Parameter ini hanya dikembalikan ketika permintaan gagal. Untuk informasi lebih lanjut, lihat Pesan kesalahan.

    Langkah 2: Kueri hasil menggunakan task ID

    GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

    Catatan

    • task_id berlaku selama 24 jam. Jika ID tidak ada atau telah kedaluwarsa, status task dikembalikan sebagai UNKNOWN.

    • url yang dikembalikan untuk task sukses berlaku selama 24 jam. Unduh dan simpan gambar segera.

    Parameter permintaan

    Kueri hasil task

    Ganti 86ecf553-d340-4e21-xxxxxxxxx dengan task_id yang sebenarnya.

    curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
    Header permintaan

    Authorization string (Wajib)

    Kredensial otentikasi. API ini menggunakan Model Studio API key untuk otentikasi. Contohnya, `Bearer sk-xxxx`.

    Parameter path URL

    task_id string (Wajib)

    ID task.

    Parameter respons

    Task sukses - konten yang dapat diterjemahkan tersedia

    Data task, seperti status task dan URL gambar, hanya disimpan selama 24 jam lalu secara otomatis dipurge. Anda harus segera menyimpan gambar yang dihasilkan.

    {
    "request_id": "5fec62eb-bf94-91f8-b9f4-f7f758e4e27e",
    "output": {
        "task_id": "72c52225-8444-4cab-ad0c-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-08-13 18:11:16.954",
        "scheduled_time": "2025-08-13 18:11:17.003",
        "end_time": "2025-08-13 18:11:23.860",
        "image_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx?Expires=xxx"
    },
    "usage": {
        "image_count":1
    }
}

    Task sukses - tidak ada konten yang dapat diterjemahkan

    Jika gambar tidak mengandung teks yang dapat diterjemahkan (misalnya, tidak ada teks tersisa setelah identifikasi subjek), task tetap dianggap sukses dan ditagih secara normal. Namun, pesan No text detected for translation dikembalikan.

    {
    "request_id": "0ccb84aa-e034-431d-9d54-08e14fxxxxxx",
    "output": {
        "task_id": "34ec4208-97d6-498b-a390-9173f7xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-01-12 17:56:23.625",
        "scheduled_time": "2026-01-12 17:56:23.656",
        "end_time": "2026-01-12 17:56:25.324",
        "image_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.jpg?Expires=xxx",
        "message": "No text detected for translation"
    },
    "usage": {
        "image_count": 1
    }
}

    Task gagal

    Jika task gagal, `task_status` diatur ke FAILED, dan kode serta pesan kesalahan disediakan. Untuk informasi lebih lanjut, lihat Pesan kesalahan untuk menyelesaikan masalah.

    {
    "request_id": "daad9007-6acd-9fb3-a6bc-d55902b9c9ff",
    "output": {
        "task_id": "fe8aa114-d9f1-4f76-b598-xxxxxx",
        "task_status": "FAILED",
        "submit_time": "2025-08-20 09:54:21.911",
        "scheduled_time": "2025-08-20 09:54:21.984",
        "end_time": "2025-08-20 12:55:00.818",
        "code": "InternalError",
        "message": "xxxxxx"
    }
}

    output object

    Informasi tentang output task.

    Properti

    task_id string

    ID task. Anda dapat menggunakan ID ini untuk mengkueri task hingga 24 jam.

    task_status string

    Status task.

    Enumerasi

    • PENDING

    • RUNNING

    • SUCCEEDED

    • FAILED

    • CANCELED

    • UNKNOWN: Task tidak ada atau statusnya tidak diketahui.

    submit_time string

    Waktu saat task diajukan. Waktu dalam UTC+8. Formatnya adalah `YYYY-MM-DD HH:mm:ss.SSS`.

    scheduled_time string

    Waktu saat task mulai berjalan. Waktu dalam UTC+8. Formatnya adalah `YYYY-MM-DD HH:mm:ss.SSS`.

    end_time string

    Waktu saat task selesai. Waktu dalam UTC+8. Formatnya adalah `YYYY-MM-DD HH:mm:ss.SSS`.

    image_url string

    URL gambar yang dihasilkan oleh model. Gambar memiliki dimensi yang sama dengan gambar sumber dan dalam format JPG. URL berlaku selama 24 jam. Unduh dan simpan gambar segera.

    code string

    Kode kesalahan. Parameter ini hanya dikembalikan ketika permintaan gagal. Untuk informasi lebih lanjut, lihat Pesan kesalahan.

    message string

    Informasi detail tentang kegagalan permintaan. Untuk informasi lebih lanjut, lihat Pesan kesalahan.

    Parameter ini biasanya tidak dikembalikan untuk permintaan sukses. Hanya dikembalikan ketika gambar tidak mengandung teks yang dapat diterjemahkan, misalnya ketika tidak ada teks tersisa setelah segmentasi subjek. Dalam kasus ini, task tetap dianggap sukses dan ditagih secara normal, tetapi pesan No text detected for translation dikembalikan.

    usage object

    Statistik penggunaan. Statistik ini hanya dihitung untuk task yang sukses.

    Properti

    image_count integer

    Jumlah gambar yang dihasilkan oleh model. Nilainya tetap 1.

    request_id string

    ID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan troubleshooting masalah.

    Bahasa yang didukung

    Saat menerjemahkan gambar, salah satu dari bahasa sumber atau target harus berupa Chinese atau English. Terjemahan langsung antara dua bahasa non-Chinese atau non-English, seperti dari Japanese ke Korean, tidak didukung. Jika Anda tidak yakin dengan bahasa sumber, Anda dapat menyetel source_lang ke auto untuk deteksi otomatis.

    Bahasa

    Kode

    Sebagai bahasa sumber

    Sebagai bahasa target

    Chinese

    zh

    Didukung

    Didukung

    English

    en

    Didukung

    Didukung

    Korean

    ko

    Didukung

    Didukung

    Japanese

    ja

    Didukung

    Didukung

    Russian

    ru

    Didukung

    Didukung

    Spanish

    es

    Didukung

    Didukung

    French

    fr

    Didukung

    Didukung

    Portuguese

    pt

    Didukung

    Didukung

    Italian

    it

    Didukung

    Didukung

    German

    de

    Didukung

    Tidak didukung

    Vietnamese

    vi

    Didukung

    Didukung

    Malay

    ms

    Tidak didukung

    Didukung

    Thai

    th

    Tidak didukung

    Didukung

    Indonesian

    id

    Tidak didukung

    Didukung

    Arabic

    ar

    Tidak didukung

    Didukung

    Penagihan dan batas laju

    • Untuk kuota gratis dan harga, lihat Harga model.

    • Untuk batas laju, lihat Batas laju.

    • Penagihan: Anda ditagih berdasarkan jumlah gambar yang berhasil dihasilkan. Panggilan model yang gagal atau kesalahan pemrosesan tidak dikenai biaya.

    • Catatan: Jika gambar tidak mengandung teks yang dapat diterjemahkan, atau jika tidak ada teks tersisa di area non-subjek setelah identifikasi subjek diaktifkan, task tetap dianggap sukses dan ditagih secara normal. Dalam kasus ini, API mengembalikan pesan No text detected for translation.

    Konfigurasikan izin akses gambar

    Gambar disimpan di Object Storage Service (OSS). Tautan tersebut menyediakan akses publik tetapi hanya berlaku selama 24 jam. Jika sistem bisnis Anda tidak dapat mengakses tautan OSS karena kebijakan keamanan, Anda dapat menambahkan nama domain OSS berikut ke daftar putih akses jaringan Anda.

    dashscope-result-bj.oss-cn-beijing.aliyuncs.com
dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com
dashscope-result-sh.oss-cn-shanghai.aliyuncs.com
dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com
dashscope-result-zjk.oss-cn-zhangjiakou.aliyuncs.com
dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com
dashscope-result-hy.oss-cn-heyuan.aliyuncs.com
dashscope-result-cd.oss-cn-chengdu.aliyuncs.com
dashscope-result-gz.oss-cn-guangzhou.aliyuncs.com
dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com

    Kode kesalahan

    Jika panggilan gagal, lihat Pesan kesalahan untuk troubleshooting.

    FAQ

    Q: Mengapa konten dalam gambar tidak diterjemahkan?

    A: Fitur segmentasi entitas mencegah model menerjemahkan teks pada entitas dalam gambar, seperti orang, produk, atau logo. Untuk menerjemahkan semua teks, setel parameter ext.config.imgSegment ke false.

    Q: Bagaimana cara mengonversi tautan gambar sementara menjadi permanen?

    A: Anda tidak dapat langsung mengonversi tautan sementara menjadi permanen. Sebagai gantinya, unduh gambar melalui layanan backend lalu unggah ke OSS untuk menghasilkan tautan permanen baru.

    Kode contoh: Unduh gambar ke mesin lokal Anda

    import requests

def download_and_save_image(image_url, save_path):
    try:
        response = requests.get(image_url, stream=True, timeout=300) # Setel timeout.
        response.raise_for_status() # Bangkitkan exception jika kode status HTTP bukan 200.
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"Gambar berhasil diunduh ke: {save_path}")
        # Anda dapat menambahkan logika untuk mengunggah ke penyimpanan permanen di sini.
    except requests.exceptions.RequestException as e:
        print(f"Pengunduhan gambar gagal: {e}")

if __name__ == '__main__':
    image_url = "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx?Expires=xxx"
    save_path = "image-translation.jpg"
    download_and_save_image(image_url, save_path)

    Q: Bagaimana cara melihat penggunaan model saya?

    A: Satu jam setelah panggilan model selesai, Anda dapat membuka halaman Model Observation untuk melihat metrik seperti jumlah panggilan dan tingkat keberhasilan. Bagaimana cara melihat catatan panggilan model?