全部产品
Search

搜索本产品

    Alibaba Cloud Model Studio：Qwen - referensi API terjemahan citra

    文档中心

    Alibaba Cloud Model Studio：Qwen - referensi API terjemahan citra

    更新时间：Nov 28, 2025

    Qwen-MT-Image menerjemahkan teks dalam citra secara akurat dan mempertahankan tata letak aslinya. Model ini juga mendukung fitur khusus seperti petunjuk bidang subjek, penyaringan kata sensitif, dan intervensi terminologi.

    Penting

    Dokumen ini hanya berlaku untuk wilayah China (Beijing). Anda harus menggunakan API key dari wilayah ini.

    Ikhtisar model

    Contoh

    en

    Bahasa sumber: Inggris

    ja

    Jepang

    es

    Portugis

    ar

    Arab

    Model dan harga

    Fitur terjemahan citra mendukung terjemahan antara bahasa Mandarin atau Inggris dengan bahasa lain, tetapi tidak mendukung terjemahan langsung antar bahasa non-Mandarin/Inggris, misalnya dari Jepang ke Korea. Untuk informasi lebih lanjut, lihat Bahasa yang didukung.

    Model

    Harga satuan

    Batas laju (dibagi bersama oleh Akun Alibaba Cloud dan Pengguna RAM)

    Batas RPS API pengiriman task

    Jumlah tugas konkuren

    qwen-mt-image

    $0,000431/citra

    1

    2

    Aturan penagihan

    • Metode penagihan: Anda ditagih berdasarkan jumlah citra yang berhasil dihasilkan. Anda dikenai biaya setelah task berhasil (nilai task_status adalah SUCCEEDED) dan citra telah dihasilkan.

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

    HTTP

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

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

    Karena terjemahan citra memerlukan waktu, API HTTP menggunakan mode asinkron. Proses pemanggilan melibatkan dua langkah:

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

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

    Langkah 1: Buat task dan dapatkan ID task

    Catatan

    Setelah task dibuat, gunakan task_id yang dikembalikan untuk mengkueri hasil dengan polling. task_id berlaku selama 24 jam. Jangan membuat task berulang kali.

    Parameter permintaan

    Terjemahan citra

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

    Header permintaan

    Content-Type string (Wajib)

    Tipe konten permintaan. Setel parameter ini ke application/json.

    Authorization string (Wajib)

    Kredensial otentikasi identitas untuk permintaan. API ini menggunakan Kunci API Model Studio untuk otentikasi identitas. Contoh: Bearer sk-xxxx.

    X-DashScope-Async string (Wajib)

    Parameter konfigurasi pemrosesan asinkron. Permintaan HTTP hanya mendukung pemrosesan asinkron. Anda harus menyetel parameter ini ke enable.

    Penting

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

    Badan permintaan

    model string (Wajib)

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

    input object (Wajib)

    Objek parameter input. Berisi bidang-bidang berikut:

    Properti

    image_url string (Wajib)

    URL citra yang dapat diakses publik. Protokol HTTP dan HTTPS didukung.

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

    • Batas dimensi: Lebar dan tinggi citra harus antara 15 hingga 8.192 piksel. Rasio aspek harus antara 1:10 hingga 10:1.

    • Batas ukuran: Tidak lebih dari 10 MB

    • Jika URL berisi karakter non-ASCII, seperti karakter Mandarin, Anda harus melakukan URL-encode terhadap URL tersebut sebelum meneruskannya dalam permintaan.

      URL encoding

      from urllib.parse import quote

# Ganti URL berikut dengan URL yang perlu Anda encode
url = "https://example.com/search?q=test&page=1"
encoded_url = quote(url, safe=':/?#[]@!$&\'()*+,;=%')
print(f"Original URL: {url}")
print(f"Encoded URL: {encoded_url}")

    • 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 bahasa Mandarin atau Inggris.

    • 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 bahasa Mandarin atau Inggris.

    • Contoh: Chinese atau en

    ext object (Opsional)

    Bidang ekstensi opsional.

    Properti

    domainHint string (Opsional)

    Petunjuk bidang subjek. Untuk membuat gaya terjemahan lebih sesuai dengan bidang tertentu, gunakan bahasa Inggris untuk menggambarkan skenario, gaya terjemahan, dan persyaratan lainnya.

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

    Penting

    Petunjuk bidang subjek saat ini hanya mendukung bahasa Inggris.

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

    sensitives array (Opsional)

    Mengonfigurasi kata sensitif yang akan disaring dari teks citra sebelum diterjemahkan. Penyaringan dilakukan berdasarkan kecocokan eksak dan peka huruf besar/kecil.

    Bahasa kata sensitif dapat 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)

    Intervensi terminologi. Menetapkan terjemahan untuk istilah tertentu guna memenuhi kebutuhan terjemahan pada bidang 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 Program Interface", "tgt": "API"}, {"src": "Machine Learning", "tgt": "ML"}]

    config object (Opsional)

    Properti

    skipImgSegment bool (Opsional)

    Mengontrol apakah akan melewati deteksi subjek dan menerjemahkan teks pada subjek dalam citra, seperti orang, produk, atau logo.

    • false: (Default) Melakukan deteksi subjek dan tidak menerjemahkan teks pada subjek.

    • true: Tidak melakukan deteksi subjek dan menerjemahkan semua teks, termasuk teks pada subjek.

    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 mengatasi masalah.

    {
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-xxxxxx"
}

    output object

    Informasi output task.

    Properti

    task_id string

    ID task. Kueri berlaku selama 24 jam.

    task_status string

    Status task.

    Enumerasi

    • PENDING

    • RUNNING

    • SUCCEEDED

    • FAILED

    • CANCELED

    • UNKNOWN: Task tidak ada atau statusnya tidak dapat ditentukan.

    request_id string

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

    message string

    Informasi detail tentang permintaan yang gagal. Parameter ini tidak dikembalikan jika permintaan berhasil. Untuk informasi lebih lanjut, lihat Pesan kesalahan.

    code string

    Kode kesalahan untuk permintaan yang gagal. Parameter ini tidak dikembalikan jika permintaan berhasil. Untuk informasi lebih lanjut, lihat Pesan kesalahan.

    Langkah 2: Kueri hasil menggunakan ID task

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

    Catatan

    • Model memerlukan waktu sekitar 15 detik untuk memproses permintaan. Gunakan mekanisme polling dengan interval kueri yang wajar, misalnya 5 detik, untuk mengambil hasil.

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

    • url yang dikembalikan untuk task yang berhasil berlaku selama 24 jam. Unduh dan simpan citra 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 identitas untuk permintaan. API ini menggunakan Kunci API Model Studio untuk otentikasi identitas. Contoh: Bearer sk-xxxx.

    Parameter path URL

    task_id string (Wajib)

    ID task.

    Parameter respons

    Task berhasil

    Data task, seperti status task dan URL citra, hanya disimpan selama 24 jam dan secara otomatis dihapus setelah periode tersebut. Anda harus segera menyimpan citra 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 gagal

    Jika task gagal, task_status diatur ke FAILED, dan kode kesalahan serta pesan disediakan. Untuk informasi lebih lanjut, lihat Pesan kesalahan untuk mengatasi 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 output task.

    Properti

    task_id string

    ID task. Kueri berlaku selama 24 jam.

    task_status string

    Status task.

    Enumerasi

    • PENDING

    • RUNNING

    • SUCCEEDED

    • FAILED

    • CANCELED

    • UNKNOWN: Task tidak ada atau statusnya tidak dapat ditentukan.

    submit_time string

    Waktu saat task dikirim. Waktu dalam zona waktu UTC+8. Formatnya adalah YYYY-MM-DD HH:mm:ss.SSS.

    scheduled_time string

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

    end_time string

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

    image_url string

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

    code string

    Kode kesalahan untuk permintaan yang gagal. Parameter ini tidak dikembalikan jika permintaan berhasil. 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 yang berhasil. Hanya dikembalikan ketika citra tidak mengandung teks yang dapat diterjemahkan, misalnya ketika tidak ada teks yang tersisa setelah identifikasi subjek. Dalam kasus ini, permintaan tetap dianggap berhasil dan ditagih secara normal, tetapi pesan No text detected for translation dikembalikan.

    usage object

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

    Properti

    image_count integer

    Jumlah citra 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 citra, minimal salah satu dari bahasa sumber atau target harus berupa bahasa Mandarin atau Inggris. Terjemahan langsung antara dua bahasa non-Mandarin/non-Inggris, seperti dari Jepang ke Korea, 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

    Germany

    de

    Didukung

    Tidak didukung

    Vietnamese

    vi

    Didukung

    Didukung

    Malay

    ms

    Tidak didukung

    Didukung

    Thai

    th

    Tidak didukung

    Didukung

    Indonesian

    id

    Tidak didukung

    Didukung

    Arabian

    ar

    Tidak didukung

    Didukung

    Konfigurasi izin akses

    Citra disimpan di Object Storage Service (OSS). Tautan tersebut memungkinkan akses publik dan 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 pemanggilan gagal, lihat Pesan kesalahan untuk troubleshooting.

    FAQ

    T: Bagaimana cara mengonversi tautan citra sementara menjadi permanen?

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

    Contoh kode: Unduh citra ke mesin lokal

    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"Citra 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 citra 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)

    T: Bagaimana cara melihat penggunaan model saya?

    J: Satu jam setelah pemanggilan model selesai, Anda dapat melihat metrik seperti jumlah pemanggilan dan tingkat keberhasilan di halaman Observasi Model. Untuk informasi lebih lanjut, lihat Bagaimana cara melihat catatan pemanggilan model?