Model penyematan mengonversi data seperti teks, gambar, dan video menjadi vektor untuk berbagai tugas lanjutan, termasuk pencarian semantik, rekomendasi, pengelompokan, klasifikasi, dan deteksi anomali.
Prasyarat
Dapatkan Kunci API dan ekspor Kunci API sebagai Variabel lingkungan. Jika Anda menggunakan SDK OpenAI atau SDK DashScope untuk melakukan panggilan, instal SDK tersebut.
Dapatkan penyematan
- Penyematan teks
- Vektor multimodal independen
- Vektor multimodal terpadu
- API kompatibel OpenAI
- DashScope
Pemilihan model
Pilih model yang sesuai berdasarkan jenis data masukan dan kasus penggunaan Anda.
-
Memproses teks biasa atau kode: Gunakan
qwen3.7-text-embedding. Ini adalah model dengan performa tertinggi, mendukung fitur-fitur canggih seperti instruksi tugas dan vektor jarang untuk mencakup sebagian besar kasus penggunaan pemrosesan teks. -
Memproses konten multimodal:
- Penyematan terpadu: Untuk merepresentasikan input single-modal atau mixed-modal sebagai penyematan terpadu dalam kasus penggunaan seperti pengambilan lintas-modal dan pencarian gambar, gunakan
qwen3-vl-embedding. Misalnya, Anda dapat memasukkan gambar kaus dengan teks "temukan gaya serupa yang terlihat lebih muda", dan model akan menggabungkan gambar dan instruksi tugas ke dalam satu penyematan untuk diproses. - Penyematan independen: Untuk menghasilkan penyematan independen untuk setiap bagian input (seperti gambar dan keterangan teks yang sesuai), gunakan
tongyi-embedding-vision-plus,tongyi-embedding-vision-flash, atau model multimodal tujuan umummultimodal-embedding-v1.
- Penyematan terpadu: Untuk merepresentasikan input single-modal atau mixed-modal sebagai penyematan terpadu dalam kasus penggunaan seperti pengambilan lintas-modal dan pencarian gambar, gunakan
-
Memproses data skala besar: Untuk memproses data teks skala besar yang tidak real-time, gunakan
qwen3.7-text-embeddingatautext-embedding-v4dengan API batch kompatibel OpenAI untuk mengurangi biaya secara signifikan.
Penyematan teks
- Beijing
- Hong Kong
- Singapura
| Nama model | Dimensi penyematan | Ukuran batch | Token batch maksimum (Catatan) | Harga / 1 juta token | Bahasa |
|---|---|---|---|---|---|
text-embedding-v4Bagian dari seri Qwen3-Embedding | 2.048, 1.536, 1.024 (default), 768, 512, 256, 128, 64 | 10 | 8.192 | $0,072 | Lebih dari 100 bahasa utama, termasuk Tiongkok, Inggris, Spanyol, Prancis, Portugis, Indonesia, Jepang, Korea, Jerman, Rusia, dan beberapa bahasa pemrograman |
- input array string: Array dapat berisi hingga 10 elemen.
- input file: File teks dapat berisi hingga 10 baris.
Penyematan multimodal
Model ini menghasilkan penyematan dari input teks, gambar, atau video. Anda dapat menggunakan penyematan ini untuk tugas-tugas seperti klasifikasi video dan gambar, pengambilan gambar-teks, serta pencarian teks-ke-gambar atau teks-ke-video.
API menerima input teks tunggal, gambar, atau video, serta kombinasi seperti teks dan gambar. Beberapa model mendukung beberapa input dari jenis yang sama, seperti beberapa gambar. Untuk detailnya, lihat batasan untuk setiap model.
- Singapura
- Tiongkok (Beijing)
Model | Dimensi penyematan | Batas panjang teks | Batas ukuran gambar | Batas ukuran video | Harga (per 1 juta token) | Kuota gratis(Catatan) |
|---|---|---|---|---|---|---|
tongyi-embedding-vision-plus | 1.152 | 1.024 token | Hingga 3 MB per gambar. Mendukung hingga 8 gambar. | Hingga 10 MB per file video | Gambar/Video: $0,09 Teks: $0,09 | 1 juta token Kuota gratis ini berlaku selama 90 hari sejak tanggal aktivasi Studio Model, rilis model, atau persetujuan aplikasi, mana pun yang paling akhir. |
tongyi-embedding-vision-flash | 768 | Gambar/Video: $0,03 Teks: $0,09 |
Batasan input dan bahasa
| Model multimodal terpadu | ||||
|---|---|---|---|---|
| Model | Teks | Gambar | Video | Batas permintaan |
| qwen3-vl-embedding | Mendukung 33 bahasa utama, termasuk Tionghoa, Inggris, Jepang, Korea, Prancis, dan Jerman.
Semua bahasa yang didukung Tiongkok, Jepang, Korea, Indonesia, Vietnam, Thailand, Inggris, Prancis, Jerman, Rusia, Portugis, Spanyol, Italia, Swedia, Denmark, Ceko, Norwegia, Belanda, Finlandia, Turki, Polandia, Swahili, Rumania, Serbia, Yunani, Kazakh, Uzbek, Cebuano, Arab, Urdu, Persia, Hindi/Devanagari, dan Ibrani. | JPEG, PNG, WEBP, BMP, TIFF, ICO, DIB, ICNS, dan SGI (URL atau Base64 didukung) | MP4, AVI, dan MOV (hanya URL) | Jumlah total elemen konten dalam satu permintaan tidak boleh melebihi 20. Jumlah gambar tidak boleh melebihi 5. Gambar, teks, dan video berbagi batas ini. |
| Model multimodal independen | ||||
| Model | Teks | Gambar | Video | Batas permintaan |
| tongyi-embedding-vision-plus | Tiongkok/Inggris | JPG, PNG, dan BMP (URL atau Base64 didukung) | MP4, MPEG, AVI, MOV, MPG, WEBM, FLV, dan MKV (hanya URL) | Tidak ada batasan jumlah elemen konten. Jumlah total token input tidak boleh melebihi batas token. |
| tongyi-embedding-vision-flash | ||||
| multimodal-embedding-v1 | Jumlah total elemen konten dalam satu permintaan tidak boleh melebihi 20. Satu permintaan dapat berisi maksimal 1 gambar, 1 video, dan 20 entri teks. Item-item ini berbagi batas total. | |||
Fitur inti
Menyesuaikan dimensi vektor
Model qwen3.7-text-embedding, text-embedding-v4, text-embedding-v3, tongyi-embedding-vision-plus, tongyi-embedding-vision-flash, qwen3-vl-embedding mendukung dimensi vektor kustom. Dimensi yang lebih tinggi mempertahankan lebih banyak informasi semantik tetapi meningkatkan biaya penyimpanan dan komputasi.
- Kasus penggunaan umum (Direkomendasikan): Dimensi 1.024 memberikan keseimbangan optimal antara performa dan biaya, sehingga ideal untuk sebagian besar tugas pencarian semantik.
- Skenario presisi tinggi: Untuk aplikasi yang memerlukan presisi tinggi, Anda dapat memilih dimensi 1.536 atau 2.048. Hal ini meningkatkan presisi tetapi secara signifikan meningkatkan overhead penyimpanan dan komputasi.
- Lingkungan dengan sumber daya terbatas: Dalam skenario yang sensitif terhadap biaya, pilih dimensi 768 atau lebih rendah. Hal ini secara signifikan mengurangi konsumsi sumber daya dengan mengorbankan sebagian informasi semantik.
Teks kueri vs. dokumen (text_type)
Parameter ini hanya tersedia melalui SDK dan API DashScope.Untuk mencapai hasil optimal dalam tugas pencarian, Anda harus melakukan vektorisasi konten secara berbeda berdasarkan perannya. Parameter
text_type dirancang untuk tujuan ini:
text_type: 'query': Gunakan untuk teks kueri yang diberikan pengguna. Model menghasilkan vektor "seperti judul" yang lebih terarah dan dioptimalkan untuk pengambilan informasi.text_type: 'document'(default): Gunakan untuk teks dokumen yang disimpan dalam basis pengetahuan Anda. Model menghasilkan vektor "seperti isi" yang berisi informasi lebih komprehensif dan dioptimalkan untuk pencocokan.
query dan document. Namun, untuk tugas seperti pengelompokan atau klasifikasi di mana semua teks memiliki peran yang sama, Anda tidak perlu mengatur parameter ini.
Instruksi tugas (instruct)
Parameter ini hanya tersedia melalui SDK dan API DashScope.Anda dapat memberikan instruksi tugas berbahasa Inggris yang jelas untuk membimbing model
qwen3.7-text-embedding dan text-embedding-v4 dalam mengoptimalkan kualitas vektor untuk skenario pengambilan tertentu, sehingga meningkatkan presisi. qwen3.7-text-embedding meningkatkan kemampuan mengikuti instruksi sebesar 16,4% dibandingkan text-embedding-v4, sehingga kami merekomendasikan Anda menggunakannya terlebih dahulu. Saat menggunakan fitur ini, Anda harus mengatur parameter text_type ke query.
Vektor padat dan jarang
Parameter ini hanya tersedia melalui SDK dan API DashScope.Model
qwen3.7-text-embedding, text-embedding-v4, dan text-embedding-v3 mendukung tiga jenis output vektor untuk mengakomodasi strategi pengambilan yang berbeda. Penyematan jarang dari qwen3.7-text-embedding menggunakan strategi pelatihan baru mirip SPLADE yang meningkatkan efektivitas sebesar 8,4% dan menambahkan dukungan untuk pengambilan lintas-bahasa.
Jenis vektor (output_type) | Keunggulan | Keterbatasan | Kasus penggunaan |
|---|---|---|---|
dense | Pemahaman semantik mendalam yang mengidentifikasi sinonim dan konteks untuk hasil yang lebih relevan. | Biaya komputasi dan penyimpanan lebih tinggi. Tidak menjamin kecocokan eksak untuk kata kunci. | Pencarian semantik, Tanya Jawab berbasis AI, rekomendasi konten. |
sparse | Efisiensi komputasi tinggi, berfokus pada kecocokan eksak untuk kata kunci dan memungkinkan penyaringan cepat. | Kurang pemahaman semantik dan tidak dapat memproses sinonim atau konteks. | Pengambilan log, pencarian SKU produk, penyaringan informasi presisi. |
dense&sparse | Menggabungkan pencocokan semantik dan kata kunci untuk hasil pencarian optimal. Biaya pembuatan tidak berubah, dan overhead panggilan API identik dengan mode vektor tunggal. | Memerlukan lebih banyak penyimpanan, dan arsitektur sistem serta logika pengambilan lebih kompleks. | Mesin pencari hibrida berkualitas tinggi untuk produksi. |
Kasus penggunaan
Kode berikut hanya untuk tujuan demonstrasi. Untuk produksi, pra-hitung dan simpan penyematan dalam database vektor. Dengan cara ini, Anda hanya perlu menghasilkan penyematan kueri untuk pengambilan.
Pencarian semantik
Lakukan pencocokan semantik yang tepat dengan menghitung kesamaan antara penyematan kueri dan penyematan dokumen.
Sistem rekomendasi
Analisis penyematan riwayat perilaku pengguna untuk mengidentifikasi minat mereka dan merekomendasikan item serupa.
Pengelompokan teks
Kelompokkan teks serupa dengan menganalisis jarak antara penyematan mereka.
Klasifikasi teks
Lakukan klasifikasi teks zero-shot dengan menghitung kesamaan antara penyematan teks input dan penyematan label yang telah ditentukan. Proses ini mengklasifikasikan teks ke dalam kategori baru tanpa memerlukan contoh berlabel sebelumnya.
Deteksi anomali
Identifikasi data anomali dengan menghitung kesamaan antara penyematan teks dan penyematan pusat sampel normal. Data yang secara signifikan menyimpang dari pola ini dianggap sebagai anomali.
threshold dalam contoh ini hanya untuk tujuan demonstrasi. Nilai ideal bervariasi berdasarkan konten dan distribusi data, sehingga Anda harus mengkalibrasinya menggunakan dataset Anda sendiri.
Referensi API
- Penyematan teks umum
- Penyematan multimodal API penyematan multimodal
Kode kesalahan
Jika panggilan model gagal dan mengembalikan pesan kesalahan, lihat Kode kesalahan untuk resolusi.
Pembatasan laju
Untuk kondisi pembatasan laju model, lihat Pembatasan laju.
Performa model (MTEB/CMTEB)
Tolok ukur evaluasi
- MTEB (Massive Text Embedding Benchmark): Tolok ukur komprehensif yang menilai performa umum penyematan teks pada tugas-tugas seperti klasifikasi, pengelompokan, dan pengambilan.
- CMTEB (Chinese Massive Text Embedding Benchmark): Tolok ukur skala besar yang khusus untuk mengevaluasi penyematan teks Tiongkok.
- Skor berkisar dari 0 hingga 100. Skor yang lebih tinggi menunjukkan performa yang lebih baik.
Model | MTEB | MTEB (tugas pengambilan) | CMTEB | CMTEB (tugas pengambilan) |
|---|---|---|---|---|
text-embedding-v3 (512 dimensi) | 62,11 | 54,30 | 66,81 | 71,88 |
text-embedding-v3 (768 dimensi) | 62,43 | 54,74 | 67,90 | 72,29 |
text-embedding-v3 (1.024 dimensi) | 63,39 | 55,41 | 68,92 | 73,23 |
text-embedding-v4 (512 dimensi) | 64,73 | 56,34 | 68,79 | 73,33 |
text-embedding-v4 (1.024 dimensi) | 68,36 | 59,30 | 70,14 | 73,98 |
text-embedding-v4 (2.048 dimensi) | 71,58 | 61,97 | 71,99 | 75,01 |